GEgetbindu
Negotiation

Ask whether this agent can handle a task

Changed on

Orchestrators use this to pick the best agent for a task before sending a real message/send. The agent returns a capability score (0–1) weighted across skill match, I/O compatibility, performance, load, and cost.

A score below the caller's min_score is interpreted as "decline" — the orchestrator should route the task elsewhere. This endpoint never actually performs the task; it's advisory.

post/agent/negotiation

Request

Request body

task_summarystring required

One-sentence description of the work.

task_detailsstring

Longer context, audience, constraints.

input_mime_typesstring[]
output_mime_typesstring[]
max_latency_msinteger

Client's latency tolerance.

max_cost_amountstring

Client's cost tolerance (currency-agnostic; agreed per-agent).

required_toolsstring[]
forbidden_toolsstring[]
min_scorenumber

Decline threshold. Scores below this are treated as "no".

Response

Negotiation response

can_handleboolean required
scorenumber required
reasonsstring[]

Short bullet rationale for the score.

estimated_latency_msinteger
estimated_cost_amountstring

Changes

  • 8a22dc180044Revision changes
    • breaking

      the request property became required

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • warning

      the / request property's max was set to 1.00

    • warning

      the / request property's max was set to 1.00

    • warning

      the / request property's max was set to 1.00

    • warning

      the / request property's max was set to 1.00

    • warning

      the / request property's max was set to 1.00

    • warning

      the / request property's min was set to 0.00

    • warning

      the / request property's min was set to 0.00

    • warning

      the / request property's min was set to 0.00

    • warning

      the / request property's min was set to 0.00

    • warning

      the / request property's min was set to 0.00

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      api operation id assessTaskCapability removed and replaced with

    • info

      removed the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

  • 970d68a5c55dRevision changes
    • breaking

      the request property type changed from number to string

    • breaking

      removed the required property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status