请求约定与占位符

接口路径中的尖括号项需要在调用时替换为实际值。文档示例只使用占位符，不写入真实密钥或业务标识。

占位符

占位符

含义

<workspace_id>

工作区标识

<agent_id>

智能体标识

<candidate_version>

候选版本标识

<task_id>

自动化任务标识

<run_id>

运行记录标识

<tool_id>

工具标识

<connection_id>

连接标识

<instance_id>

消息渠道实例标识

<credential_ref>

回调凭据引用

<WORKSPACE_API_KEY>

工作区 API Key

<service_name>

API 类型自动化任务服务名

响应格式

除 A2A JSON-RPC 外，多数工作区接口成功响应形如：

{"code": 0, "data": {}}

失败时常见 code 非 0，并可能带 message / details。各接口页的字段表通常描述 data（含 HTTP 202 时的 data）。A2A 接口直接返回 JSON-RPC：jsonrpc / id / result / error。

安全要求

不要在文档或示例中写入真实的工作区 API Key、MCP Token、Feishu Secret、数据库密码、Credential 明文，或真实用户与工作区标识。

核心调用入口

场景

入口

直接调用智能体

POST /agents/<agent_id>/a2a

触发 API 类型自动化任务

POST /dynamic-services/invoke

创建或修改可运行智能体

GET /agent-builder/resources → POST /agent-builder/candidates → POST .../commit

相关接口