Skip to main content
POST
/
agent
/
negotiation
Assess Task Capability
curl --request POST \
  --url http://localhost:3773/agent/negotiation \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_summary": "Extract tables and text from PDF invoices and text",
  "task_details": "Need to process multiple invoice PDFs and extract structured data including line items, totals, and vendor information",
  "input_mime_types": [
    "application/pdf"
  ],
  "output_mime_types": [
    "application/json"
  ],
  "max_latency_ms": 5000,
  "max_cost_amount": "0.001",
  "required_tools": [],
  "forbidden_tools": [],
  "min_score": 0.7,
  "weights": {
    "skill_match": 0.6,
    "io_compatibility": 0.2,
    "performance": 0.1,
    "load": 0.05,
    "cost": 0.05
  }
}
'
{
  "accepted": false,
  "score": 0.3686,
  "confidence": 0.9,
  "rejection_reason": "score_below_threshold",
  "skill_matches": [
    {
      "skill_id": "pdf-processing-v1",
      "skill_name": "pdf-processing",
      "score": 0.1143,
      "reasons": [
        "tags: pdf, tables",
        "capabilities: text_extraction"
      ]
    }
  ],
  "matched_tags": [
    "tables",
    "pdf"
  ],
  "matched_capabilities": [
    "text_extraction"
  ],
  "latency_estimate_ms": 2000,
  "queue_depth": 0,
  "subscores": {
    "skill_match": 0.1143,
    "io_compatibility": 1,
    "load": 1,
    "cost": 1
  }
}

Body

application/json
task_summary
string
required

Brief summary of the task

Maximum string length: 10000
task_details
string

Detailed task description

input_mime_types
string[]

Accepted input MIME types

output_mime_types
string[]

Accepted output MIME types

max_latency_ms
integer

Maximum acceptable latency in milliseconds

max_cost_amount
string

Maximum acceptable cost as a string

required_tools
string[]

Tools that must be available

forbidden_tools
string[]

Tools that must not be used

min_score
number

Minimum acceptance score threshold

Required range: 0 <= x <= 1
weights
object

Scoring weights for different factors

Response

Capability assessment result

accepted
boolean
required

Whether the agent accepts the task

score
number
required

Overall weighted score

Required range: 0 <= x <= 1
confidence
number
required

Confidence in the assessment

Required range: 0 <= x <= 1
rejection_reason
string

Reason for rejection if not accepted

skill_matches
object[]

Matched skills with scores

matched_tags
string[]

Tags that matched the task

matched_capabilities
string[]

Capabilities that matched the task

latency_estimate_ms
integer

Estimated latency in milliseconds

queue_depth
integer

Current queue depth

subscores
object

Individual scoring factors