NegotiatorOfferingStrategy

class negmas.sao.NegotiatorOfferingStrategy(*, negotiator=None, proposer)[source]

Bases: negmas.sao.components.base.OfferingStrategy

Uses a negotiator as an offering strategy

Attributes Summary

`negotiator`
`proposer`

Methods Summary

`__call__`(state)	Call self as a function.
`after_join`(nmi)	A call back called after joining a negotiation to confirm wwe joined.
`after_proposing`(state, offer)	Called after proposing
`after_responding`(state, offer, response)	Called before offering
`before_proposing`(state)	Called before proposing
`before_responding`(state, offer)	Called before offering
`can_join`(nmi, state, *[, preferences, ufun, ...])	A call back called before joining a negotiation to confirm that we can join it.
`on_leave`(state)	A call back called after leaving a negotiation.
`on_mechanism_error`(state)	A call back called whenever an error happens in the mechanism.
`on_negotiation_end`(state)	A call back called at each negotiation end
`on_negotiation_start`(state)	A call back called at each negotiation start
`on_partner_ended`(partner)	Called when a partner ends the negotiation.
`on_partner_joined`(partner)	Called when a partner joins the negotiation.
`on_partner_left`(partner)	Called when a partner leaves the negotiation.
`on_partner_proposal`(state, partner_id, offer)	A callback called by the mechanism when a partner proposes something
`on_partner_refused_to_propose`(state, partner_id)	A callback called by the mechanism when a partner refuses to propose
`on_partner_response`(state, partner_id, ...)	A callback called by the mechanism when a partner responds to some offer
`on_preferences_changed`(changes)	Called to inform the component that the ufun has changed and the kinds of change that happened.
`on_round_end`(state)	A call back called at each negotiation round end
`on_round_start`(state)	A call back called at each negotiation round start
`propose`(state)	Propose an offer or None to refuse.
`set_negotiator`(negotiator)	Sets the negotiator of which this component is a part.

Attributes Documentation

negotiator

proposer: SAONegotiator

Methods Documentation

__call__(state)[source]

Call self as a function.

Return type: Outcome | None

after_join(nmi)

A call back called after joining a negotiation to confirm wwe joined.

Return type: None

after_proposing(state, offer): Called after proposing

after_responding(state, offer, response): Called before offering

before_proposing(state): Called before proposing

before_responding(state, offer): Called before offering

can_join(nmi, state, *, preferences=None, ufun=None, role='negotiator')

A call back called before joining a negotiation to confirm that we can join it.

Return type: bool

on_leave(state)

A call back called after leaving a negotiation.

Return type: None

on_mechanism_error(state)

A call back called whenever an error happens in the mechanism. The error and its explanation are accessible in state

Return type: None

on_negotiation_end(state)

A call back called at each negotiation end

Return type: None

on_negotiation_start(state)

A call back called at each negotiation start

Return type: None

on_partner_ended(partner)

Called when a partner ends the negotiation.

Note that the negotiator owning this component may never receive this offer. This is only receivd if the mechanism is sending notifications on every offer.

on_partner_joined(partner)

Called when a partner joins the negotiation.

This is only receivd if the mechanism is sending notifications.

on_partner_left(partner)

Called when a partner leaves the negotiation.

This is only receivd if the mechanism is sending notifications.

on_partner_proposal(state, partner_id, offer)

A callback called by the mechanism when a partner proposes something

Parameters

state (SAOState) – MechanismState giving the state of the negotiation when the offer was porposed.
partner_id (str) – The ID of the agent who proposed
offer (tuple) – The proposal.

Remarks:

Will only be called if enable_callbacks is set for the mechanism

Return type: None

on_partner_refused_to_propose(state, partner_id)

A callback called by the mechanism when a partner refuses to propose

Parameters

state (SAOState) – MechanismState giving the state of the negotiation when the partner refused to offer.
partner_id (str) – The ID of the agent who refused to propose

Remarks:

Will only be called if enable_callbacks is set for the mechanism

Return type: None

on_partner_response(state, partner_id, outcome, response)

A callback called by the mechanism when a partner responds to some offer

Parameters

state (SAOState) – MechanismState giving the state of the negotiation when the partner responded.
partner_id (str) – The ID of the agent who responded
outcome (Outcome | None) – The proposal being responded to.
response (ResponseType) – The response

Remarks:

Will only be called if enable_callbacks is set for the mechanism

Return type: None

on_preferences_changed(changes): Called to inform the component that the ufun has changed and the kinds of change that happened.

on_round_end(state)

A call back called at each negotiation round end

Return type: None

on_round_start(state)

A call back called at each negotiation round start

Return type: None

propose(state)

Propose an offer or None to refuse.

Parameters: state (SAOState) – SAOState giving current state of the negotiation.
Return type: Outcome | None
Returns: The outcome being proposed or None to refuse to propose

Remarks:

This function guarantees that no agents can propose something with a utility value

set_negotiator(negotiator)

Sets the negotiator of which this component is a part.

Return type: None