查询智能体任务结果

接口用途

查询已发送消息对应的任务结果。该接口使用智能体通信协议（A2A）传递消息和查询任务结果。

请求方式

POST

接口地址

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agents/<agent_id>/a2a

身份认证

使用工作区 API Key，在请求头中携带 X-API-Key: <WORKSPACE_API_KEY>，并设置 Content-Type: application/json。

路径参数

名称	说明
agent_id	目标智能体标识。

查询参数

无。

请求体

JSON-RPC 2.0；method 使用 tasks/get。

字段	类型	必填	说明
jsonrpc	string	是	2.0
id	string	number	否
method	string	是	tasks/get
params.id	string	条件	任务 ID（与 taskId 二选一）
params.taskId	string	条件	任务 ID 别名
params.afterSeq	integer	否	事件游标

请求示例

curl -X POST 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agents/<agent_id>/a2a' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":"2","method":"tasks/get","params":{"id":"<task_id>"}}'

响应说明

JSON-RPC 响应；result 为 Task：

字段	类型	必填	说明
id	string		任务 ID
contextId	string		上下文 ID
status.state	string		submitted / working / input-required / completed / failed / canceled 等
status.message	object		状态附带消息
artifacts	array		产出物列表
metadata	object		运行元数据

使用限制

• 与发送消息共用同一接口地址，通过 JSON-RPC method 区分操作。

相关接口

• 向智能体发送消息

• 查询智能体详情