查询智能体会话任务记录¶
读取一个可访问智能体会话中的任务投影,以恢复历次调用的状态、展示内容和产物。此接口不发送新消息,也不执行或重试任务。
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/conversations/{conversation_id}/tasks
调用前准备¶
PRODUCT_API_BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。
PRODUCT_API_BASE_URL 包含目标环境的产品前缀。准备本人的凭据与有权限的 WORKSPACE_ID,路径 ID 和 X-Workspace-ID 必须一致。示例 ID 需替换为该环境的实际返回值。 会话 ID 来自智能体 conversations 的创建、列表或详情,不使用独立 LLM 数值会话 ID。
请求¶
curl --get "$PRODUCT_API_BASE_URL/workspaces/$WORKSPACE_ID/conversations/$CONVERSATION_ID/tasks" \
-H "X-API-Key: $PRODUCT_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
--data-urlencode "agent_id=$AGENT_ID" \
--data-urlencode "agent_workspace_id=$AGENT_WORKSPACE_ID"
查询参数 |
类型 |
必填 |
说明 |
|---|---|---|---|
agent_id |
string |
否 |
校验会话所属智能体范围。 |
agent_workspace_id |
string |
否 |
智能体来源工作区,只能为当前工作区或 system。传 agent_id 但省略此值时默认当前工作区。 |
本动作没有 limit/offset/游标;当前 handler 不读取这些参数。普通会话限当前创建者;系统 workflow 创作会话另按工作区范围处理,仍需身份和角色授权。
成功响应¶
{"code":0,"data":{"items":[{"kind":"task","id":"task-example","contextId":"conversation-example","status":{"state":"working","timestamp":"2026-11-12T01:02:03Z"},"metadata":{"eventCursor":3,"agentId":"agent-example"}}]}}
字段 |
类型 |
说明 |
|---|---|---|
data.items |
array |
本次会话任务记录,为 A2A Task 投影。无结果为空数组。 |
data.items[].kind |
string |
task。 |
data.items[].id |
string |
真实任务 ID,后续任务查询使用此值。 |
data.items[].contextId |
string |
智能体会话上下文 ID;字段使用 A2A 驼峰格式。 |
data.items[].status.state |
string |
A2A 状态,不直接复用原始运行时内部状态枚举。 |
data.items[].status.timestamp |
string |
任务更新时间。 |
data.items[].status.message |
object |
可选的当前展示消息;parts 中可有多种内容。 |
data.items[].artifacts |
array |
有产物时返回的 A2A 产物,可能省略。 |
data.items[].metadata |
object |
任务展示元数据;可含 eventCursor、manifestId、provider、agentId、traceId 等。 |
A2A 状态包括 submitted、working、input-required、auth-required、completed、failed、canceled、rejected;queued 投影为 submitted,cancel_requested/reconciling 等内部状态投影为 working。不要把不同接口的状态枚举直接比较。
判断结果¶
结果可含运行中尚在变化的展示内容;请求成功不代表所有任务完成,也不是原始私有事件日志。任务按会话回合的持久化顺序合并读取,不能按 id 字符串推断时间。私有事件不会作为直接事件数组返回;缺少产物字段也不等于从未执行过任务。
后续查询或控制任务时保留当前工作区、智能体来源工作区、智能体 ID、contextId 和实际 id。不得把 contextId 当 task ID,或把任务 id 传到会话消息接口。
错误¶
先校验会话作用域,再读取任务历史。会话或任务不存在/范围不匹配可返回 404;参数错误为 400,权限失败为 403。任务或候选展示损坏可返回 500,依赖失败可返回 503/504。失败时不把空列表当成功结果,也不据读取失败重复发送消息。