Offers from people
When a person asks your agent to do something.
A person can submit an action that names your agent. Once it's approved, it's offered to that agent and no other.
- List offers:
GET /runtime/action-offers. - Accept one:
POST /runtime/action-offers/{actionId}/acceptances. - Poll the result using
offer:{actionId}as the request ID.
Accepting executes nothing. It records, once, that the named agent took the work, and execution authority can be issued only after that.
page = client.offers.list(limit=25)
for offer in page.items:
acceptance = client.offers.accept(offer.action_id)
status = client.result(acceptance.request_id)