API概览

API标准及多语言预置SDK

本产品(AgentRun/2025-09-10)的 OpenAPI 采用 ROA 签名机制,具体签名方式请参见签名机制说明我们已为开发者封装了主流编程语言的 SDK,您可通过 下载 SDK 快速调用 API,无需关注签名等底层实现细节,显著降低开发门槛与集成复杂度。

自定义签名场景

若您的业务场景有特殊需求,需通过自签名方式对接 API,建议优先咨询我们的技术支持团队(服务钉钉群:147535001692),获取专业指导以确保高效接入。

账号与安全准备

阿里云账号具备对所有资源的完全管理权限。一旦 AccessKey 泄露,所有相关资源都将面临未经授权访问的风险。为确保安全,建议创建一个仅具备 API 访问权限的 RAM 用户并配置其 AccessKey,同时基于最小权限原则 (PoLP) 配置 RAM 策略。仅在明确需要阿里云账号权限的特定场景下,才使用阿里云账号。

Agent 运行时

API标题API概述
CreateAgentRuntime创建智能体运行时创建智能体运行时。
GetAgentRuntime获取智能体运行时获取智能体运行时
UpdateAgentRuntime更新智能体运行时更新智能体运行时
DeleteAgentRuntime删除智能体运行时删除智能体运行时
ListAgentRuntimes获取智能体运行时列表获取智能体运行时列表
CreateAgentRuntimeEndpoint创建智能体运行时的访问端点创建智能体运行时的访问端点
ListAgentRuntimeEndpoints获取智能体运行时访问端点列表获取智能体运行时访问端点列表
GetAgentRuntimeEndpoint获取智能体运行时访问端点获取智能体运行时访问端点
UpdateAgentRuntimeEndpoint更新智能体运行时访问端点更新智能体运行时访问端点
DeleteAgentRuntimeEndpoint删除智能体访问端点删除智能体访问端点
PublishRuntimeVersion发布智能体运行时新版本发布智能体运行时新版本
ListAgentRuntimeVersions获取智能体运行时版本获取智能体运行时版本

Sandbox 沙箱

API标题API概述
沙箱模板管理沙箱模板管理
CreateTemplate创建模板创建模板。
GetTemplate获取模板获取模板。
ListTemplates列出模板列出模板。
UpdateTemplate更新模板更新模板。
DeleteTemplate删除模板删除模板。
StopTemplateMCP停止 TemplateMCP 服务停止 TemplateMCP 服务。
ActivateTemplateMCP启用 TemplateMCP 服务启用 沙箱 MCP 服务,用于客户端通过MCP协议进行访问沙箱。
沙箱实例管理沙箱实例管理
CreateSandbox创建 Sandbox创建 Sandbox。
GetSandbox获取 Sandbox获取 Sandbox。
ListSandboxes列出 Sandbox列出 Sandbox。
StopSandbox停止 Sandbox停止 Sandbox。
DeleteSandbox删除 Sandbox删除Sandbox实例。

模型管理

API标题API概述
CreateModelService创建模型创建模型。
UpdateModelService更新模型更新模型。
GetModelService获取模型信息获取模型信息。
DeleteModelService删除模型删除模型。
ListModelServices列出全部模型列出全部模型。
CreateModelProxy创建模型治理创建模型治理
UpdateModelProxy更新模型治理更新模型治理。
GetModelProxy获取模型治理信息获取模型治理信息。
DeleteModelProxy删除模型治理
ListModelProxies列出全部模型治理列出全部模型治理。

记忆存储

API标题API概述
GetMemoryCollection获取记忆存储
UpdateMemoryCollection更新记忆存储
DeleteMemoryCollection删除记忆存储
CreateMemoryCollection创建记忆存储
ListMemoryCollections列出记忆存储

其他

API标题API概述
GetCredential获取凭证信息获取凭证信息。
UpdateCredential更新凭证更新凭证。
ListCredentials列出全部凭证列出全部凭证。
CreateCredential创建新凭证创建新凭证。
DeleteCredential删除指定凭证删除指定凭证。
GetAccessToken获取accessToken获取accessToken。
CreateKnowledgeBase创建知识库创建知识库。
UpdateKnowledgeBase更新知识库更新知识库。
DeleteKnowledgeBase删除知识库删除知识库。
GetKnowledgeBase获取知识库获取知识库。
ListKnowledgeBases列出知识库列出知识库。
ListModelProviders列出全部模型供应商列出全部模型供应商。
DeleteCustomDomain删除自定义域名删除自定义域名。
ListCustomDomains列出自定义域名获取自定义域名信息列表。
CreateCustomDomain创建自定义域名创建自定义域名
GetCustomDomain获取自定义域名获取自定义域名配置。
UpdateCustomDomain更新自定义域名更新自定义域名。

待下线

API标题API概述
浏览器沙箱浏览器沙箱
CreateBrowser创建浏览器沙箱创建浏览器沙箱
ListBrowsers获取浏览器沙箱列表获取浏览器沙箱列表
GetBrowser获取浏览器沙箱获取浏览器沙箱
DeleteBrowser删除浏览器沙箱删除浏览器沙箱
代码解释器代码解释器
CreateCodeInterpreter创建代码解释器创建代码解释器
ListCodeInterpreters获取代码解释器列表获取代码解释器列表
GetCodeInterpreter获取代码解释器获取代码解释器
DeleteCodeInterpreter删除代码解释器删除代码解释器