Managed Agents API 是千问AI平台提供的智能体托管运行时，由平台托管会话、沙箱、工具执行与事件流。
前提条件
创建 API Key：通过控制台获取。
Endpoint
所有接口使用统一的服务地址：
cn-beijing 地域。
鉴权
全部请求通过 HTTP Header 携带 API Key，一个 Key 可访问其归属业务空间下的全部资源。
SDK
除直接调用 REST 接口外，还可通过 Python 或 Java SDK 接入。Managed Agents 模块要求 Python SDK v1.26.2 及以上、Java SDK v2.22.24 及以上。若已安装旧版本，请重新执行安装命令以升级。
请求与响应
- 请求体为 JSON，
Content-Type: application/json - 每次响应携带
x-request-id头，提工单时附上此 ID 可加速定位 - 列表端点支持分页：
limit（默认 20，最大 100）、page（首次不传，后续传上一次响应的next_page）。响应不含next_page表示已是末页
可用 API
| 资源 | 端点 | 用途 |
|---|---|---|
| Agent | POST /agents | 创建 Agent |
GET /agents/{agent_id} | 获取 Agent | |
GET /agents | 列出 Agent | |
POST /agents/{agent_id} | 更新 Agent（自动生成新版本号） | |
POST /agents/{agent_id}/archive | 归档 Agent | |
| Environment | POST /environments | 创建 Environment |
GET /environments/{environment_id} | 获取 Environment | |
GET /environments | 列出 Environment | |
POST /environments/{environment_id} | 更新 Environment | |
DELETE /environments/{environment_id} | 删除 Environment | |
POST /environments/{environment_id}/archive | 归档 Environment | |
| Session & Event | POST /sessions | 创建 Session |
GET /sessions/{session_id} | 获取 Session | |
GET /sessions | 列出 Session | |
POST /sessions/{session_id} | 更新 Session（如重命名） | |
DELETE /sessions/{session_id} | 删除 Session | |
POST /sessions/{session_id}/archive | 归档 Session | |
POST /sessions/{session_id}/events | 发送 Event（向 Agent 投递用户消息或工具回执） | |
GET /sessions/{session_id}/events | 列出 Event 历史；订阅 SSE 事件流（流式输出） | |
| File | POST /files | 上传 File（multipart/form-data） |
GET /files/{file_id} | 查询 File 元数据 | |
GET /files | 列出 File | |
DELETE /files/{file_id} | 删除 File | |
| Skill | POST /skills | 创建 Skill |
GET /skills/{skill_id} | 查询 Skill | |
GET /skills | 列出 Skill | |
DELETE /skills/{skill_id} | 删除 Skill | |
POST /skills/{skill_id}/versions | 上传 Skill 新版本 | |
GET /skills/{skill_id}/versions/{version} | 查询 Skill 版本 | |
GET /skills/{skill_id}/versions | 列出 Skill 版本 | |
GET /skills/{skill_id}/versions/{version}/content | 下载 Skill 包 | |
| Vault | POST /vaults | 创建 Vault |
GET /vaults/{vault_id} | 获取 Vault | |
GET /vaults | 列出 Vault | |
POST /vaults/{vault_id} | 更新 Vault | |
DELETE /vaults/{vault_id} | 删除 Vault | |
POST /vaults/{vault_id}/archive | 归档 Vault | |
| Credential | POST /credentials | 创建 Credential |
GET /credentials/{credential_id} | 获取 Credential | |
GET /credentials | 列出 Credential | |
POST /credentials/{credential_id} | 更新 Credential | |
DELETE /credentials/{credential_id} | 删除 Credential | |
POST /credentials/{credential_id}/archive | 归档 Credential | |
| Webhook | POST /webhook_endpoints | 创建 Webhook |
GET /webhook_endpoints/{id} | 查询 Webhook 详情 | |
GET /webhook_endpoints | 查询 Webhook 列表 | |
PUT /webhook_endpoints/{id} | 更新 Webhook | |
DELETE /webhook_endpoints/{id} | 删除 Webhook | |
POST /webhook_endpoints/{id}/enable | 启用 Webhook | |
POST /webhook_endpoints/{id}/disable | 禁用 Webhook | |
POST /webhook_endpoints/{id}/test | 测试 Webhook | |
POST /webhook_endpoints/{id}/reset_secret | 重置 Signing Secret | |
GET /webhook_endpoints/{id}/events | 查询 Webhook 事件 |