查询运行时任务列表

查询智能体运行时已保存的任务。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-runtime-tasks

调用前准备

准备可访问目标工作区的个人访问令牌和目标工作区 ID。

请求参数

将示例中的 $WORKSPACE_ID、$AI_STUDIO_API_KEY 替换为实际值。

输入示例

curl "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agent-runtime-tasks" -H "X-API-Key: $AI_STUDIO_API_KEY" -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

参数	类型	是否必填	说明
workspace_id	string	是	所属工作区 ID。

查询参数

参数	类型	是否必填	说明
agent_id	string	否	仅返回指定智能体的任务。
agent_workspace_id	string	否	当前工作区或 system。省略时不限定智能体来源。
context_id	string	否	仅返回指定上下文的任务。
state	string	否	按任务当前状态筛选。
limit	integer	否	每页数量。未提供时为 50，最大 200。
offset	integer	否	起始偏移量。负数按 0 处理。

省略 agent_id 或 agent_workspace_id 时，不按对应条件限定智能体来源。填写 agent_workspace_id 时，只接受当前工作区或 system，不能传空值。

重复提交同名参数时，此接口读取第一个值。

成功响应

响应示例

{
  "code": 0,
  "data": {
    "items": [],
    "total": 0,
    "limit": 0,
    "offset": 0
  }
}

字段说明

字段	类型	说明
data.items	object（对象数组）	当前页的运行时任务。
data.items[].id	string	任务标识，可填入任务详情或事件请求的 task_id。
data.items[].workspace_id	string	所属工作区 ID。
data.items[].agent_workspace_id	string	智能体来源工作区。当前工作区或 system，筛选省略时不限定。
data.items[].agent_id	string	智能体 ID。
data.items[].context_id	string	上下文 ID。
data.items[].state	string	当前任务状态。取值：submitted、queued、working、input_required、auth_required、completed、failed、canceled、rejected、cancel_requested、reconciling。
data.items[].a2a_state	string	A2A任务状态。取值：submitted、working、input-required、auth-required、completed、failed、canceled、rejected。
data.items[].manifest_id	string	任务使用的运行时清单标识。
data.items[].provider	string	提供方。
data.items[].runtime_provider	string	运行提供方。
data.items[].runtime_profile	string	运行配置。
data.items[].runtime_facade	string	运行入口。
data.items[].backend_implementation	string	后端实现。
data.items[].backend_selection_policy	string	后端选择策略。
data.items[].tool_mode	string	工具模式。
data.items[].trace_id	string	TraceID。
data.items[].event_cursor	integer	事件游标。
data.items[].turn_input_snapshot_id	string	本轮输入快照 ID。
data.items[].turn_output_snapshot_id	string	本轮输出快照 ID。
data.items[].turn_output_committed	boolean	本轮输出是否已提交。
data.items[].input_summary	string	输入摘要。
data.items[].summary	string	摘要。
data.items[].artifact_refs	object（对象数组）	产物引用。
data.items[].instruction	object	任务指令。
data.items[].model_config	object	模型配置。
data.items[].skills	object（对象数组）	技能集合。
data.items[].tools	object（对象数组）	工具集合。
data.items[].tools[].id	string	标识。
data.items[].tools[].name	string	名称。
data.items[].tools[].kind	string	类别。
data.items[].tools[].description	string	说明。
data.items[].tools[].side_effect_class	string	副作用类别。取值：read、write、external_effect。
data.items[].tools[].input_schema	object	输入字段结构。
data.items[].tools[].output_schema	object	输出字段结构。
data.items[].tools[].metadata	object	扩展元数据。
data.items[].tools[].credential_ref	string	凭据引用。
data.items[].knowledge_bases	object（对象数组）	知识库引用。
data.items[].knowledge_bases[].id	string	标识。
data.items[].knowledge_bases[].name	string	名称。
data.items[].knowledge_bases[].description	string	说明。
data.items[].knowledge_bases[].metadata	object	扩展元数据。
data.items[].knowledge_bases[].catalog_asset_refs	object（对象数组）	Catalog 资产引用。
data.items[].attempt	object	尝试次数。
data.items[].attempt.snapshot_id	string	快照 ID。
data.items[].attempt.attempt	integer	尝试次数。
data.items[].attempt.turn_index	integer	交互轮次序号。
data.items[].attempt.kind	string	类别。取值：turn_input、turn_output、mcp_source_candidates、provider_run_terminal、provider_run_successor、provider_start_delivery_ack、astra_recovery_dispatch。
data.items[].attempt.regenerate	boolean	是否重新生成。
data.items[].attempt.retry_of_task_id	string	被重试任务 ID。
data.items[].attempt.same_manifest	boolean	是否使用同一运行清单。
data.items[].error	object	错误信息。
data.items[].created_at	string	创建时间。RFC 3339 时间。
data.items[].updated_at	string	更新时间。RFC 3339 时间。
data.total	integer	匹配任务总数。
data.limit	integer	当前页上限。
data.offset	integer	当前页起始偏移量。

错误响应

响应示例

{
  "code": 15,
  "message": "runtime read model is not available"
}

字段说明

字段	类型	说明
code	integer	错误代码。
message	string	面向调用者的错误信息。

最后更新于 2026 年 10 月 19 日