第4章 API参考（Agent）

Managed Agents API 是阿里云百炼提供的智能体托管运行时，由平台托管会话、沙箱、工具执行与事件流。 调用前请先配置认证；错误处理见错误码。 ​前提条件 已开通阿里云百炼，并创建 API Key。 获取工作空间 ID：阿里云百炼控制台右上角下拉菜单查看，形如 ws_xxxxxxxxxxxx。 ​Endpoint API 基地址按工作空间与地域拼装： Copyhttps://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio workspace_id：工作空间 ID，例如 ws_xxxxxxxxxxxx region：地域 ID，当前仅支持 cn-beijing ​SDK 除直接调用 REST 接口外，还可通过 Python 或 Java SDK 接入。Managed Agents 模块要求 Python SDK v1.26.2 及以上、Java SDK v2.22.24 及以上。若已安装旧版本，请重新执行安装命令以升级。 会话级智能体配置覆盖（agent 对象与 patch）和会话级 MCP 请求头（mcp_configs）需要 Python SDK v1.27.7 及以上、Java SDK v2.23.2 及以上；直接调用 REST 接口不受此限制。 Copypip install dashscope ​请求与响应 请求体为 JSON，Content-Type: application/json 每次响应携带 x-request-id 头，可用于定位具体请求 列表端点支持分页：limit（默认 20，最大 100）、page（首次不传，后续传上一次响应的 next_page）。响应不含 next_page 表示已是末页 ​可用 API 资源端点用途AgentPOST /agents创建 AgentGET /agents/{agent_id}获取 AgentGET /agents列出 AgentPOST /agents/{agent_id}更新 Agent（自动生成新版本号）POST /agents/{agent_id}/archive归档 AgentEnvironmentPOST /environments创建 EnvironmentGET /environments/{environment_id}获取 EnvironmentGET /environments列出 EnvironmentPOST /environments/{environment_id}更新 EnvironmentDELETE /environments/{environment_id}删除 EnvironmentPOST /environments/{environment_id}/archive归档 EnvironmentSession and EventPOST /sessions创建 SessionGET /sessions/{session_id}获取 SessionGET /sessions列出 SessionPOST /sessions/{session_id}更新 Session（如重命名）DELETE /sessions/{session_id}删除 SessionPOST /sessions/{session_id}/archive归档 SessionPOST /sessions/{session_id}/events发送 Event（向 Agent 投递用户消息或工具回执）GET /sessions/{session_id}/events列出 Event 历史；订阅 SSE 事件流（流式输出）FilePOST /files上传 File（multipart/form-data）GET /files/{file_id}查询 File 元数据GET /files列出 FileDELETE /files/{file_id}删除 FileMemory StorePOST /memory_stores创建 Memory StoreGET /memory_stores列出 Memory StoreGET /memory_stores/{memory_store_id}获取 Memory StorePOST /memory_stores/{memory_store_id}更新 Memory StorePOST /memory_stores/{memory_store_id}/archive归档 Memory StorePOST /memory_stores/{memory_store_id}/memories创建 Memory（记忆文件）GET /memory_stores/{memory_store_id}/memories列出 MemoryGET /memory_stores/{memory_store_id}/memories/{memory_id}获取 MemoryPOST /memory_stores/{memory_store_id}/memories/{memory_id}更新 MemoryDELETE /memory_stores/{memory_store_id}/memories/{memory_id}删除 MemoryGET /memory_stores/{memory_store_id}/memory_versions列出 Memory Version（历史版本）GET /memory_stores/{memory_store_id}/memory_versions/{memory_version_id}获取 Memory VersionPOST /memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact擦除 Memory Version 正文SkillPOST /skills创建 SkillGET /skills/{skill_id}查询 SkillGET /skills列出 SkillDELETE /skills/{skill_id}删除 SkillPOST /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 包VaultPOST /vaults创建 VaultGET /vaults/{vault_id}获取 VaultGET /vaults列出 VaultPOST /vaults/{vault_id}更新 VaultDELETE /vaults/{vault_id}删除 VaultPOST /vaults/{vault_id}/archive归档 VaultCredentialPOST /vaults/{vault_id}/credentials创建 CredentialGET /vaults/{vault_id}/credentials/{credential_id}获取 CredentialGET /vaults/{vault_id}/credentials列出 CredentialPOST /vaults/{vault_id}/credentials/{credential_id}更新 CredentialDELETE /vaults/{vault_id}/credentials/{credential_id}删除 CredentialPOST /vaults/{vault_id}/credentials/{credential_id}/archive归档 CredentialWebhookPOST /webhook_endpoints创建 WebhookGET /webhook_endpoints/{id}查询 Webhook 详情GET /webhook_endpoints查询 Webhook 列表PUT /webhook_endpoints/{id}更新 WebhookDELETE /webhook_endpoints/{id}删除 WebhookPOST /webhook_endpoints/{id}/enable启用 WebhookPOST /webhook_endpoints/{id}/disable禁用 WebhookPOST /webhook_endpoints/{id}/test测试 WebhookPOST /webhook_endpoints/{id}/reset_secret重置 Signing SecretGET /webhook_endpoints/{id}/events查询 Webhook 事件