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

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

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

调用前准备

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

请求参数

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

输入示例

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

参数说明

参数	类型	是否必填	说明
workspace_id	string	是	所属工作区 ID。

查询参数

参数	类型	是否必填	说明
status	string	否	绑定状态。
workflow_id	string	否	工作流 ID。
workflow_version_id	string	否	工作流版本 ID。
node_id	string	否	完整节点路径，例如 root.prepare。
agent_task_template_id	string	否	关联模板 ID。
limit	integer	否	返回数量。
offset	integer	否	返回起始位置。

成功响应

响应示例

{
  "code": 0,
  "data": {
    "items": [
      {
        "id": "binding_01",
        "workspace_id": "",
        "workflow_id": "wf_01",
        "node_id": "root.prepare",
        "agent_task_template_id": "template_01",
        "status": "active",
        "version": 0,
        "created_at": "2026-08-21T07:00:00Z",
        "updated_at": "2026-08-21T07:00:00Z"
      }
    ],
    "total": 1,
    "limit": 20,
    "offset": 0
  }
}

字段说明

字段	类型	说明
data.items	object（对象数组）	当前页的绑定。
data.items[].id	string	标识。
data.items[].workspace_id	string	所属工作区 ID。
data.items[].workflow_id	string	工作流 ID。
data.items[].workflow_version_id	string	工作流版本 ID。
data.items[].node_id	string	完整节点路径。
data.items[].agent_task_template_id	string	智能体任务模板 ID。
data.items[].input_mapping	object	输入映射。
data.items[].output_mapping	object	输出映射。
data.items[].failure_mapping	object	失败映射。
data.items[].status	string	状态。取值：active、disabled、archived。
data.items[].version	integer	版本。
data.items[].labels	object	标签映射。
data.items[].annotations	object	注释映射。
data.items[].created_by	string	创建者。
data.items[].updated_by	string	最近更新者。
data.items[].created_at	string	创建时间。RFC 3339 时间。
data.items[].updated_at	string	更新时间。RFC 3339 时间。
data.total	integer	匹配总数。
data.limit	integer	本次查询数量上限。
data.offset	integer	本次查询偏移量。

错误响应

响应示例

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

字段说明

常见 HTTP 错误

HTTP 状态码	错误代码	说明
400	2	**常见原因：**查询参数无效。**建议操作：**检查筛选条件。

最后更新于 2026 年 10 月 19 日