查询运行时任务事件

查询一个运行时任务记录的事件。

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

调用前准备

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

请求参数

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

curl "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agent-runtime-tasks/$TASK_ID/events" -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。省略时不限定智能体来源。

after_seq

integer

否

仅返回序号大于该值的事件。负数按 0 处理。

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

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

成功响应

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

字段

类型

说明

data.items

object（对象数组）

满足游标条件的任务事件。

data.items[].id

string

标识。

data.items[].workspace_id

string

所属工作区 ID。

data.items[].task_id

string

任务 ID。

data.items[].seq

integer

事件序号。用于下次请求的 after_seq。

data.items[].kind

string

事件类型。取值：lifecycle、error、text_delta、tool_call、tool_result、artifact、audit、a2ui、interaction。

data.items[].a2a_state

string

A2A任务状态。取值：submitted、working、input-required、auth-required、completed、failed、canceled、rejected。

data.items[].payload

object

内容。

data.items[].visible

boolean

是否可见。

data.items[].created_at

string

创建时间。RFC 3339 时间。

data.total

integer

本次返回的事件数量。

data.after_seq

integer

本次请求使用的事件游标。

错误响应

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

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

字段

类型

说明

code

integer

错误代码。

message

string

面向调用者的错误信息。
最后更新于