zeus.agents
Class ZeusAgent

java.lang.Object
  zeus.agents.BasicAgent
      zeus.agents.ZeusAgent

public class ZeusAgent

extends BasicAgent

This class implements the core functionality of all Zeus Task Agents. Every task agent implementation created by the Zeus toolkit includes a call to the ZeusAgent constructor, which creates and initialises all the agent's internal components and stores references to them in its AgentContext.

This class is of particular interest to developers because it provides methods that allow the agent state to be interrogated and changed, as well listing all the listener classes that can be added to monitor the agent's state.

Field Summary

Fields inherited from class zeus.agents.BasicAgent

context, CREATE, DEATH, RESUME, SUSPEND

Constructor Summary

ZeusAgent(java.lang.String name, java.lang.String ont_file, java.util.Vector nameservers, int plan_width, int plan_length)
v1.00 Constructor, provided for backwards compatibility

ZeusAgent(java.lang.String name, java.lang.String ontology_file, java.util.Vector nameservers, int planner_width, int planner_length, boolean hasTasks, boolean hasRules)
Version 1.01 constructor - the componentmask parameter will prevent the creation of unnecessary agent components

Method Summary

void	achieve(Goal g) Adds an achievement goal to the agent's co-ordination engine, this will alter the agent's behaviour as it attempts to satisfy the goal
void	achieve(Goal g, java.lang.String key) Instructs the agent to achieve a specified goal
void	addAbility(AbilityDbItem anAbilityItem)
void	addAbility(java.util.Vector AbilityItems)
void	addAbilityMonitor(AbilityMonitor monitor, long type)
void	addClockMonitor(ClockMonitor monitor, long type)
void	addFact(Fact aFact) Provides the agent with a new resource fact
void	addFact(java.util.Vector Facts)
void	addFactMonitor(FactMonitor monitor, long type)
void	addPlanningMonitor(PlanningMonitor monitor, long type)
void	addProtocol(ProtocolInfo aProtocol)
void	addProtocol(java.util.Vector Protocols)
void	addProtocolMonitor(ProtocolMonitor monitor, long type)
void	addRelation(java.lang.String agent, java.lang.String aRelation)
void	addRelation(java.util.Vector Relations)
void	addRelationMonitor(RelationMonitor monitor, long type)
void	addRulebase(ReteKB kb) Adds a new set of rules to the agent's rule base
void	addTask(AbstractTask aTask)
void	addTask(java.util.Vector Tasks)
void	addTaskMonitor(TaskMonitor monitor, long type)
void	buy(Goal g) Instructs the agent to acquire the fact referred to in the goal
void	removeAbilityMonitor(AbilityMonitor monitor, long type)
void	removeClockMonitor(ClockMonitor monitor, long type)
void	removeFactMonitor(FactMonitor monitor, long type)
void	removePlanningMonitor(PlanningMonitor monitor, long type)
void	removeProtocolMonitor(ProtocolMonitor monitor, long type)
void	removeRelationMonitor(RelationMonitor monitor, long type)
void	removeTaskMonitor(TaskMonitor monitor, long type)
void	sell(Goal g) Instructs the agent to sell the fact referred to in the goal

Methods inherited from class zeus.agents.BasicAgent

addAgentMonitor, addMessageMonitor, getAgentContext, notifyMonitors, removeAgentMonitor, removeMessageMonitor

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ZeusAgent

public ZeusAgent(java.lang.String name,
                 java.lang.String ontology_file,
                 java.util.Vector nameservers,
                 int planner_width,
                 int planner_length,
                 boolean hasTasks,
                 boolean hasRules)

Version 1.01 constructor - the componentmask parameter will prevent the creation of unnecessary agent components

ZeusAgent

public ZeusAgent(java.lang.String name,
                 java.lang.String ont_file,
                 java.util.Vector nameservers,
                 int plan_width,
                 int plan_length)

v1.00 Constructor, provided for backwards compatibility

Method Detail

addProtocol

public void addProtocol(java.util.Vector Protocols)

addProtocol

public void addProtocol(ProtocolInfo aProtocol)

addTask

public void addTask(java.util.Vector Tasks)

addTask

public void addTask(AbstractTask aTask)

addFact

public void addFact(java.util.Vector Facts)

addFact

public void addFact(Fact aFact)

Provides the agent with a new resource fact

addAbility

public void addAbility(java.util.Vector AbilityItems)

addAbility

public void addAbility(AbilityDbItem anAbilityItem)

addRelation

public void addRelation(java.util.Vector Relations)

addRelation

public void addRelation(java.lang.String agent,
                        java.lang.String aRelation)

achieve

public void achieve(Goal g)

Adds an achievement goal to the agent's co-ordination engine, this will alter the agent's behaviour as it attempts to satisfy the goal

achieve

public void achieve(Goal g,
                    java.lang.String key)

Instructs the agent to achieve a specified goal

buy

public void buy(Goal g)

Instructs the agent to acquire the fact referred to in the goal

sell

public void sell(Goal g)

Instructs the agent to sell the fact referred to in the goal

addRulebase

public void addRulebase(ReteKB kb)

Adds a new set of rules to the agent's rule base

addAbilityMonitor

public void addAbilityMonitor(AbilityMonitor monitor,
                              long type)

removeAbilityMonitor

public void removeAbilityMonitor(AbilityMonitor monitor,
                                 long type)

addRelationMonitor

public void addRelationMonitor(RelationMonitor monitor,
                               long type)

removeRelationMonitor

public void removeRelationMonitor(RelationMonitor monitor,
                                  long type)

addClockMonitor

public void addClockMonitor(ClockMonitor monitor,
                            long type)

removeClockMonitor

public void removeClockMonitor(ClockMonitor monitor,
                               long type)

addPlanningMonitor

public void addPlanningMonitor(PlanningMonitor monitor,
                               long type)

removePlanningMonitor

public void removePlanningMonitor(PlanningMonitor monitor,
                                  long type)

addFactMonitor

public void addFactMonitor(FactMonitor monitor,
                           long type)

removeFactMonitor

public void removeFactMonitor(FactMonitor monitor,
                              long type)

addTaskMonitor

public void addTaskMonitor(TaskMonitor monitor,
                           long type)

removeTaskMonitor

public void removeTaskMonitor(TaskMonitor monitor,
                              long type)

addProtocolMonitor

public void addProtocolMonitor(ProtocolMonitor monitor,
                               long type)

removeProtocolMonitor

public void removeProtocolMonitor(ProtocolMonitor monitor,
                                  long type)