本文档介绍如何通过 API 在代码中构建、配置并接入 Claw 模式应用——将创建空间、创建应用、配置 Agent、发布、对话、获取产出的完整流程集成到自有系统中，无需依赖控制台的可视化操作。
平台提供两种接入方式，可按需选择或组合使用：
接入方式 | 说明 | 适用场景 |
控制台可视化 | 在控制台中通过界面搭建、配置与调试智能体应用 | 快速验证、非开发人员配置 |
API 接入 | 以代码方式完成全流程，并嵌入自有系统 | 自动化、批量管理、集成到已有产品 |
模式介绍
本文档所述的 API 接入基于 Claw 模式，具备以下核心能力：
沙箱工作空间：每个会话绑定独立沙箱，Agent 可执行代码、生成文件。
用户级 Agent：为每个用户复刻独立的 Agent 实例，配置互不干扰。
动态能力切换：运行时可动态更换模型、安装和卸载 Skill、绑定工具，无需重新发布。
多 Agent 协作：主 Agent 可调度子 Agent 协同完成复杂任务。
核心概念
通过 API 会接触到以下核心对象：
概念 | 说明 |
空间（Space） | 一个工作空间代表一个独立的工作区域，空间成员可以共享其内部的数据资源，不同工作空间之间数据隔离。 |
应用（Application） | 一个可对外提供服务的智能体应用。 |
Agent | 应用内组成部分，承载指令、模型、Skill、工具等具体能力配置。 |
对话（Conversation） | 用户与应用交互的会话实例，同一会话内多轮对话共享上下文与工作空间。 |
Agent 的能力可通过以下资源扩展，且支持动态加载（均为可选）：
概念 | 说明 |
模型（Model） | Agent 使用的推理大模型，决定其语言理解与生成能力。 |
Skill | 平台内置或自定义的技能模块（如代码执行、文件处理、联网搜索等）。 |
插件（Plugin） | 一组相关工具的集合，代表一个外部服务的接入（如"天气服务"插件），需在平台注册并配置认证方式。 |
工具（Tool） | 插件下的具体可调用能力（如"查询天气"工具），每个工具有明确的输入/输出参数定义。 |
连接器（Connector） | 连接外部数据源或服务的桥梁。 |
变量（Variable） | 运行时透传给 Agent 的自定义上下文信息。 |
说明：
Plugin 与 Tool 的关系：ADP 采用「平台注册 Plugin → 显式绑定 Tool 到 Agent」的模式。一个 Plugin 代表一个外部服务，包含一个或多个 Tool；Agent 需要显式声明使用哪些 Plugin 及其下的哪些 Tool，并可对每个 Tool 的参数、认证方式做精细控制。
开发者与使用者
API 接入涉及两种角色：
角色 | 说明 | 鉴权方式 |
开发者（Developer） | 调用 API 创建、配置、发布应用的人 | 腾讯云 SecretId / SecretKey（V3 签名）；独立站用户使用 ADP 密钥管理中的 SecretId / SecretKey。 |
使用者（User） | 最终与 Agent 对话的终端用户 | 应用 AppKey + UserId 标识。 |
开发者通过管理类接口（
CreateApp、ModifyAgent、CreateRelease 等）构建和发布应用；使用者通过对话类接口（CreateConversation、/adp/v2/chat）与应用交互。两者的权限和操作范围完全隔离。应用与 Agent 的关系
一个应用可以包含一个主 Agent，每个主 Agent 下可以挂载多个子 Agent:
主 Agent：直接挂载在应用下，是用户对话的入口
子 Agent：挂载在主 Agent 下，可被主 Agent 调度协作
应用级配置（开场白、记忆、联网搜索等）对所有 Agent 通用；Agent 级配置（指令、模型、Skill、工具）则各自独立。
应用与发布的关系
应用的配置修改不会立即对外生效，必须通过显式发布才能让用户访问到最新版本。这种设计保证了：
配置安全：避免未经验证的改动直接影响线上用户。
版本管理：每次发布生成一个版本快照，可追溯。
开发完整链路
从开发到使用，完整链路如下：
说明：
一个应用可包含多个主 Agent（每个主 Agent 下可再挂多个子 Agent），在步骤 ③ 中定义，并随应用一起发布。
适用场景
需要文件处理、代码执行、产出物管理的复杂智能体。
需要调用外部工具 / API 的任务型智能体。
需要结合企业专属数据（知识库 / RAG）的智能问答。
需要嵌入到已有产品（Web / 小程序 / App）的对话能力。
API 版本与端点
接入方式 | 接口请求域名 | 密钥获取 |
腾讯云 | adp.tencentcloudapi.com | |
独立站 | capi.adp.tencent.com |
腾讯云
API 版本：2026-05-20
接口请求域名：
adp.tencentcloudapi.com鉴权方式：腾讯云 V3 签名（
SecretId / SecretKey）；对话流接口使用应用 AppKey 鉴权密钥获取：腾讯云 CAM 控制台
对话端点（SSE）：
https://wss.lke.cloud.tencent.com/adp/v2/chat独立站
API 版本：2026-05-20
接口请求域名：
capi.adp.tencent.com鉴权方式：腾讯云 V3 签名（
SecretId / SecretKey）；对话流接口使用应用 AppKey 鉴权密钥获取：ADP 控制台 > 密钥管理
对话端点（SSE）：
https://adp.tencent.com/adp/v2/chat
