阿里云百炼 Agent Studio 提供多套 API，覆盖智能体托管运行、应用调用、知识检索、记忆管理等场景。本页汇总各 API 的适用场景与入口。
API 体系
阿里云百炼 Agent Studio 按产品能力划分为以下 API 模块：
| API 模块 | 适用场景 |
|---|---|
| Managed Agent API | 托管智能体的全生命周期管理：创建 Agent、配置环境、委派任务、管理会话与事件流 |
| Flow Agent API | 调用百炼平台上创建的智能体应用和工作流应用 |
| Knowledge Studio API | 知识库的检索与问答 |
| Memory API | 记忆库的创建、读写与规则配置 |
| Framework SDK | 通过 LlamaIndex、Spring AI 等框架集成百炼服务 |
通用说明
鉴权
所有 API 均通过 HTTP Header 携带 API Key 进行认证：
地域与 Endpoint
- Managed Agent API：
https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio - Flow Agent API（DashScope）：
https://dashscope.aliyuncs.com/api/v1/apps/{app_id}/completion - Knowledge Studio API：
https://dashscope.aliyuncs.com/api/v1/apps/{app_id}/completion
请求与响应格式
- 请求体：
application/json - 响应体：
application/json（流式响应为text/event-stream） - 字符编码：UTF-8
错误处理
API 返回标准 HTTP 状态码，响应体包含 code 和 message 字段描述具体错误。各模块的错误码详情请参考对应 API 文档。