API概览

更新时间:
复制为 MD 格式

API标准及多语言预置SDK

本产品(AgentRun/2025-09-10)的OpenAPI采用ROA签名风格。我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(147535001692),在专家指导下进行签名对接。

在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

自定义签名场景

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

账号与安全准备

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

流程编排

API

标题

API概述

DeleteFlowVersion 删除流程版本 删除工作流版本。
DeleteFlow 删除流程编排 删除工作流。
DeleteFlowEndpoint 删除流程编排调用端点 删除工作流端点
ConvertFlowDSL 流程DSL转换 转换Flow DSL。
PublishFlowVersion 发布流程版本 发布工作流版本。
ListFlows 获取流程编排列表 列出工作流
ListFlowVersions 获取流程版本列表 列出工作流版本。
ListFlowEndpoints 获取流程编排调用端点列表 列出工作流端点。
UpdateFlowEndpoint 更新变成编排调用端点 更新工作流端点
UpdateFlowDraft 更新流程编排草稿 更新工作流草稿。
UpdateFlow 更新流程编排 更新工作流。
GetFlowVersion 获取流程版本信息 获取工作流版本详情。
GetFlowEndpoint 查询流程调用端点详情 获取工作流端点详情。
GetFlowDraft 查询流程草稿详情 获取工作流草稿。
GetFlow 查询流程编排详情 获取工作流详情
CreateFlowEndpoint 创建流程调用端点 创建工作流端点。
CreateFlow 创建流程编排 创建工作流。

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 更新自定义域名 更新自定义域名。
GetWorkspaceDiscoveryEndpoints 获取工作空间发现端点配置 获取工作空间下的发现端点
UpdateWorkspaceDiscoveryEndpoints 更新工作空间的发现端点 获取工作空间下的发现端点
DeleteWorkspace 删除工作空间 删除工作空间
UpdateWorkspace 更新工作空间 更新工作空间
ListWorkspaces 获取工作空间列表 获取工作空间列表
GetWorkspace 获取工作空间详情 查看工作空间
CreateWorkspace 创建工作空间 创建工作空间
UpdateTool 更新工具 Update a tool.
CreateTool 创建工具 Create a tool.
ListTools 列出工具 List tools
GetTool 获取工具 Get a tool
DeleteTool 删除工具 Delete a tool
ResumeSandbox 恢复沙箱 恢复暂停状态的沙箱,可以将PAUSED状态的沙箱恢复至运行态(READY)状态
PauseSandbox 暂停沙箱 暂停该沙箱,保留内存和文件系统快照,沙箱进入PAUSED状态,以便在后续恢复

待下线

API

标题

API概述

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