genius.core.boaframework

Class BOAagent

java.lang.Object

genius.core.AgentAdapter

genius.core.Agent

genius.core.boaframework.BOAagent

All Implemented Interfaces:

NegotiationParty, java.io.Serializable

public abstract class BOAagent
extends Agent

This class describes a basic decoupled agent. The TheBOAagent class extends this class and sets the required parameters. For more information, see: Baarslag T., Hindriks K.V., Hendrikx M., Dirkzwager A., Jonker C.M. Decoupling Negotiating Agents to Explore the Space of Negotiation Strategies. Proceedings of The Fifth International Workshop on Agent-based Complex Automated Negotiations (ACAN 2012), 2012. https://homepages.cwi.nl/~baarslag/pub/Decoupling_Negotiating_Agents_to_Explore_the_Space_of_Negotiation_Strategies_ACAN_2012.pdf

Author:

Tim Baarslag, Alex Dirkzwager, Mark Hendrikx

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected AcceptanceStrategy	acceptConditions Decides when to accept
protected NegotiationSession	negotiationSession Links to the negotiation domain
protected OfferingStrategy	offeringStrategy Decides what to offer
protected OMStrategy	omStrategy Selects which bid to send when using an opponent model
protected OpponentModel	opponentModel Approximates the utility of a bid for the opponent
protected OutcomeSpace	outcomeSpace Contains the space of possible bids
java.util.ArrayList<Pair<Bid,java.lang.String>>	savedOutcomes Store Multi_AcceptanceCondition outcomes

Fields inherited from class genius.core.Agent

fNegotiation, parametervalues, sessionNr, sessionsTotal, startTime, strategyParameters, timeline, totalTime, utilitySpace

Constructor Summary

Constructors

Constructor and Description
BOAagent()

Method Summary

Modifier and Type	Method and Description
abstract void	agentSetup() Method used to setup the agent.
Action	chooseAction() Chooses an action to perform.
void	cleanUp() Clears the agent's variables.
void	endSession(NegotiationResult result) Method that first calls the endSession method of each component to receiveMessage the session data and then stores the session data if it is not empty and is changed.
AcceptanceStrategy	getAcceptanceStrategy() Returns the acceptance strategy of the agent.
abstract java.lang.String	getName()
OfferingStrategy	getOfferingStrategy() Returns the offering strategy of the agent.
OpponentModel	getOpponentModel() Returns the opponent model of the agent.
protected java.lang.String	getUniqueIdentifier() Unique identifier for the BOA agent.
java.lang.String	getVersion()
void	init() Initializes the agent and creates a new negotiation session object.
void	ReceiveMessage(Action opponentAction) Stores the actions made by a partner.
void	setDecoupledComponents(AcceptanceStrategy ac, OfferingStrategy os, OpponentModel om, OMStrategy oms) Sets the components of the decoupled agent.

Methods inherited from class genius.core.Agent

equals, getAgent, getAgentID, getParameterValues, getSessionNumber, getSessionsTotal, getStrategyParameters, getSupportedNegotiationSetting, getUtility, hashCode, internalInit, loadSessionData, parseStrategyParameters, saveSessionData, setName, sleep

Methods inherited from class genius.core.AgentAdapter

chooseAction, getDescription, getProtocol, init, negotiationEnded, receiveMessage

Methods inherited from class java.lang.Object

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

Field Detail

acceptConditions

protected AcceptanceStrategy acceptConditions

Decides when to accept

offeringStrategy

protected OfferingStrategy offeringStrategy

Decides what to offer

opponentModel

protected OpponentModel opponentModel

Approximates the utility of a bid for the opponent

negotiationSession

protected NegotiationSession negotiationSession

Links to the negotiation domain

omStrategy

protected OMStrategy omStrategy

Selects which bid to send when using an opponent model

savedOutcomes

public java.util.ArrayList<Pair<Bid,java.lang.String>> savedOutcomes

Store Multi_AcceptanceCondition outcomes

outcomeSpace

protected OutcomeSpace outcomeSpace

Contains the space of possible bids

Constructor Detail

BOAagent

public BOAagent()

Method Detail

init

public void init()

Initializes the agent and creates a new negotiation session object.

Overrides:

init in class Agent

agentSetup

public abstract void agentSetup()

Method used to setup the agent. The method is called directly after initialization of the agent.

setDecoupledComponents

public void setDecoupledComponents(AcceptanceStrategy ac,
                                   OfferingStrategy os,
                                   OpponentModel om,
                                   OMStrategy oms)

Sets the components of the decoupled agent.

Parameters:

ac - the acceptance strategy

os - the offering strategy

om - the opponent model

oms - the opponent model strategy

getUniqueIdentifier

protected java.lang.String getUniqueIdentifier()

Unique identifier for the BOA agent. The default method in agent does not suffice as all BOA agents have the same classpath.

Overrides:

getUniqueIdentifier in class Agent

Returns:

unique identifier of the Agent object.

getVersion

public java.lang.String getVersion()

Overrides:

getVersion in class Agent

Returns:

version of the agent.

getName

public abstract java.lang.String getName()

Overrides:

getName in class Agent

Returns:

name of the agent.

ReceiveMessage

public void ReceiveMessage(Action opponentAction)

Stores the actions made by a partner. First, it stores the bid in the history, then updates the opponent model.

Overrides:

ReceiveMessage in class Agent

Parameters:

opponentAction - by opponent in current turn

chooseAction

public Action chooseAction()

Chooses an action to perform.

Specified by:

chooseAction in class Agent

Returns:

Action the agent performs

getOfferingStrategy

public OfferingStrategy getOfferingStrategy()

Returns the offering strategy of the agent.

Returns:

offeringstrategy of the agent.

getOpponentModel

public OpponentModel getOpponentModel()

Returns the opponent model of the agent.

Returns:

opponent model of the agent.

getAcceptanceStrategy

public AcceptanceStrategy getAcceptanceStrategy()

Returns the acceptance strategy of the agent.

Returns:

acceptance strategy of the agent.

endSession

public void endSession(NegotiationResult result)

Method that first calls the endSession method of each component to receiveMessage the session data and then stores the session data if it is not empty and is changed.

Overrides:

endSession in class Agent

Parameters:

result - discounted utility of previous session round.

cleanUp

public void cleanUp()

Clears the agent's variables.