查询智能体工作流绑定列表

查询工作区中将工作流节点关联到智能体任务模板的绑定。

GET https://moi.matrixorigin.cn/newmoi/workspaces/{workspace_id}/agent-workflow-bindings

调用前准备

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

请求参数

curl "https://moi.matrixorigin.cn/newmoi/workspaces/$WORKSPACE_ID/agent-workflow-bindings?limit=20&offset=0" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

查询参数

参数

类型

是否必填

说明

workflow_id

string

否

工作流 ID。

workflow_version_id

string

否

工作流版本 ID。

node_id

string

否

工作流节点 ID。

agent_task_template_id

string

否

智能体任务模板 ID。

status

string

否

绑定状态。

limit

integer

否

返回数量。

offset

integer

否

返回起始位置。

成功响应

{"code": 0, "data": {"items": [{"id": "binding_01", "workflow_id": "wf_01", "node_id": "node_01", "agent_task_template_id": "template_01"}], "total": 1, "limit": 20, "offset": 0}}

成功时返回 200 和当前页的绑定。

响应字段如下。

本文中，字段路径中的 [] 表示数组中的每一项。例如，items[].name 表示 items 数组中每一项的 name 字段。

字段

类型

说明

code

integer

成功时为 0。

字段

类型

说明

items

array

当前页的绑定。

total

integer

匹配总数。

下面表格展开响应示例中的 items 数据；每一行是该对象或数组项的一个字段。

字段

类型

说明

id

string

绑定 ID。

workflow_id

string

工作流 ID。

node_id

string

节点 ID。

agent_task_template_id

string

关联模板 ID。

错误响应

{"code": 2, "message": "invalid workflow binding filter"}

常见 HTTP 错误

字段

类型

说明

400

2

**常见原因：**查询参数无效。**建议操作：**检查筛选条件。
最后更新于