跳到主要内容

Get an agent task

Retrieves a model task with the given ID.

Path Parameters
task_id string — REQUIRED

The ID of the task to retrieve.

Responses
200

OK

Schema — OPTIONAL
jsonrpc string

JSON-RPC protocol version, always '2.0'.

id — OPTIONAL

请求/响应 ID，由客户端生成或服务器透传；可为字符串、整数或 null。

result object — OPTIONAL

The task object returned in JSON-RPC result.

object string

Possible values: [task]

固定为 task。

id string

任务 ID。

session_id string

会话 ID。

user_id string

用户 ID。

status string

Possible values: [created, queued, working, input-required, paused, completed, canceled, expired, failed]

任务生命周期状态。 CREATED：任务已创建但尚未开始。 QUEUED：任务已排队，等待处理。 WORKING：任务正在处理中。 INPUT_REQUIRED：任务需要额外输入以继续。 PAUSED：任务已暂停，需恢复后继续。 COMPLETED：任务已成功完成。 CANCELED：任务已取消，不会继续处理。 EXPIRED：任务已过期，不会继续处理。 FAILED：任务处理失败，不会重试。

常见情况：

  1. CREATED -> WORKING -> COMPLETED|FAILED|CANCELED|EXPIRED
  2. CREATED -> WORKING -> INPUT_REQUIRED -> WORKING -> COMPLETED|FAILED|CANCELED|EXPIRED
  3. CREATED -> WORKING -> PAUSED -> WORKING -> COMPLETED|FAILED|CANCELED|EXPIRED
  4. CREATED -> QUEUED -> WORKING -> COMPLETED|FAILED|CANCELED|EXPIRED
  5. CREATED -> QUEUED -> WORKING -> INPUT_REQUIRED -> WORKING -> COMPLETED|FAILED|CANCELED|EXPIRED
  6. CREATED -> QUEUED -> WORKING -> PAUSED -> WORKING -> COMPLETED|FAILED|CANCELED|EXPIRED

取消情况：

  1. CREATED -> CANCELED
  2. CREATED -> WORKING -> CANCELED
  3. CREATED -> QUEUED -> CANCELED
  4. CREATED -> QUEUED -> WORKING -> CANCELED
  5. CREATED -> QUEUED -> WORKING -> PAUSED -> CANCELED
  6. CREATED -> QUEUED -> WORKING -> INPUT_REQUIRED -> CANCELED

过期情况：

  1. CREATED -> WORKING -> EXPIRED
  2. CREATED -> WORKING -> INPUT_REQUIRED -> EXPIRED
  3. CREATED -> WORKING -> PAUSED -> EXPIRED
  4. CREATED -> QUEUED -> EXPIRED
  5. CREATED -> QUEUED -> WORKING -> EXPIRED
  6. CREATED -> QUEUED -> WORKING -> INPUT_REQUIRED -> EXPIRED
  7. CREATED -> QUEUED -> WORKING -> PAUSED -> EXPIRED
created_at integer

任务创建时间（Unix 秒）。

output object[]

模型/代理生成的输出条目集合（多类型）。

usage object — OPTIONAL

token 用量统计信息。

error object — OPTIONAL

JSON-RPC error object.

code integer

错误码（遵循 JSON-RPC 约定或服务端自定义）。

message string

错误信息。

data — OPTIONAL

自定义错误数据，任意 JSON 值或 null。

input_required_call_ids string[] — OPTIONAL

若任务等待外部输入，则给出需要执行的工具调用（如等待用户参数）。

metadata object — OPTIONAL

扩展元数据。

previous_task_id string — OPTIONAL

前置任务 ID（用于续写/衔接）。

rollouts object[] — OPTIONAL

任务推演/回溯事件集合（可选）。

error object — OPTIONAL

JSON-RPC error object.

code integer

错误码（遵循 JSON-RPC 约定或服务端自定义）。

message string

错误信息。

data — OPTIONAL

自定义错误数据，任意 JSON 值或 null。