本文档介绍如何通过 API 在代码中构建、配置并接入 Claw 模式应用——将创建空间、创建应用、配置 Agent、发布、对话、获取产出的完整流程集成到自有系统中，无需依赖控制台的可视化操作。

平台提供两种接入方式，可按需选择或组合使用：

接入方式	说明	适用场景
控制台可视化	在控制台中通过界面搭建、配置与调试智能体应用	快速验证、非开发人员配置
API 接入	以代码方式完成全流程，并嵌入自有系统	自动化、批量管理、集成到已有产品

本文档聚焦 API 接入。若希望快速跑通，可直接查阅从零搭建一个 Claw 模式应用。

模式介绍

本文档所述的 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 创建、配置、发布应用的人	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 版本与端点

接入方式	接口请求域名	密钥获取
独立站	`capi.adp.tencent.com`	ADP 控制台 > 密钥管理

独立站

API 版本：2026-05-20
接口请求域名：capi.adp.tencent.com
鉴权方式：腾讯云 V3 签名（SecretId / SecretKey）；对话流接口使用应用 AppKey 鉴权
密钥获取：ADP 控制台 > 密钥管理
对话端点（SSE）：https://adp.tencent.com/adp/v2/chat