genius.core.boaframework

Class BoaParty

java.lang.Object

genius.core.parties.AbstractNegotiationParty

genius.core.boaframework.BoaParty

All Implemented Interfaces:

NegotiationParty, java.io.Serializable

public final class BoaParty
extends AbstractNegotiationParty

This class is used to convert a BOA party to a real agent. The parseStrategyParameters loads the information object, the agentSetup uses the information object to load the agent using reflection. This class is special in that it is constructed directly by a BoaPartyRepItem . not for inclusion in a repository or extending. This is converted from BOAagent and TheBOAagent 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.parties.AbstractNegotiationParty

rand, timeline, userModel, utilitySpace

Constructor Summary

Constructors

Constructor and Description
BoaParty(AcceptanceStrategy ac, java.util.Map<java.lang.String,java.lang.Double> acParams, OfferingStrategy os, java.util.Map<java.lang.String,java.lang.Double> osParams, OpponentModel om, java.util.Map<java.lang.String,java.lang.Double> omParams, OMStrategy oms, java.util.Map<java.lang.String,java.lang.Double> omsParams) Stores all relevant values for initializing the components.

Method Summary

Modifier and Type	Method and Description
Action	chooseAction(java.util.List<java.lang.Class<? extends Action>> possibleActions) 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.
java.lang.String	getDescription()
OfferingStrategy	getOfferingStrategy() Returns the offering strategy of the agent.
OpponentModel	getOpponentModel() Returns the opponent model of the agent.
void	init(NegotiationInfo info) Initializes the agent and creates a new negotiation session object.
void	receiveMessage(AgentID sender, Action opponentAction) Stores the actions made by a partner.

Methods inherited from class genius.core.parties.AbstractNegotiationParty

generateRandomBid, getData, getDeadlines, getLastReceivedAction, getNumberOfParties, getPartyId, getProtocol, getRandomValue, getTimeLine, getUtility, getUtilitySpace, getUtilityWithDiscount, negotiationEnded, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, 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

omStrategy

protected OMStrategy omStrategy

Selects which bid to send when using an opponent model

negotiationSession

protected NegotiationSession negotiationSession

Links to the negotiation domain

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

BoaParty

public BoaParty(AcceptanceStrategy ac,
                java.util.Map<java.lang.String,java.lang.Double> acParams,
                OfferingStrategy os,
                java.util.Map<java.lang.String,java.lang.Double> osParams,
                OpponentModel om,
                java.util.Map<java.lang.String,java.lang.Double> omParams,
                OMStrategy oms,
                java.util.Map<java.lang.String,java.lang.Double> omsParams)

Stores all relevant values for initializing the components. Will be used when init is called.

Parameters:

ac -

acParams -

os -

osParams -

om -

omParams -

oms -

omsParams -

Method Detail

init

public void init(NegotiationInfo info)

Initializes the agent and creates a new negotiation session object.

Specified by:

init in interface NegotiationParty

Overrides:

init in class AbstractNegotiationParty

Parameters:

info - information about the negotiation that this party is part of.

receiveMessage

public void receiveMessage(AgentID sender,
                           Action opponentAction)

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

Specified by:

receiveMessage in interface NegotiationParty

Overrides:

receiveMessage in class AbstractNegotiationParty

Parameters:

opponentAction - by opponent in current turn

sender - The initiator of the action.This is either the AgentID, or null if the sender is not an agent (e.g., the protocol).

chooseAction

public Action chooseAction(java.util.List<java.lang.Class<? extends Action>> possibleActions)

Chooses an action to perform.

Parameters:

possibleActions - List of all actions possible.

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.

cleanUp

public void cleanUp()

Clears the agent's variables.

getDescription

public java.lang.String getDescription()

Returns:

a human-readable description for this party.