跳到主要内容

List Tasks

List all tasks.

  • Returns a JSON-RPC ListTasksResponse envelope.
Query Parameters
session_id Session Id

Session ID filter

Session ID filter

user_id User Id

User ID filter

User ID filter

status Status

Task status filter

Task status filter

starting_after Starting After

Cursor for pagination

Cursor for pagination

ending_before Ending Before

Cursor for pagination

Cursor for pagination

limit Limit

Maximum number of tasks to return

Maximum number of tasks to return

Responses
200

Successful Response

Schema OPTIONAL
jsonrpc Jsonrpc OPTIONAL
id Id OPTIONAL
result object[] OPTIONAL
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 OPTIONAL
422

Validation Error

Schema OPTIONAL
detail object[] OPTIONAL
loc undefined[]
msg Message
type Error Type