查询运行时任务详情

查询一个运行时任务的当前状态。

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

调用前准备

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

请求参数

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

输入示例

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

参数说明

参数	类型	是否必填	说明
workspace_id	string	是	读取任务的工作区 ID。
task_id	string	是	运行时任务 ID。

查询参数

参数	类型	是否必填	说明
agent_id	string	否	智能体 ID。
agent_workspace_id	string	否	当前工作区或 system。省略时不限定智能体来源。

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

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

成功响应

响应示例

{
  "code": 0,
  "data": {
    "id": "task_01",
    "workspace_id": "",
    "agent_id": "",
    "context_id": "",
    "state": "submitted",
    "a2a_state": "submitted",
    "manifest_id": "",
    "provider": "",
    "event_cursor": 0,
    "created_at": "2026-08-21T07:00:00Z",
    "updated_at": "2026-08-21T07:00:00Z"
  }
}

字段说明

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

错误响应

目标不存在或与指定智能体来源不匹配时，返回 HTTP 404，错误代码为 3。权限拒绝返回 HTTP 403，错误代码为 5。身份认证层的错误包络与本接口的业务错误包络不同。

响应示例

{
  "code": 3,
  "message": "task not found"
}

字段说明

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

最后更新于 2026 年 10 月 19 日