API概览
更新时间:
复制 MD 格式
API标准及多语言预置SDK
本产品(AgentCore/2026-08-04)的OpenAPI采用ROA签名风格。我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(147535001692),在专家指导下进行签名对接。
在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey。
自定义签名场景
若您的业务场景有特殊需求,需通过自签名方式对接 API,建议优先咨询我们的技术支持团队(服务钉钉群:147535001692),获取专业指导以确保高效接入。
账号与安全准备
阿里云账号具备对所有资源的完全管理权限。一旦 AccessKey 泄露,所有相关资源都将面临未经授权访问的风险。为确保安全,建议创建一个仅具备 API 访问权限的RAM用户并配置其 AccessKey,同时基于最小权限原则 (PoLP) 配置 RAM 策略。仅在明确需要阿里云账号权限的特定场景下,才使用阿里云账号。
API目录
|
API |
标题 |
API概述 |
| AddMemories | 写入长期记忆 | 向记忆空间写入消息或文本。sync 缺省为 true,同步等待抽取并仅返回 memories(允许空数组);sync=false 仅返回 taskId,通过 GetMemoryTask 查询。 |
| BatchDeleteModels | 批量删除模型 | 批量删除指定工作空间中的模型;任一模型正在被使用时,整批请求失败。 |
| BatchUploadSkillsViaOss | 批量上传 Skill | 通过 OSS 中转批量上传 Skill ZIP 包,并返回每个 Skill 的处理结果。 |
| ConvertMcpToFreeEdit | 将 MCP 转为自由编辑 | 将 MCP 转为自由编辑 |
| CreateAgentIMChannel | 创建智能体 IM 渠道 | 为指定智能体创建 IM 渠道,并绑定可公开访问的 ServiceEndpoint。 |
| CreateAgentSpec | 创建 AgentSpec | 在指定工作空间中创建 AgentSpec,并生成首个草稿版本。同名 AgentSpec 已存在时返回资源冲突错误。 |
| CreateAgentSpecVersion | 创建 AgentSpec 草稿版本 | 为已有 AgentSpec 创建新的草稿版本。AgentSpec 必须存在,且当前不能有正在编辑的草稿。 |
| CreateCredential | 创建凭证 | 在指定工作空间内创建凭证,用于智能体访问外部服务时的鉴权。当前仅支持 apiKey 类型,凭证内容通过 credentialMetadata 以 JSON 字符串传入,写入后只能以脱敏形式查询。 |
| CreateCustomAgent | 创建自定义智能体 | 在指定工作空间中创建自定义智能体,支持容器镜像或代码包部署。创建为异步过程,可通过 GetCustomAgent 查询部署结果。 |
| CreateExternalAgent | 创建外部智能体 | 在指定工作空间下创建外部智能体。 |
| CreateExternalAgentBootstrapToken | 创建外部智能体 Bootstrap Token | 为指定外部智能体创建接入所需的 Bootstrap Token 和 CMS 配置。 |
| CreateIdentityProvider | 绑定外部身份提供商 | 为工作空间绑定钉钉、飞书或 CustomSSO 身份源。CustomSSO 仅异步初始化共享用户池,SAML 登录与 SCIM 同步后续分别配置。 |
| CreateIdentityProviderSCIMCredential | 创建 SCIM 凭据 | 显式签发一枚 SCIM 凭据并仅当次返回 Token 明文。同池最多两枚,不自动撤销旧凭据或开启 AC 用户同步。 |
| CreateIdentityProviderSyncJob | 创建身份源同步任务 | 发起身份源手动同步 |
| CreateImageCache | 创建镜像缓存 | 创建镜像缓存 |
| CreateManagedAgent | 创建托管智能体 | 在指定工作空间下创建托管智能体。 |
| CreateMcp | 创建 MCP 服务 | 在指定工作空间中创建 MCP 服务。创建为异步过程,可通过返回的状态或查询接口确认服务是否就绪。 |
| CreateMemoryStore | 创建 MemoryStore | 在指定工作空间中创建长期记忆库。 |
| CreateModel | 创建模型 | 在指定工作空间的模型连接下创建模型配置。 |
| CreateModelConnection | 创建模型连接 | 在指定工作空间中创建模型连接,并配置上游模型服务地址、调用协议和访问凭据。 |
| CreatePermissionRules | 创建权限规则 | 创建权限规则。 |
| CreateSkillDraft | 创建 Skill 草稿 | 在指定工作空间中创建 Skill,并生成可继续编辑的草稿版本。可以基于已有版本派生草稿,也可以指定目标版本和提交说明。 |
| CreateTeam | 创建团队 | 在指定工作空间内创建团队,并同时设置用户成员和智能体成员。用户成员中必须且只能有一个角色为 ADMIN 的成员,智能体成员的角色只能是 LEADER 或 WORKER。 |
| CreateUser | 创建用户 | 在指定工作空间内创建用户。用户名称在工作空间内唯一,只能包含小写字母、数字和连字符,并且不能使用 manager、admin 或以 worker- 开头的保留名称。不指定 password 时由服务端生成初始密码,并通过响应中的 initialPassword 返回。 |
| CreateWorkspace | 创建工作空间 | 创建 AgentCore 工作空间控制面记录。服务端在同一事务内完成 Initializing 到 Initialized 的状态转换。 |
| DebugModel | 调试模型 | 通过已发布的模型连接调用指定模型,用于验证模型调用链路是否可用。 |
| DeleteAccessApplication | 删除访问应用 | 删除接入应用。 |
| DeleteAgentIMChannel | 删除智能体 IM 渠道 | 删除指定智能体的 IM 渠道。 |
| DeleteAgentSpec | 删除 AgentSpec | 删除指定 AgentSpec 及其全部版本和元数据。删除操作不可恢复。 |
| DeleteAgentSpecVersion | 删除 AgentSpec 草稿版本 | 删除指定 AgentSpec 当前正在编辑的草稿版本,并清除草稿版本指针。 |
| DeleteCredential | 删除凭证 | 删除指定工作空间内的凭证,同时删除托管在凭证服务中的密文。删除后已绑定该凭证的智能体将无法再获取凭证内容。 |
| DeleteCustomAgent | 删除自定义智能体 | 删除指定工作空间中的自定义智能体。请求成功表示已受理删除,运行资源随后在后台清理。 |
| DeleteExternalAgent | 删除外部智能体 | 删除指定的外部智能体。 |
| DeleteIdentityProvider | 解绑外部身份提供商 | 整体断开工作空间的身份源集成。CustomSSO 会清理共享用户池及相关 SAML、SCIM 资源;只关闭登录或同步时应使用对应开关接口。 |
| DeleteIdentityProviderSCIMCredential | 删除 SCIM 凭据 | 撤销指定 SCIM 凭据。不会自动创建新 Token、修改 AC 同步开关或关闭 SAML 登录。 |
| DeleteImageCache | 删除镜像缓存 | 删除镜像缓存 |
| DeleteManagedAgent | 删除托管智能体 | 删除指定的托管智能体。 |
| DeleteMcp | 删除 MCP 服务 | 删除指定 MCP 服务。删除为异步过程,完成后该 MCP 服务将不再返回。 |
| DeleteMemory | 删除长期记忆 | 根据 Memory ID 删除一条长期记忆。 |
| DeleteMemoryStore | 删除 MemoryStore | 异步删除 MemoryStore 及其中全部长期记忆。 |
| DeleteModel | 删除模型 | 删除指定工作空间中的模型;正在被使用的模型不能删除。 |
| DeleteModelConnection | 删除模型连接 | 提交指定模型连接的异步删除任务;存在关联模型或运行时引用时不能删除。 |
| DeletePermissionRule | 删除权限规则 | 删除权限规则。 |
| DeleteSkill | 删除 Skill | 删除指定工作空间中的 Skill 及其相关版本数据。删除操作不可恢复。 |
| DeleteSkillDraft | 删除 Skill 草稿 | 删除指定 Skill 当前正在编辑的草稿版本。 |
| DeleteTeam | 删除团队 | 删除指定工作空间内的团队。删除团队不会删除其中的用户和智能体,只解除成员关系。 |
| DeleteUser | 删除用户 | 删除指定工作空间内的用户。用户仍然是任意团队的成员时不允许删除,需要先将其从团队中移除。 |
| DeleteWorkspace | 删除工作空间 | 删除指定工作空间控制面记录。服务端在同一事务内完成 Deleting 到 Deleted 的状态转换。重复删除处于 Deleting 或 Deleted 状态的工作空间时,服务端按幂等语义处理。 |
| DisableConnector | 停用 Connector | 停用指定工作空间中的 QoderCLI Connector。仅当没有 Agent 使用该 Connector 时可以停用;停用后移除 Connector 及其 Service Account Key 配置。 |
| DownloadAgentSpecViaOss | 下载 AgentSpec | 获取指定 AgentSpec 的 OSS 预签名下载地址,用于下载 AgentSpec ZIP 包。 |
| DownloadSkillVersionViaOss | 下载 Skill 版本 | 获取指定 Skill 版本的 OSS 预签名下载地址,用于下载对应的 Skill ZIP 包。 |
| EnableConnector | 启用 Connector | 在指定工作空间中启用 QoderCLI Connector。请求需提供站点、API Key 和至少一个 Service Account Key;服务会先验证所有账号密钥,再保存配置。 |
| FindCustomAgentImagePreparation | 按提交令牌查询自定义镜像准备进度 | 通过创建或显式更新镜像时提交的 clientToken 找回本次镜像准备任务。仅查询任务,不创建转存;返回的 phase 为 SUCCEEDED 时,表示本次目标版本部署成功。 |
| ForcePublishSkillVersion | 强制发布 Skill 版本 | 跳过常规审核流程,强制发布指定的 Skill 版本。 |
| GetAccessApplication | 查询访问应用详情 | 查询接入应用。 |
| GetAgentCodePackageDownloadUrl | 获取智能体代码包下载地址 | 获取智能体已保存代码包下载地址 |
| GetAgentCodePackageOssRamAuthorizeUrl | 获取智能体代码包 OSS 授权地址 | 获取智能体代码包 OSS RAM 授权地址 |
| GetAgentCodePackageUploadUrl | 获取智能体代码包上传地址 | 获取智能体代码包上传地址 |
| GetAgentIMChannel | 查询智能体 IM 渠道 | 查询指定智能体 IM 渠道的详细信息。 |
| GetAgentSpec | 查询 AgentSpec 详情 | 查询指定 AgentSpec 的治理详情,包括基础信息、治理指针和全部版本摘要。 |
| GetAgentSpecImportFileUrl | 获取 AgentSpec 导入地址 | 获取导入 AgentSpec ZIP 包所需的 OSS 预签名上传地址和对象名称。上传完成后,可调用 AgentSpec OSS 上传接口完成导入。 |
| GetAgentSpecLatest | 查询 AgentSpec 最新版本 | 查询指定 AgentSpec 的最新版本完整内容,用于编辑或查看 latest 版本。 |
| GetAgentSpecVersion | 查询 AgentSpec 指定版本 | 查询指定 AgentSpec 版本的完整内容,包括 manifest 内容、资源文件和元数据。 |
| GetCredential | 查询凭证 | 查询指定凭证的详细信息,并返回已绑定该凭证的智能体列表。凭证内容以脱敏形式返回。 |
| GetCustomAgent | 查询自定义智能体详情 | 查询指定工作空间中的自定义智能体详情,包括部署配置、最新配置版本的执行状态和运行实例状态统计。 |
| GetCustomAgentImagePreparation | 查询自定义镜像准备进度 | 通过 preparationId 查询本次镜像准备和部署阶段。普通轮询不创建转存任务;只有 phase=SUCCEEDED 表示本次目标版本部署成功,旧实例健康不代表本次成功。 |
| GetExternalAgent | 查询外部智能体 | 查询指定外部智能体的详细信息。 |
| GetExternalAgentBootstrapOptions | 查询外部智能体接入网络 | 查询指定外部智能体可用的接入网络类型。 |
| GetIdentityProvider | 查询外部身份提供商 | 查询指定身份源的绑定和期望配置。CustomSSO 已配置 SAML 时回读上游实际 SSO 配置,SCIM 状态通过独立接口查询。 |
| GetIdentityProviderSCIM | 查询 SCIM 配置及独立操作状态 | 查询 SCIM 实际接收配置、AC 同步期望开关和最近一次独立 SCIM 任务状态。无需先配置 SAML。 |
| GetIdentityProviderServiceProvider | 查询 SAML 服务提供商信息 | 查询 CustomSSO 的 SAML SP 信息,包括 Entity ID、ACS URL 和 SP Metadata XML,供用户配置外部 IdP。 |
| GetIdentityProviderSyncJob | 查询身份源同步任务 | 查询身份源同步任务 |
| GetIdentityProviderSyncScope | 查询身份源同步范围 | 查询身份源同步范围 |
| GetImageCache | 查询镜像缓存详情 | 查询镜像缓存详情 |
| GetManagedAgent | 查询托管智能体 | 查询指定托管智能体的详细信息。 |
| GetMcp | 查询 MCP 服务详情 | 查询指定 MCP 服务的地址、类型、状态、认证配置和协议等详情。 |
| GetMcpMarketItem | 查询 MCP 市场模板详情 | 查询 MCP 市场模板详情 |
| GetMemory | 查询长期记忆 | 根据 Memory ID 查询一条长期记忆。 |
| GetMemoryStore | 查询 MemoryStore | 查询指定工作空间中 MemoryStore 的公开信息和当前状态。 |
| GetMemoryTask | 查询记忆抽取任务 | 查询异步 AddMemories 返回的 taskId。 |
| GetModel | 查询模型 | 查询指定工作空间中模型的详细配置和所属地域。 |
| GetModelConnection | 查询模型连接 | 查询指定模型连接的详细配置、凭据配置状态、发布状态和所属地域。 |
| GetServiceEndpoint | 查询服务端点 | 查询指定服务端点的详细信息,包括目标路由、访问地址、鉴权配置和当前状态。 |
| GetServiceEndpointApiKey | 查询服务端点 API Key | 查询指定工作空间内服务端点当前生效的 API Key 及其调用方式。 |
| GetSkillDetail | 查询 Skill 详情 | 查询指定 Skill 的基础信息、版本状态、标签、可见范围和版本列表。 |
| GetSkillImportFileUrl | 获取 Skill 导入地址 | 获取导入 Skill ZIP 包所需的 OSS 预签名上传地址和对象名称。上传完成后,可调用 Skill OSS 上传接口完成导入。 |
| GetSkillVersionDetail | 查询 Skill 版本详情 | 查询指定 Skill 版本的完整详情,包括版本元数据、Skill 内容和关联资源。 |
| GetTeam | 查询团队 | 查询指定团队的详细信息,响应中同时返回团队内每个用户成员和智能体成员的完整属性及其团队角色。 |
| GetUser | 查询用户 | 查询指定工作空间内某个用户的详细信息。用户不存在时返回错误。 |
| GetWorkspace | 查询工作空间 | 根据工作空间 ID 查询工作空间详情,包括生命周期状态、CMS Workspace、AIRegistry Namespace 和当前网络策略。 |
| GetWorkspaceAcrRamAuthorizeUrl | 获取 ACR 授权链接 | 查询工作空间 ACR RAM 授权地址。 |
| GetWorkspaceAgenticFsMountRamAuthorizeUrl | 获取 AFS 权限 URL | 查询工作空间 AgenticFS 挂载 RAM 授权地址 |
| GetWorkspacePlugin | 查询工作空间插件 | 查询指定工作空间的插件状态。 |
| InstallMcpMarketItem | 安装 MCP 市场模板 | 安装 MCP 市场模板 |
| InstallWorkspacePlugin | 安装工作空间插件 | 为指定的 AgentCore 工作空间安装插件。当前支持 collaboration 插件,安装过程异步执行。 |
| ListAgentCodeRuntimes | 查询智能体代码运行环境 | 查询代码部署支持的运行环境 |
| ListAgentIMChannels | 查询智能体 IM 渠道列表 | 查询指定智能体的 IM 渠道列表。 |
| ListAgentSpecs | 查询 AgentSpec 列表 | 分页查询指定工作空间中的 AgentSpec,支持名称搜索、排序以及按所有者、可见范围和业务标签筛选。 |
| ListAgentTeams | 查询智能体团队列表 | 查询指定智能体所属的团队列表。通过 agentIds 指定需要查询的智能体 ID,返回每个智能体与团队的成员关系信息,包括团队 ID、团队名称和智能体在团队中承担的角色。 |
| ListConnectorModels | 查询 Connector 模型列表 | 查询已启用 QoderCLI Connector 可用的官方模型和企业模型。服务使用已保存的 API Key 和组织 ID 实时获取模型,并按模型 ID 去重。 |
| ListConnectors | 查询 Connector 列表 | 查询指定工作空间支持的 Connector 列表及其状态、已绑定 Agent 数量和配置。当前版本返回 QoderCLI Connector。 |
| ListCredentials | 查询凭证列表 | 分页查询指定工作空间内的凭证。通过 credentialType 按类型过滤,通过 nameLike 按凭证名称模糊过滤,通过 maxResults 指定单页最大记录数,通过 nextToken 获取下一页。未指定 maxResults 时服务端默认返回 10 条。 |
| ListCustomAgents | 查询自定义智能体列表 | 分页查询指定工作空间中的自定义智能体摘要。完整配置及最新版本的执行结果请通过 GetCustomAgent 查询。 |
| ListExternalAgents | 查询外部智能体列表 | 查询指定工作空间下的外部智能体列表。 |
| ListIdentityProviderDepartments | 查询身份源部门列表 | 分页查询身份源部门 |
| ListIdentityProviders | 查询外部身份提供商列表 | 查询工作空间已有的身份源绑定摘要,包括 CustomSSO。返回本地绑定信息,不回查上游 SAML 或 SCIM 实际配置。 |
| ListIdentityProviderSCIMCredentials | 查询 SCIM 凭据列表 | 查询共享用户池中最多两枚 SCIM 凭据的完整摘要列表,不返回 Token 明文,不提供分页。 |
| ListImageCaches | 查询镜像缓存列表 | 查询镜像缓存列表 |
| ListManagedAgents | 查询托管智能体列表 | 查询指定工作空间下的托管智能体列表。 |
| ListMcpMarketItems | 查询 MCP 市场模板列表 | 查询 MCP 市场模板 |
| ListMcps | 查询 MCP 服务列表 | 分页查询指定工作空间中的 MCP 服务及其配置和状态。 |
| ListMcpTools | 查询 MCP 工具列表 | 查询指定 MCP 服务公开的工具列表及其输入输出 Schema。 |
| ListMemories | 查询长期记忆列表 | 分页查询长期记忆,可独立按 UserId、AgentId 和 SessionId 过滤; |
| ListMemorySessionMessages | 查询记忆 Session 消息列表 | 按精确 Scope 分页查询原始消息。SessionId 必填,UserId 和 AgentId 至少提供一个。 |
| ListMemorySessions | 查询记忆 Session 列表 | 分页查询 MemoryStore 中的 Session,可独立按 UserId 和 AgentId 过滤。 |
| ListMemoryStores | 查询 MemoryStore 列表 | 分页查询指定工作空间中的 MemoryStore。 |
| ListModelConnections | 查询模型连接列表 | 分页查询指定工作空间中的模型连接,支持按名称、供应商类型和调用协议筛选。 |
| ListModels | 查询模型列表 | 分页查询指定工作空间中的模型,支持按模型连接和模型名称筛选。 |
| ListPermissionRules | 查询权限规则列表 | 查询权限规则。 |
| ListPredefinedModelProviders | 查询预定义模型供应商目录 | 查询 AgentCore 内置模型目录支持的供应商及其默认服务配置。 |
| ListPredefinedModels | 查询供应商预定义模型目录 | 查询指定供应商在 AgentCore 内置模型目录中的模型及其能力信息。 |
| ListSandboxes | 查询 Sandbox 列表 | 查询指定工作空间中托管智能体的 Sandbox 列表,支持按 Sandbox ID 和当前有效 Session ID 的片段组合筛选。 |
| ListSandboxSessions | 查询 Sandbox 活动会话列表 | 分页查询指定托管智能体的 Sandbox 中的活动 Session 列表,并返回会话来源及外部渠道类型。 |
| ListServiceEndpoints | 查询服务端点列表 | 分页查询指定工作空间内的服务端点,支持按目标类型、智能体、协作组件和状态过滤。 |
| ListSkillReferences | 查询Skill引用数据 | 查询 Skill 引用关系 |
| ListSkills | 查询 Skill 列表 | 分页查询指定工作空间中的 Skill,返回 Skill 基础信息、版本状态和分页信息。 |
| ListTeams | 查询团队列表 | 分页查询指定工作空间内的团队。通过 nameLike 按团队名称模糊过滤,通过 maxResults 指定单页最大记录数,通过 nextToken 获取下一页。未指定 maxResults 时服务端默认返回 10 条。列表中的成员信息只包含成员标识、名称和团队角色。 |
| ListUsers | 查询用户列表 | 分页查询指定工作空间内的用户。通过 nameLike 按用户名称模糊过滤,通过 maxResults 指定单页最大记录数,通过 nextToken 获取下一页。未指定 maxResults 时服务端默认返回 10 条。 |
| ListWorkspaces | 查询工作空间列表 | 分页查询当前租户下的工作空间。列表默认不返回状态为 Deleted 的软删除记录,结果按创建顺序由服务端稳定排序。 |
| OfflineSkill | 下线 Skill | 将指定 Skill 的在线版本下线,使其不再作为在线版本使用。 |
| OnlineSkill | 上线 Skill | 将指定 Skill 版本设置为在线版本。 |
| PrecheckSkillUploadViaOss | 预检查 Skill 上传 | 解析并检查已上传到 OSS 的一个或多个 Skill ZIP 包,返回名称、版本和冲突检查结果。 |
| PrepareIdentityProviderSCIM | 准备 SCIM 接收配置和凭据 | 准备 SCIM 接收配置,返回预配 URL 和凭据摘要;没有可用凭据时签发 Token,仅本次返回明文,不自动开启 AC 用户同步。 |
| PublishSkillVersion | 发布 Skill 版本 | 发布指定的 Skill 版本,使其进入已发布状态。 |
| RedraftSkillVersion | 重新编辑 Skill 版本 | 将指定 Skill 版本重新转为可编辑草稿,以便继续修改。 |
| ResetUserPassword | 重置用户密码 | 重置指定用户的登录密码。通过 agentCoreUserId 或 username 指定用户,两者至少指定一个。仅支持重置使用工作空间本地密码认证的用户;不指定 password 时由服务端生成随机密码并在响应中返回。 |
| RetryImageCache | 重试镜像缓存 | 重试镜像缓存 |
| SearchMemories | 检索长期记忆 | 根据语义查询检索 MemoryStore 中的长期记忆。 |
| SubmitAgentSpecVersion | 提交 AgentSpec 版本审核 | 提交指定 AgentSpec 草稿版本进入审核流程。未配置发布流水线时,版本将直接发布为在线状态。 |
| SubmitSkillVersion | 提交 Skill 版本审核 | 提交指定的 Skill 草稿版本进入审核流程。 |
| UpdateAccessApplication | 更新访问应用 | 更新接入应用。 |
| UpdateAgentIMChannel | 更新智能体 IM 渠道 | 更新 IM 渠道绑定的 ServiceEndpoint、启停状态或渠道行为配置。至少需要提供一个可更新字段。 |
| UpdateAgentIMChannelCredential | 更新智能体 IM 渠道凭据 | 全量更新指定 IM 渠道的渠道凭据。Secret 不会在响应中回显。 |
| UpdateAgentSpec | 更新 AgentSpec 元数据 | 更新指定 AgentSpec 的业务标签、版本标签和可见范围;未传入的字段保持不变。 |
| UpdateConnector | 更新 Connector | 更新已启用 QoderCLI Connector 的 API Key 或 Service Account Key 集合。提交 serviceAccountKeys 时,服务将其作为更新后的完整密钥集合执行新增、重命名、轮换和删除。 |
| UpdateCredential | 更新凭证 | 更新指定凭证的凭证内容或描述。credentialMetadata 和 description 至少指定一个,未指定的属性保持不变。凭证名称和凭证类型创建后不可修改。 |
| UpdateCustomAgent | 更新自定义智能体 | 更新指定工作空间中的自定义智能体配置,并异步执行更新。省略的顶层字段保留原配置,可通过 GetCustomAgent 查询更新结果。 |
| UpdateExternalAgent | 更新外部智能体 | 更新指定外部智能体的配置。 |
| UpdateIdentityProvider | 更新外部身份提供商 | 修改指定工作空间已绑定身份源的登录配置。DingTalk、Feishu 支持登录开关、增量同步开关、应用配置和同步范围;CustomSSO 支持 SAML 配置和登录开关。实际更新异步生效,请通过 GetIdentityProvider 查询状态。 |
| UpdateIdentityProviderSCIM | 确认或关闭 SCIM 同步 | 独立启用或关闭 SCIM 用户同步。开启时异步执行首次全量导入,结果通过 GetIdentityProviderSCIM 查询,保留 SAML 登录配置。 |
| UpdateManagedAgent | 更新托管智能体 | 更新指定托管智能体的配置。 |
| UpdateMcp | 更新 MCP 服务 | 更新指定 MCP 服务的地址、描述、认证或 Swagger 配置。MCP 类型和协议在创建后不可修改。更新为异步过程。 |
| UpdateMcpTemplateConfig | 更新模板托管 MCP 的配置参数 | 按模板更新 MCP 参数 |
| UpdateMemory | 更新长期记忆 | 根据 Memory ID 更新长期记忆文本或元数据。 |
| UpdateMemoryStore | 更新 MemoryStore | 更新记忆库。 |
| UpdateModel | 更新模型 | 更新指定模型的描述、上下文 Token 上限、最大输出 Token 数或能力配置。 |
| UpdateModelConnection | 更新模型连接 | 更新指定模型连接的可变配置并重新提交发布任务;调用协议创建后不可修改。 |
| UpdateSkillBizTags | 更新 Skill 业务标签 | 更新指定 Skill 的业务标签;未传入的其他属性保持不变。 |
| UpdateSkillLabels | 更新 Skill 版本标签 | 更新指定 Skill 的版本标签及其指向关系。 |
| UpdateSkillScope | 更新 Skill 可见范围 | 更新指定 Skill 的可见范围。 |
| UpdateTeam | 更新团队 | 更新指定团队的描述和成员。传入 users 或 agents 时按全量覆盖语义替换对应的成员列表,未传入的成员列表保持不变。团队名称创建后不可修改。 |
| UpdateUser | 更新用户 | 更新指定用户的显示名称、邮箱或备注。displayName、email 和 note 至少指定一个,未指定的属性保持不变。用户名称创建后不可修改。 |
| UpdateWorkspace | 更新工作空间 | 更新工作空间名称或网络配置。只有状态为 Initialized 的工作空间允许更新。Status、TenantId 和 RegionId 由服务端维护,不允许通过本接口修改。 |
| UploadAgentSpecViaOss | 通过 OSS 上传 AgentSpec | 从 OSS 获取已上传的 AgentSpec ZIP 包,解析后将 AgentSpec 导入当前工作空间。 |
| UploadSkillViaOss | 通过 OSS 上传 Skill | 从 OSS 获取已上传的 Skill ZIP 包,解析后将 Skill 导入当前工作空间。 |
| ValidateAgentCodePackageFromOss | 校验智能体 OSS 代码包来源 | 校验智能体 OSS 代码包来源 |
| VerifyAgentCodePackageOssRamAuthorization | 检查智能体代码包 OSS 授权状态 | 检查智能体代码包 OSS RAM 授权状态 |
| VerifyConnector | 验证 Connector 凭证 | 验证一个或多个 Qoder Service Account Key 在指定站点是否可用。该操作不保存密钥,也不修改 Connector 状态。 |
| VerifyWorkspaceAcrRamAuthorization | 校验 ACR 授权结果 | 验证工作空间 ACR RAM 授权 |
| VerifyWorkspaceAgenticFsMountRamAuthorization | 查询 AFS 授权状态 | 查询工作空间 AgenticFS 挂载 RAM 授权状态 |
| VerifyWorkspaceOssMountRamAuthorization | 验证工作空间 OSS 挂载 RAM 授权 | 验证工作空间访问 OSS Bucket 的 RAM 授权,返回当前授权状态。传入 bucketName 时校验智能体挂载 Bucket 的授权;不传时校验并更新工作空间私有 OSS 存储的授权状态。 |
该文章对您有帮助吗?