Skip to main content

talonic_get_agent_task

Fetch the immutable input snapshot captured when one document reached an Agent stage. The payload also carries stage instructions, timeout policy, and the only output fields the agent may return.

ParameterTypeDescription
task_id *UUIDTask ID returned by `talonic_list_agent_tasks`.
Key response fields
{
  "id": "11111111-1111-4111-8111-111111111111",
  "status": "available",
  "input_snapshot": { "vendor_name": { "value": "Acme" } },
  "output_contract": [
    { "key": "risk_score", "dataType": "number", "required": true }
  ],
  "instructions": "Assess supplier risk from the supplied evidence.",
  "timeout_fallthrough": "route_to_review"
}
Fetching a task payload is an audited data disclosure. Do not fetch tasks speculatively; inspect metadata first and fetch only work you intend to evaluate.

Frequently asked questions

Can the snapshot change while an agent processes it?+
No. It is captured when the document enters the Agent stage and remains immutable for that task. Results are validated against the accompanying output_contract.

Related

talonic_list_agent_tasks
talonic_claim_agent_task