二、1. 核心概念
下表列出了 ADP CLI 与配套技能体系的核心概念：
| 概念 | 说明 |
| @tencentcloudadp/cli | 腾讯云智能体开发平台命令行工具（命令名为 adp），支持管理应用全生命周期、知识库、工作流、Skills、插件、记忆库、云盘与运营数据。 |
| 配套 AI Skill | 随 CLI 软件包内置的 AI 编程助手技能（通过 adp skills install 安装至本地 IDE），教会 AI 助手理解 ADP 架构约束、草稿/发布隔离规则并自动调用 adp 命令。 |
| 平台技能（Platform Skills） | 上传并托管在腾讯云 ADP 空间技能中心（通过 adp skill 管理）的技能包，供云端 Claw 模式智能体或智能工作台在运行时调用。 |
| adp.jsonc 与 instructions.md | 本地声明式工程配置文件与智能体系统提示词文件，支持纳入 Git 版本管理，并通过 adp.env.<环境名>.jsonc 实现多环境配置覆盖。 |
| 草稿态与发布态 | 日常修改（adp dev）仅更新云端开发草稿，不影响线上服务；执行 adp deploy 才会生成不可变版本快照并对外生效。 |
三、2. 5分钟快速体验
# 1. 全局安装 ADP CLI（需 Node.js >= 20）npm install -g @tencentcloudadp/cli# 2. 将配套 AI Skill 一键安装到本机 AI 编程助手（Cursor / Claude Code / Codex / CodeBuddy 等）adp skills install –yes# 3. 打开本机网页安全填入密钥完成登录（支持腾讯云公有云与 ADP 独立站）adp auth login –web –open# 4. 验证登录状态并查看可访问的工作空间adp whoami# 5. 初始化智能体工程、同步草稿并预览发布adp init my-assistant –space-id <space-id> –model-id <model-id> –app-mode 2 –create-remoteadp devadp deploy –dry-run
五、步骤1：安装 ADP CLI 工具
请确保本机已安装 Node.js 20 及以上版本，选择以下任一包管理器全局安装 @tencentcloudadp/cli：
六、使用 npm 安装（推荐）
npm install -g @tencentcloudadp/cli# 验证安装版本adp –version
七、使用 pnpm 或 yarn 安装
# 使用 pnpmpnpm add -g @tencentcloudadp/cli# 或使用 yarnyarn global add @tencentcloudadp/cli# 检查本机版本与远端最新版本对比adp version
注意：说明：
注意：如果你使用的是 WorkBuddy 客户端，可直接前往 WorkBuddy 连接器管理面板搜索并连接腾讯云 ADP 连接器，系统会自动在后台安装 CLI 与配套 Skill，详情请参见 通过 WorkBuddy 连接腾讯云 ADP。
八、步骤2：安装配套 AI Skill 到编程助手
adp 软件包内置了专为 AI 编程助手设计的领域技能包（skills/adp/SKILL.md 及分场景参考手册）。安装后，你的 AI 编程助手将自动掌握 ADP 的配置规范、先读后写原则与草稿保护契约。
九、1. 查看本机检测到的 AI 编程助手与安装状态
adp skills
十、2. 一键全局安装（推荐）
自动将配套 Skill 安装到本机已检测到的所有 AI 编程助手全局目录中：
# 执行全局安装adp skills install –yes
十一、3. 按项目级安装或指定特定 AI 助手安装
# 仅安装到当前代码仓库目录（供团队随 Git 共享）adp skills install –scope project –agent cursor,claude –yes# 仅针对指定 AI 助手全局安装（支持 claude, cursor, codex, agents, codebuddy, workbuddy）adp skills install –agent cursor,claude,codebuddy –yes
下表列出了各 AI 编程助手对应的 Skill 安装路径：
| AI 编程助手 | –agent 标识 | 全局安装路径（–scope global） | 项目级安装路径（–scope project） |
| Cursor | cursor | ~/.cursor/skills/adp | .cursor/skills/adp |
| Claude Code | claude | ~/.claude/skills/adp | .claude/skills/adp |
| OpenAI Codex | codex | ~/.codex/skills/adp | .codex/skills/adp |
| CodeBuddy | codebuddy | ~/.codebuddy/skills/adp | .codebuddy/skills/adp |
| WorkBuddy | workbuddy | ~/.workbuddy/skills/adp | .workbuddy/skills/adp |
| 通用 Agents 标准 | agents | ~/.agents/skills/adp | .agents/skills/adp |
十二、步骤3：配置账号鉴权（支持公有云与独立站）
在开始操作前，请先准备对应站点的 SecretId 与 SecretKey：
·腾讯云公有云：前往 腾讯云 CAM API 密钥管理控制台 获取（SecretId 以 AKID 开头）。
·ADP 独立站：前往 ADP 独立站密钥管理（企业管理 > 密钥管理 > 新建 API 密钥）获取。
十三、方式一：本机浏览器网页登录（推荐，密钥不进终端历史与聊天记录）
# 启动本机 127.0.0.1 临时授权网页并自动打开浏览器，校验通过后自动保存至 ~/.adp/profiles/adp auth login –web –open
十四、方式二：环境变量登录（适合终端与 CI/CD 流水线）
export TENCENTCLOUD_SECRET_ID="AKID…"export TENCENTCLOUD_SECRET_KEY="…"# 保存为默认公有云配置adp auth login# 或保存为命名的独立站配置adp auth login –profile indie –site independent
十五、验证登录状态与切换多账号配置
# 查看当前生效的 Profile、站点域名与凭证来源adp auth status# 查看当前账号可访问的工作空间列表adp whoami# 列出已保存的所有账号配置并切换默认配置adp auth listadp auth switch indie
十六、步骤4：智能体开发流程
完成 CLI 与 Skill 安装及鉴权后，你可以任选在 AI 编程助手中用自然语言交互，或在终端直接运行命令来开发智能体应用。
十七、在 AI 编程助手中通过 Skill 自然语言开发
打开 Cursor、Claude Code 或 CodeBuddy 对话框，直接输入自然语言指令，AI 会自动加载 adp 技能并为你执行底层命令：
1. 盘点环境：输入 “帮我看看当前 ADP 账号下有哪些工作空间和可用大模型”（AI 自动调用 adp auth status、adp space list、adp models）。
2. 创建应用草稿：输入 “在默认空间创建一个名为 order-helper 的 Multi-Agent 模式客服应用，编写售后退换货系统提示词，先同步到云端草稿，不要发布”（AI 自动调用 adp init –create-remote 生成 adp.jsonc 与 instructions.md，并通过 adp dev 同步草稿）。
3. 导入知识库与召回测试：输入 “把当前目录下的 ./faq.md 导入到应用知识库，解析完成后帮我测试召回‘怎么办理退货’”（AI 自动调用 adp kb doc import 与 adp kb search）。
4. 预览并发布上线：输入 “预览一下发布变更，确认无误后帮我正式发布上线，并用 adp chat 测试一轮对话”（AI 先执行 adp deploy –dry-run 供你确认，确认后执行 adp deploy 与 adp chat）。
十八、在终端中执行声明式工程开发
# 1. 查询工作空间与可用模型adp space list –fields spaceId,nameadp models –fields modelId,name –limit 10# 2. 初始化本地项目并在云端创建应用草稿mkdir order-helper && cd order-helperadp init order-helper –space-id <space-id> –model-id <model-id> –app-mode 2 –create-remote# 3. 开启文件监听，修改 instructions.md 或 adp.jsonc 时自动热同步至云端草稿adp dev –watch# 4. 导入本地知识库文档并测试检索召回adp kb doc import –file ./faq.mdadp kb search –question "怎么办理退货？"# 5. 预览待发布差异，确认无误后正式发布上线adp deploy –dry-runadp deploy –message "v1.0.0 初始发布" –yes# 6. 与已发布应用进行流式对话测试，并实时查看问答日志adp chat –message "你好，请问商品破损怎么退换？"adp tail
十九、三、全局参数说明
所有 adp 命令均支持以下全局参数：
| 全局参数 | 类型 | 说明 | 示例 |
| –config <path> | string | 指定项目配置文件路径（默认读取当前目录的 adp.jsonc）。 | adp dev –config ./adp.jsonc |
| –cwd <path> | string | 指定命令执行的工作目录。 | adp deploy –cwd ./apps/bot |
| –env <name> | string | 指定环境覆盖配置名称（自动加载 adp.env.<name>.jsonc）。 | adp deploy –env prod |
| –profile <name> | string | 指定本次调用使用的本地账号配置名称（覆盖默认激活的 Profile）。 | adp space list –profile indie |
| –region <name> | string | 指定腾讯云 API 地域（默认 ap-guangzhou）。 | adp app list –region ap-guangzhou |
| –format <fmt> | enum | 指定输出格式：auto（默认，终端为表格、管道/AI 为 JSON）、json 或 text。 | adp app list –format json |
| –json | boolean | –format json 的简写别名，强制输出标准 JSON 信封。 | adp whoami –json |
| –fields <f1,f2> | string | 仅保留返回结果中的指定字段（适用于所有 list 和 get 命令）。 | adp app list –fields appId,name |
| –limit <num> | number | 列表命令返回的最大条数上限（默认50条，CLI 自动翻页拉取）。 | adp models –limit 20 |
| –page <n> | number | 拉取单页数据并关闭自动翻页（从 0 开始计数，–page 0 为第1页，单页最多100条）。 | adp app list –page 0 –limit 20 |
| –dry-run | boolean | 预览写操作的影响与参数校验结果，不实际修改云端资源。 | adp deploy –dry-run |
| –yes, -y | boolean | 自动确认删除、发布、覆盖等需要二次确认的操作。 | adp deploy –yes |
| –quiet, -q | boolean | 静默模式，隐藏非必要的进度提示信息。 | adp dev –quiet |
| –verbose | boolean | 在标准错误流（stderr）输出详细的底层错误诊断信息。 | adp deploy –verbose |
| –version | boolean | 打印本机安装的 adp 版本号（离线执行，无需联网）。 | adp –version |
20、四、全量 CLI 命令
本章按业务模块将 ADP CLI 的全部命令逐条平铺展开，包含完整命令语法、功能说明与调用示例。
21、4.1 账号鉴权与配置管理
| 命令 | 说明 | 示例 |
| adp login | 登录并保存凭证至当前激活的 Profile（adp auth login 的快捷别名）。 | adp login –web –open |
| adp whoami | 查看当前生效的脱敏 SecretId、凭证来源及可访问的工作空间列表。 | adp whoami –format json |
| adp logout | 删除本机存储的1个 Profile（存在多个时在终端交互选择）。 | adp logout –yes |
| adp auth login | 创建或更新1个包含密钥与站点地址的 Profile（保存在 ~/.adp/profiles）。 | adp auth login –profile indie –site independent |
| adp auth list | 列出本机已保存的全部 Profile，并标记当前激活项。 | adp auth list |
| adp auth switch <name> | 将指定的已保存 Profile 切换为当前默认激活状态。 | adp auth switch prod |
| adp auth status | 查看当前生效的 Profile 名称、站点域名、脱敏密钥及凭证实际来源。 | adp auth status –format json |
| adp auth logout | 删除指定或全部已保存的 Profile。 | adp auth logout –profile old –yes |
22、4.2 项目工程与发布生命周期
| 命令 | 说明 | 示例 |
| adp init [name] | 在本地生成声明式工程文件 adp.jsonc 与 instructions.md，可选同步在云端创建应用。 | adp init my-bot –space-id <id> –app-mode 2 –create-remote |
| adp dev | 将本地配置与提示词同步至云端开发草稿；加 –watch 可监听文件变动实时同步。 | adp dev –watch |
| adp deploy | 将当前修改同步至草稿并创建正式线上发布任务，等待发布完成（支持 –dry-run 预览）。 | adp deploy –message "v1.0.0" –yes |
| adp release preview | 预览下次发布将变更的配置项、同义词，或通过 –scope 查看发布后影响的调用范围。 | adp release preview –scope –app-id <id> |
| adp release retry | 对状态为失败的发布记录重新发起发布。 | adp release retry –release-id <id> –app-id <id> –yes |
| adp versions | 查看应用的历史发布版本列表、发布状态与版本说明。 | adp versions –app-id <id> |
| adp rollback | 将指定的历史发布版本还原至开发草稿并重新发布上线（加 –draft-only 仅还原至草稿）。 | adp rollback –release-id <id> –yes |
| adp delete | 删除当前工程绑定（或 –app-id 指定）的云端应用。 | adp delete –app-id <id> –yes |
23、4.3 工作空间、企业工作台与沙箱管理
| 命令 | 说明 | 示例 |
| adp space list | 列出当前账号可访问的所有工作空间。 | adp space list |
| adp space create | 创建新的工作空间。 | adp space create –name "研发空间" –description "AI 研发" |
| adp space update | 修改工作空间的名称或描述。 | adp space update –space-id <id> –name "新空间名" |
| adp space delete | 删除指定的工作空间。 | adp space delete –space-id <id> –yes |
| adp corp assistant get | 查看指定工作空间下智能工作台的设置（长期记忆开关、全局指令、默认模型）。 | adp corp assistant get –space-id <id> |
| adp corp assistant set | 修改指定工作空间下所有成员的智能工作台全局设置。 | adp corp assistant set –space-id <id> –long-memory –yes |
| adp portal get | 查看企业门户状态与子域名信息。 | adp portal get |
| adp account list | 列出企业或空间下的成员列表（账号 UIN 与昵称，需管理员权限）。 | adp account list –space-id <id> |
| adp workspace credential | 获取会话独立沙箱工作区的存储访问凭证（默认打码，加 –reveal 显示明文）。 | adp workspace credential –workspace-id <id> –reveal |
| adp workspace download-url | 获取会话沙箱工作区内指定产出文件的预签名下载链接。 | adp workspace download-url –workspace-id <id> –path report.pdf –reveal |
24、4.4 应用管理、模板、导入导出与密钥
| 命令 | 说明 | 示例 |
| adp app list | 列出指定空间下的应用列表（加 –all-spaces 可跨所有空间查询）。 | adp app list –all-spaces |
| adp app get | 查看指定应用的完整配置详情。 | adp app get –app-id <id> |
| adp app create | 在指定工作空间内创建新应用。 | adp app create –space-id <id> –name "客服助手" –app-mode 2 |
| adp app update | 修改应用的名称、描述或配置项。 | adp app update –app-id <id> –name "新名称" |
| adp app delete | 删除指定的应用。 | adp app delete –app-id <id> –yes |
| adp app copy | 将应用的草稿配置、智能体与知识库设置复制到目标空间（生成 <原名>的副本）。 | adp app copy –app-id <id> –target-space-id <space> –yes |
| adp app check | 检查应用草稿是否存在阻塞正式发布的配置问题（智能体、知识库、工作流）。 | adp app check –app-id <id> |
| adp app debug-config get | 查看应用的调试模式开关状态与调试自定义变量。 | adp app debug-config get –app-id <id> |
| adp app debug-config set | 设置应用的调试模式（0 为关闭）。 | adp app debug-config set –app-id <id> –debug-mode 0 |
| adp app export | 将已发布应用导出为 ZIP 应用包（默认包含设置、工作流、连接器、知识库、智能体和技能）。 | adp app export –app-id <id> –output ./app.zip |
| adp app import | 将应用包 ZIP 文件导入至指定工作空间，创建为新的未发布应用。 | adp app import –space-id <id> –file ./app.zip |
| adp app package list | 列出应用的应用包导出任务记录（含状态、版本号、是否可重试）。 | adp app package list –app-id <id> |
| adp app package summary | 预览导出应用包将包含的组件清单（应用配置、知识库、工作流、智能体、插件、技能）。 | adp app package summary –app-id <id> |
| adp app package download | 根据导出任务 ID 下载应用包 ZIP 文件，或获取30分钟有效的下载链接。 | adp app package download –app-id <id> –task-id <tid> –output ./app.zip |
| adp app package retry | 重试失败的应用包导出任务。 | adp app package retry –app-id <id> –task-id <tid> |
| adp app package delete | 删除应用包导出任务记录（不影响应用本身）。 | adp app package delete –app-id <id> –task-id <tid> –yes |
| adp app template categories | 列出应用模板广场的分类标识列表。 | adp app template categories |
| adp app template list | 搜索和浏览应用模板广场中的模板或案例。 | adp app template list –query "客服" |
| adp app template get | 查看单个模板的详情（包含的智能体、模型、插件、工作流、知识库与开发者说明）。 | adp app template get –template-id <id> |
| adp app template use | 基于指定模板在工作空间内创建1个新的未发布应用。 | adp app template use –template-id <id> –name "我的助手" |
| adp app key get | 查看应用当前生效的 AppKey（默认打码，加 –reveal 显示完整明文）。 | adp app key get –app-id <id> –reveal |
| adp app key list | 列出应用下的全部 AppKey（每个应用最多创建2个）。 | adp app key list –app-id <id> |
| adp app key create | 为应用新建1个额外的 AppKey。 | adp app key create –app-id <id> –reveal |
| adp app key enable | 启用指定的 AppKey。 | adp app key enable –key <后4位或完整 key> |
| adp app key disable | 停用指定的 AppKey（应用必须至少保留1个启用状态的密钥）。 | adp app key disable –key <后4位或完整 key> |
| adp app key delete | 删除指定的 AppKey（需至少保留1个启用密钥）。 | adp app key delete –key <后4位或完整 key> –yes |
| adp app key lookup | 根据完整的 AppKey 反查其所属的应用信息。 | printf %s "$KEY" | adp app key lookup –stdin |
| adp app token sse | 为应用签发临时的 HTTP SSE 对话通信令牌（加 –reveal 显示完整令牌）。 | adp app token sse –app-id <id> –reveal |
| adp app token ws | 为应用签发临时的 WebSocket 对话通信令牌。 | adp app token ws –app-id <id> –reveal |
| adp app share-url | 为已发布应用生成新的公开网页体验链接（旧链接随之失效）。 | adp app share-url –app-id <id> –yes |
| adp app shared list | 浏览空间内的企业共享应用目录。 | adp app shared list –space-id <id> |
| adp app shared tags | 列出企业共享应用目录的分类标签。 | adp app shared tags –space-id <id> |
| adp app a2a-url | 查看或刷新（–refresh）应用的 A2A 协议调用端点与智能体卡片信息。 | adp app a2a-url –app-id <id> –reveal |
| adp var list | 列出应用下的参数变量（支持环境参数、应用参数、系统参数）。 | adp var list –app-id <id> |
| adp var get | 查看单个参数变量的详情。 | adp var get –app-id <id> –variable-id <id> |
| adp var put | 在应用下创建新的参数变量。 | adp var put –app-id <id> –name "API_ENV" –value "prod" |
| adp var update | 更新已有参数变量的值。 | adp var update –app-id <id> –variable-id <id> –value "staging" |
| adp var delete | 删除指定的参数变量。 | adp var delete –app-id <id> –variable-id <id> –yes |
25、4.5 智能体编排与大模型管理
| 命令 | 说明 | 示例 |
| adp agent list | 列出应用下的全部智能体（含 role 0 主智能体与 role 1 子智能体）。 | adp agent list –app-id <id> |
| adp agent get | 查看指定智能体的详细配置。 | adp agent get –app-id <id> –agent-id <id> |
| adp agent create | 在 Claw 模式应用下创建智能体（支持通过 –role 1 创建专职子智能体）。 | adp agent create –app-id <id> –role 1 –name "数据分析员" –description "处理表格计算" |
| adp agent update | 通过 adp.jsonc 或命令行参数更新智能体的名称、描述、提示词或模型。 | adp agent update –app-id <id> –agent-id <id> –model-id <mid> |
| adp agent delete | 删除指定的智能体。 | adp agent delete –app-id <id> –agent-id <id> –yes |
| adp agent tool bind | 将单个插件工具或工作流绑定至智能体草稿。 | adp agent tool bind –agent-id <id> –plugin-id <pid> –tool-id <tid> |
| adp agent tool unbind | 从智能体草稿中解绑指定的插件工具或工作流。 | adp agent tool unbind –agent-id <id> –plugin-id <pid> –tool-id <tid> |
| adp agent resources | 列出智能体已绑定的工具、插件或技能清单（支持区分 test 与 prod 环境）。 | adp agent resources –agent-id <id> –type tools |
| adp agent limits | 查看账号级的智能体配额上限（单智能体工具/技能数上限、Claw 智能体总数、最大推理轮数）。 | adp agent limits |
| adp agent changed | 列出应用下自指定时间以来发生过配置变更的智能体 ID。 | adp agent changed –app-id <id> –since 0 |
| adp models | 列出平台可用的大模型列表（支持按 –scene 场景过滤，如 18 为 Claw 模式模型）。 | adp models –scene 18 –limit 20 |
| adp models get | 查看指定大模型的完整模型卡片（上下文限制、能力特性、可调参数）。 | adp models get –model-id <id> |
| adp models developers | 列出平台接入的大模型提供商列表（如混元、DeepSeek 等）。 | adp models developers |
| adp models mappings | 查询已下线模型名称当前自动路由到的目标模型映射关系。 | adp models mappings –model <model-name> |
26、4.6 知识库、文档、问答与共享管理
| 命令 | 说明 | 示例 |
| adp kb list | 列出工作空间内的知识库列表。 | adp kb list –space-id <id> |
| adp kb get | 查看指定知识库（含应用默认知识库或共享知识库）的详情。 | adp kb get –kb-id <id> –space-id <sid> |
| adp kb create | 在工作空间内创建新的共享知识库（KbType=2）。 | adp kb create –name "产品手册库" –space-id <id> |
| adp kb update | 修改知识库的名称或描述。 | adp kb update –kb-id <id> –name "新知识库名" |
| adp kb delete | 删除指定的知识库。 | adp kb delete –kb-id <id> –yes |
| adp kb search | 在知识库中发起文档与问答对的检索召回测试，查看命中片段与相关性得分。 | adp kb search –kb-id <id> –question "退货流程是什么？" |
| adp kb doc import | 上传本地文件（Markdown、PDF、Word 等）至知识库并自动等待异步切分解析完成（公有云与独立站通用）。 | adp kb doc import –file ./faq.md |
| adp kb doc list | 列出知识库中的文档列表（支持 –query 按文件名过滤）。 | adp kb doc list –kb-id <id> |
| adp kb doc get | 查看单篇知识库文档的详情与异步解析状态（已删除文档返回 KbDocNotFound）。 | adp kb doc get –doc-id <did> –kb-id <kid> |
| adp kb doc retry | 对解析失败的知识库文档重新发起解析任务。 | adp kb doc retry –doc-id <did> –kb-id <kid> –wait |
| adp kb doc delete | 单条或批量删除知识库中的文档（支持重复 –doc-id 或逗号分隔，任一 ID 不存在则一条不删）。 | adp kb doc delete –doc-id <did1>,<did2> –kb-id <kid> –yes |
| adp kb doc referrers | 查询指定知识库文档被哪些工作流或其他组件引用。 | adp kb doc referrers –kb-id <kid> –doc-id <did> |
| adp kb file list | 列出知识库中的文档列表（与 kb doc list 同源，支持 –query 过滤）。 | adp kb file list –kb-id <id> |
| adp kb file get | 根据文档 ID（–doc-id）查看知识库中单篇文档的详情。 | adp kb file get –kb-id <kid> –doc-id <did> |
| adp kb file import | 通过平台文件管理服务的 FileId（–file-id，支持逗号分隔1 – 20个）批量导入文档至知识库。 | adp kb file import –kb-id <kid> –file-id <fid1>,<fid2> |
| adp kb file update | 根据文档 ID（–doc-id）单条或批量更新文档名称、分类或生效域（–effective-domain）。 | adp kb file update –kb-id <kid> –doc-id <did> –name "手册.pdf" |
| adp kb file delete | 根据文档 ID（–doc-id）批量删除知识库文档（每次1 – 20个数字 ID，任一不存在则一条不删）。 | adp kb file delete –kb-id <kid> –doc-id <did> –yes |
| adp kb qa list | 列出知识库中的问答对（QA）列表。 | adp kb qa list –kb-id <id> |
| adp kb qa get | 查看单条问答对的详情（标准问、相似问、答案、状态等）。 | adp kb qa get –kb-id <kid> –qa-id <qid> |
| adp kb qa create | 在知识库中创建新的问答对（新建后约15 – 30秒处于审核/学习态，达状态 8 导入完成后可编辑）。 | adp kb qa create –kb-id <kid> –question "客服电话" –answer "400-xxx" |
| adp kb qa update | 更新单条问答对内容或批量更新多条问答对的分类、生效域与采纳状态。 | adp kb qa update –kb-id <kid> –qa-id <qid> –answer "新答案" |
| adp kb qa delete | 批量删除知识库中的问答对（每次1 – 20个数字 ID，任一不存在则一条不删）。 | adp kb qa delete –kb-id <kid> –qa-id <qid> –yes |
| adp kb qa generate | 基于知识库中的文档（–doc-id）启动 AI 自动生成问答对任务。 | adp kb qa generate –kb-id <kid> –doc-id <did> |
| adp kb qa similar | 为指定问题自动生成多条相似问法。 | adp kb qa similar –kb-id <kid> –question "如何开发票" |
| adp kb qa export | 启动知识库问答对的异步导出任务。 | adp kb qa export –kb-id <kid> |
| adp kb qa conflict list | 列出知识库中存在语义冲突的问答对分组列表（默认 pending，支持 –status resolved|all）。 | adp kb qa conflict list –kb-id <kid> |
| adp kb qa conflict get | 根据冲突组 ID（–conflict-group-id）查看单个冲突问答分组的详细对比内容。 | adp kb qa conflict get –kb-id <kid> –conflict-group-id <cgid> |
| adp kb qa conflict resolve | 处理冲突问答组（–resolution：1 保留 / 2 忽略 / 3 删除，或 –ignore-all 忽略全部）。 | adp kb qa conflict resolve –kb-id <kid> –conflict-group-id <cgid> –resolution 2 –yes |
| adp kb category list | 列出知识库中文档（–category-type 1）或问答（–category-type 2）的分类目录树。 | adp kb category list –kb-id <kid> |
| adp kb category create | 创建新的知识库分类目录（支持 –parent-id 指定父分类）。 | adp kb category create –kb-id <kid> –name "售后政策" |
| adp kb category update | 重命名知识库分类目录。 | adp kb category update –kb-id <kid> –category-id <cid> –name "新分类名" |
| adp kb category delete | 删除指定的知识库分类目录。 | adp kb category delete –kb-id <kid> –category-id <cid> –yes |
| adp kb label list | 列出知识库的属性标签列表。 | adp kb label list –kb-id <kid> |
| adp kb label get | 查看单个知识库属性标签及其标签值详情。 | adp kb label get –kb-id <kid> –label-id <lid> |
| adp kb label create | 创建新的知识库属性标签及标签值（通过 –terms 传入逗号分隔的标签值）。 | adp kb label create –kb-id <kid> –name "适用部门" –terms "售后部,客服部" |
| adp kb label update | 修改知识库属性标签名称。 | adp kb label update –kb-id <kid> –label-id <lid> –name "部门" |
| adp kb label delete | 批量删除知识库属性标签（每次1 – 20个数字 ID，任一不存在则一条不删）。 | adp kb label delete –kb-id <kid> –label-id <lid> –yes |
| adp kb label check | 检查指定的标签值（–terms）是否已存在。 | adp kb label check –kb-id <kid> –label-id <lid> –terms "售后部" |
| adp kb share get | 查看知识库已共享到的目标空间及各空间内挂载该知识库的应用。 | adp kb share get –space-id <sid> –kb-id <kid> |
| adp kb share set | 设置知识库的跨空间共享范围（none 不共享 / all 全部空间 / spaces 指定空间）。 | adp kb share set –space-id <sid> –kb-id <kid> –scope all –yes |
| adp kb share approval | 查询知识库跨空间共享审批单的状态与详情。 | adp kb share approval –approval-id <aid> –kb-id <kid> |
| adp kb share inbound | 列出其他工作空间共享进入当前空间的知识库列表。 | adp kb share inbound –space-id <sid> |
| adp kb share check | 检查知识库是否已共享至指定的目标工作空间。 | adp kb share check –kb-id <kid> –target-space-id <tsid> |
27、4.7 工作流画布与异步运行
| 命令 | 说明 | 示例 |
| adp workflow list | 列出应用下的全部工作流。 | adp workflow list –app-id <id> |
| adp workflow get | 获取指定工作流的完整画布 JSON 与版本号。 | adp workflow get –app-id <id> –workflow-id <wid> |
| adp workflow deploy | 从本地画布 JSON 文件创建或更新工作流，自动校验、启用并可选绑定为应用入口。 | adp workflow deploy –app-id <id> –canvas-file ./canvas.json –yes |
| adp workflow enable | 启用指定的工作流（绑定为单工作流模式入口前必须先启用）。 | adp workflow enable –app-id <id> –workflow-id <wid> |
| adp workflow disable | 禁用指定的工作流。 | adp workflow disable –app-id <id> –workflow-id <wid> |
| adp workflow export | 将工作流导出为 ZIP 压缩包（支持 –output 直接下载到本地）。 | adp workflow export –app-id <id> –workflow-id <wid> –output ./wf.zip |
| adp workflow import | 将工作流 ZIP 包导入至目标应用，支持加 –enable 自动启用。 | adp workflow import –app-id <id> –file ./wf.zip –enable |
| adp workflow remove | 永久删除指定的工作流。 | adp workflow remove –app-id <id> –workflow-id <wid> –yes |
| adp workflow run start | 启动单工作流模式应用的异步工作流运行实例，默认等待运行结束并返回结果。 | adp workflow run start –app-id <id> –query "生成今日科技简报" |
| adp workflow run list | 列出应用下的异步工作流运行实例记录。 | adp workflow run list –app-id <id> |
| adp workflow run get | 查看单次异步工作流运行实例的输出结果与各节点执行状态（加 –graph 返回拓扑图）。 | adp workflow run get –app-id <id> –run-id <rid> –graph |
| adp workflow run node | 查看工作流运行实例中单个节点的输入、输出、原始任务结果、日志与模型 Token 统计。 | adp workflow run node –app-id <id> –node-run-id <nrid> –stats |
| adp workflow run batch | 查看循环节点或批处理节点中指定批次（–index）的输入、输出与状态。 | adp workflow run batch –app-id <id> –run-id <rid> –node-id <nid> –index 0 |
| adp workflow run resume | 对处于“等待用户输入”状态的异步工作流实例补充回复内容以继续执行。 | adp workflow run resume –app-id <id> –run-id <rid> –query "确认执行" |
| adp workflow run stop | 批量停止处于排队中或运行中的异步工作流实例。 | adp workflow run stop –app-id <id> –run-id <rid> |
28、4.8 插件、平台 Skills、配套 Skills 与授权凭证
| 命令 | 说明 | 示例 |
| adp plugin list | 列出工作空间内的插件（连接器与工具）列表。 | adp plugin list –space-id <id> |
| adp plugin get | 查看单个插件的详情与工具摘要。 | adp plugin get –plugin-id <pid> –space-id <sid> |
| adp plugin create | 通过 MCP 地址（–mcp-url）或配置文件（–from-config）创建新插件。 | adp plugin create –space-id <sid> –from-config ./plugin.jsonc |
| adp plugin update | 修改插件的基础信息、MCP 地址或通过配置文件更新工具定义。 | adp plugin update –plugin-id <pid> –space-id <sid> –name "新插件名" |
| adp plugin delete | 删除指定的插件。 | adp plugin delete –plugin-id <pid> –space-id <sid> –yes |
| adp plugin tool get | 查看插件下单个工具的完整入参与出参 Schema 定义。 | adp plugin tool get –plugin-id <pid> –tool-id <tid> |
| adp plugin tool list | 通过 Streamable HTTP 实时拉取平台 MCP 插件的在线工具列表。 | adp plugin tool list –plugin-id <pid> |
| adp plugin tool call | 使用工具密钥直接调用平台 MCP 插件中的指定工具并返回执行结果。 | adp plugin tool call –plugin-id <pid> –tool-name <name> –input '{}' |
| adp plugin key list | 列出当前账号的工具密钥（ADP API Key，密钥值自动脱敏）。 | adp plugin key list |
| adp plugin key create | 创建新的工具密钥并默认保存至 ~/.adp/tool-key（供 plugin tool call 使用）。 | adp plugin key create –description "本地调试密钥" |
| adp plugin key update | 修改工具密钥的备注描述。 | adp plugin key update –key-id <kid> –description "新备注" |
| adp plugin key enable | 启用已停用的工具密钥。 | adp plugin key enable –key-id <kid> |
| adp plugin key disable | 停用指定的工具密钥（删除密钥前必须先停用）。 | adp plugin key disable –key-id <kid> |
| adp plugin key delete | 删除已停用的工具密钥。 | adp plugin key delete –key-id <kid> –yes |
| adp plugin share get | 查看插件的跨空间共享配置（加 –pending 查看待审批配置）。 | adp plugin share get –plugin-id <pid> |
| adp plugin share set | 修改插件及关联凭证的跨空间共享范围。 | adp plugin share set –plugin-id <pid> –scope all –yes |
| adp plugin share approval | 查看插件跨空间共享审批单的详情与状态。 | adp plugin share approval –plugin-id <pid> –approval-id <aid> |
| adp plugin auth check | 检查当前调用者是否已完成 OAuth 插件的授权。 | adp plugin auth check –plugin-id <pid> |
| adp plugin oauth-url | 为 OAuth 2.0 插件生成浏览器授权链接。 | adp plugin oauth-url –plugin-id <pid> –credential-id <cid> |
| adp skill list | 列出工作空间内的平台 Skills 列表。 | adp skill list –space-id <sid> |
| adp skill get | 查看单个平台 Skill 的版本与配置详情。 | adp skill get –skill-id <skid> –space-id <sid> |
| adp skill create | 通过本地 ZIP 压缩包或文件链接在空间内创建自定义平台 Skill。 | adp skill create –space-id <sid> –name "my-skill" –file ./skill.zip |
| adp skill update | 更新自定义平台 Skill 的名称、描述或技能包文件。 | adp skill update –skill-id <skid> –space-id <sid> –name "新名称" |
| adp skill delete | 删除指定的平台 Skill。 | adp skill delete –skill-id <skid> –space-id <sid> –yes |
| adp skill release | 上架发布平台 Skill 的指定版本，使其可被应用和智能体挂载。 | adp skill release –skill-id <skid> –space-id <sid> |
| adp skill categories | 列出平台 Skills 广场的分类标识列表。 | adp skill categories |
| adp skill refs | 查询有哪些应用、智能体或工作台用户正在引用指定的平台 Skill。 | adp skill refs –skill-id <skid> –space-id <sid> |
| adp skill share submit | 将已上架的自定义 Skill 提交共享至企业技能中心。 | adp skill share submit –skill-id <skid> –yes |
| adp skill share withdraw | 从企业技能中心撤回已共享的 Skill 版本。 | adp skill share withdraw –skill-id <skid> –yes |
| adp skill share approval | 查看平台 Skill 企业共享审批单的状态与详情。 | adp skill share approval –approval-id <aid> |
| adp skills | 检查本机 AI 编程助手的配套 Companion Skill 安装状态。 | adp skills |
| adp skills install | 将内置的 ADP Companion Skill 安装至本机 AI 编程助手目录。 | adp skills install –yes |
| adp credential list | 列出工作空间内的连接器/工具授权凭证列表（不返回密钥明文）。 | adp credential list –space-id <sid> |
| adp credential get | 查看你创建的单个授权凭证详情（类型、关联组件、配置方式）。 | adp credential get –credential-id <cid> |
| adp credential consumers | 列出空间内已配置授权凭证的连接器与工具。 | adp credential consumers |
| adp credential referable | 列出指定连接器/工具可引用的凭证（含个人创建与企业共享凭证）。 | adp credential referable –consumer-id <plugin-id> |
| adp credential create | 从环境变量读取密钥，为连接器/工具创建 API Key 类型的授权凭证。 | MY_KEY=xxx adp credential create –consumer-id <pid> –name "key1" –token-env MY_KEY |
| adp credential update | 重命名授权凭证或替换其 API Key 密钥值。 | NEW_KEY=xxx adp credential update –credential-id <cid> –token-env NEW_KEY |
| adp credential delete | 删除未被任何组件引用的授权凭证。 | adp credential delete –credential-id <cid> –yes |
| adp credential references | 查询有哪些智能体、工作流、工作台或知识库正在引用该凭证。 | adp credential references –credential-id <cid> |
| adp credential access | 检查指定引用方是否有权限使用该授权凭证及不可用原因。 | adp credential access –credential-id <cid> –referrer-type app_agent –referrer-id <id> |
| adp credential authorize | 为连接器/工具发起 OAuth 授权或重新授权，输出授权链接并支持 –wait 等待完成。 | adp credential authorize –consumer-id <pid> –wait |
| adp credential authorization | 查询由 adp credential authorize 发起的 OAuth 授权状态。 | adp credential authorization –authorization-id <aid> |
29、4.9 长期记忆库与空间云盘存储
| 命令 | 说明 | 示例 |
| adp memory list | 列出工作空间内的记忆库列表（支持按 rich 富文本或 flat 扁平类型过滤）。 | adp memory list –space-id <sid> |
| adp memory get | 查看单个记忆库的配置详情。 | adp memory get –store-id <id> |
| adp memory create | 创建新的记忆库（rich 支持结构化条目与用户摘要；flat 支持过期天数 TTL）。 | adp memory create –name "客户记忆库" –type rich –summary |
| adp memory update | 修改记忆库的名称、描述、摘要开关或过期天数（TTL）。 | adp memory update –store-id <id> –name "新名称" |
| adp memory copy | 在同一工作空间内复制记忆库及其包含的全部记忆条目。 | adp memory copy –store-id <id> |
| adp memory delete | 删除指定的记忆库及其全部记忆数据。 | adp memory delete –store-id <id> –yes |
| adp memory users | 列出记忆库中已积累记忆的终端用户列表及条目数量预览。 | adp memory users –store-id <id> |
| adp memory entry list | 列出记忆库中的记忆条目（支持按 –user-id 或关键词筛选）。 | adp memory entry list –store-id <id> –user-id <uid> |
| adp memory entry add | 手动为指定终端用户新增1条记忆（不超过4000字符）。 | adp memory entry add –store-id <id> –user-id <uid> –text "偏好顺丰配送" |
| adp memory entry update | 修改指定终端用户的某条记忆内容、标题或元数据。 | adp memory entry update –store-id <id> –user-id <uid> –entry-key <key> –content "新内容" |
| adp memory entry delete | 批量删除指定终端用户的记忆条目（每次最多20条）。 | adp memory entry delete –store-id <id> –user-id <uid> –entry-key <key> –yes |
| adp memory summary get | 查看富文本记忆库中指定终端用户的全局记忆摘要。 | adp memory summary get –store-id <rms-id> –user-id <uid> |
| adp memory summary set | 覆盖更新富文本记忆库中指定终端用户的全局记忆摘要。 | adp memory summary set –store-id <rms-id> –user-id <uid> –text "VIP 客户" |
| adp memory summary delete | 删除富文本记忆库中指定终端用户的全局记忆摘要。 | adp memory summary delete –store-id <rms-id> –user-id <uid> –yes |
| adp memory binding get | 查看应用当前绑定的记忆库及开关状态。 | adp memory binding get –app-id <id> |
| adp memory bind | 将应用绑定至指定记忆库（不传 –store-id 时自动创建并绑定默认同名记忆库）。 | adp memory bind –app-id <id> –store-id <sid> |
| adp memory binding update | 开启或关闭应用的长期记忆开关或引用记忆摘要开关。 | adp memory binding update –app-id <id> –enable –summary |
| adp memory export | 将记忆库中的全部条目异步导出为 CSV 文件。 | adp memory export –store-id <id> –output ./memory.csv |
| adp memory import | 从 CSV 文件批量导入记忆条目至记忆库。 | adp memory import –store-id <id> –file ./memory.csv |
| adp volume list | 列出工作空间内的共享文件云盘列表。 | adp volume list –space-id <sid> |
| adp volume get | 查看单个云盘的详情及正在挂载该云盘的应用列表。 | adp volume get –volume-id <vid> |
| adp volume create | 在工作空间内创建新的共享文件云盘。 | adp volume create –space-id <sid> –name "项目资料盘" |
| adp volume update | 修改云盘的名称或描述。 | adp volume update –volume-id <vid> –name "新云盘名" |
| adp volume delete | 删除指定的云盘及其内部的全部文件。 | adp volume delete –volume-id <vid> –yes |
| adp volume ls | 列出云盘指定路径下的文件与文件夹（或加 –query 搜索子树）。 | adp volume ls –volume-id <vid> –path /docs |
| adp volume mkdir | 在云盘内创建目录（自动创建父目录）。 | adp volume mkdir –volume-id <vid> –path reports/2026 |
| adp volume upload | 将本地文件上传至云盘指定目录（单文件最大支持500MB，不覆盖同名文件）。 | adp volume upload –volume-id <vid> –file ./spec.pdf –to docs/ |
| adp volume download | 将云盘中的文件下载至本地路径。 | adp volume download –volume-id <vid> –path docs/spec.pdf –output ./spec.pdf |
| adp volume mv | 原地重命名云盘中的文件。 | adp volume mv –volume-id <vid> –path docs/a.pdf –name b.pdf |
| adp volume rm | 删除云盘中的单个文件，或加 –recursive 递归删除整个目录。 | adp volume rm –volume-id <vid> –path docs –recursive –yes |
| adp volume preview-url | 获取云盘内指定文件的短期浏览器在线预览链接。 | adp volume preview-url –volume-id <vid> –path docs/spec.pdf –reveal |
30、4.10 发布渠道、应用触发器与工作台定时任务
| 命令 | 说明 | 示例 |
| adp channel list | 列出应用已配置的发布渠道列表。 | adp channel list –app-id <id> |
| adp channel get | 查看单个发布渠道的配置详情与状态。 | adp channel get –app-id <id> –channel-id <cid> |
| adp channel create | 为应用创建新的发布渠道（企微、微信客服、公众号/小程序、微信 ClawBot、钉钉、飞书、LINE、Telegram）。 | adp channel create –app-id <id> –channel-type 10016 –spec-json '{"Lark":{"AppId":"xxx","AppSecret":"xxx"}}' |
| adp channel update | 修改发布渠道的描述或企微机器人配置信息。 | adp channel update –app-id <id> –channel-id <cid> –description "新备注" |
| adp channel delete | 删除指定的发布渠道。 | adp channel delete –app-id <id> –channel-id <cid> –yes |
| adp trigger list | 列出应用下的全部触发器（含定时触发器与 Webhook 事件触发器）。 | adp trigger list –app-id <id> |
| adp trigger get | 查看单个应用触发器的配置详情。 | adp trigger get –trigger-id <tid> |
| adp trigger create | 为应用创建 Cron 定时触发器或 Webhook 事件触发器。 | adp trigger create –app-id <id> –name "早报" –cron "0 9 * * *" –prompt "汇总昨日数据" |
| adp trigger update | 修改应用触发器的名称、Cron 表达式或提示词指令。 | adp trigger update –trigger-id <tid> –cron "0 8 * * *" |
| adp trigger pause | 暂停指定的应用触发器。 | adp trigger pause –trigger-id <tid> |
| adp trigger resume | 恢复已暂停的应用触发器。 | adp trigger resume –trigger-id <tid> |
| adp trigger run | 立即手动触发1次应用触发器执行。 | adp trigger run –trigger-id <tid> |
| adp trigger delete | 删除指定的应用触发器。 | adp trigger delete –trigger-id <tid> –yes |
| adp trigger instance get | 查看应用触发器单次运行实例的执行结果、摘要与关联会话。 | adp trigger instance get –instance-id <iid> –app-id <id> |
| adp trigger instance mark-read | 将应用触发器的运行记录标记为已读。 | adp trigger instance mark-read –trigger-id <tid> –instance-id <iid> |
| adp timer list | 列出个人在当前工作空间智能工作台下的定时任务列表。 | adp timer list –space-id <sid> |
| adp timer get | 查看单个工作台定时任务的详情（提示词、模型、调度规则、运行次数）。 | adp timer get –timer-id <tid> |
| adp timer create | 创建工作台定时任务（支持 –daily、–weekly、–every、–once、–cron、–manual）。 | adp timer create –name "日报" –prompt "生成日报" –daily 09:00 |
| adp timer update | 修改工作台定时任务的名称、提示词、模型或调度周期。 | adp timer update –timer-id <tid> –daily 10:00 |
| adp timer pause | 暂停工作台定时任务的自动调度。 | adp timer pause –timer-id <tid> |
| adp timer resume | 恢复已暂停的工作台定时任务。 | adp timer resume –timer-id <tid> |
| adp timer run | 立即手动执行1次工作台定时任务（加 –wait 等待执行完成）。 | adp timer run –timer-id <tid> –wait |
| adp timer runs | 列出工作台定时任务的历史运行日志列表（加 –unread 仅看未读）。 | adp timer runs –timer-id <tid> |
| adp timer mark-read | 将工作台定时任务的未读运行日志标记为已读。 | adp timer mark-read –timer-id <tid> |
| adp timer delete | 删除指定的工作台定时任务并停止其调度。 | adp timer delete –timer-id <tid> –yes |
31、4.11 实时对话调试与会话记录管理
| 命令 | 说明 | 示例 |
| adp chat | 向已发布应用发送1条 HTTP SSE 流式测试消息（支持多轮会话、传入图片与文档链接）。 | adp chat –message "你好" –app-id <id> |
| adp tail | 实时拉取已发布应用最新产生的问答消息记录或触发器运行日志。 | adp tail –app-id <id> |
| adp conversation list | 列出应用下的会话列表（支持按访客会话或评测会话过滤）。 | adp conversation list –app-id <id> |
| adp conversation get | 查看单个会话的元信息（标题、类型、时间戳）。 | adp conversation get –conversation-id <cid> |
| adp conversation create | 为应用创建1个新的空会话。 | adp conversation create –app-id <id> |
| adp conversation rename | 修改指定会话的标题。 | adp conversation rename –conversation-id <cid> –title "售后咨询" |
| adp conversation reset | 清空指定会话的上下文（下一条消息从零开始，历史消息仍保留可见）。 | adp conversation reset –conversation-id <cid> –yes |
| adp conversation delete | 删除指定的会话。 | adp conversation delete –conversation-id <cid> –yes |
| adp conversation messages | 读取指定会话内的历史消息流（含工具调用耗时与 Trace ID，支持游标翻页）。 | adp conversation messages –conversation-id <cid> –type 2 |
| adp conversation record get | 根据提问记录 ID 查看单轮问答记录详情（问题、回答、命中意图、Token 消耗）。 | adp conversation record get –record-id <rid> –app-id <id> |
| adp conversation category list | 查看应用下对话消息记录的分类目录树。 | adp conversation category list –app-id <id> |
| adp conversation category create | 新建对话消息记录分类文件夹。 | adp conversation category create –name "退换货类" –app-id <id> |
| adp conversation category update | 重命名对话消息记录分类文件夹。 | adp conversation category update –category-id <cid> –name "新名称" |
| adp conversation category delete | 删除指定的对话消息记录分类文件夹。 | adp conversation category delete –category-id <cid> –yes |
| adp conversation share create | 将指定的问答记录生成只读的公开会话分享快照。 | adp conversation share create –record-id <rid> |
| adp conversation share get | 读取已生成的会话分享快照内容。 | adp conversation share get –share-id <sid> |
32、4.12 效果调优、运营监控、计费与系统工具
| 命令 | 说明 | 示例 |
| adp guideline list | 列出应用的调优准则列表（支持按 candidate 待启用 / enabled 已启用 / disabled 已停用过滤）。 | adp guideline list –app-id <id> |
| adp guideline get | 查看单条调优准则的内容及来源（手动添加、评测生成、调试反馈）。 | adp guideline get –guideline-id <gid> |
| adp guideline create | 手动添加1条调优准则（保存后即处于已启用状态，随下次发布对终端用户生效）。 | adp guideline create –content "回答合同问题需注明条款编号" |
| adp guideline update | 修改调优准则的正文内容或适用场景。 | adp guideline update –guideline-id <gid> –content "新准则内容" |
| adp guideline enable | 启用1条或多条调优准则（将待启用候选准则采纳为正式准则）。 | adp guideline enable –guideline-id <gid> |
| adp guideline disable | 停用1条或多条调优准则。 | adp guideline disable –guideline-id <gid> |
| adp guideline delete | 删除指定的调优准则。 | adp guideline delete –guideline-id <gid> –yes |
| adp guideline changes | 预览下次发布（或指定历史版本）包含的调优准则变更。 | adp guideline changes –app-id <id> |
| adp guideline task list | 列出调优准则自动生成任务列表。 | adp guideline task list –app-id <id> |
| adp guideline task get | 查看单个准则生成任务的状态、选用模型、Token 消耗及产出的候选准则 ID。 | adp guideline task get –task-id <tid> |
| adp guideline task create | 基于已完成标注的评测任务启动 AI 自动生成候选调优准则任务。 | adp guideline task create –evaluation-id <eid> –model <mid> |
| adp guideline task delete | 删除准则生成任务记录（已生成的准则保留）。 | adp guideline task delete –task-id <tid> –yes |
| adp guideline auto-distill get | 查看应用是否开启了调试反馈自动提炼候选准则开关。 | adp guideline auto-distill get –app-id <id> |
| adp guideline auto-distill set | 开启或关闭调试反馈自动提炼候选准则功能，或更换提炼模型。 | adp guideline auto-distill set –enable –model <mid> |
| adp synonym list | 列出应用的同义词映射列表（标准词 → 同义词列表）。 | adp synonym list –app-id <id> |
| adp synonym create | 新增1组标准词及其对应的同义词。 | adp synonym create –word "腾讯云" –synonym "QCloud" |
| adp synonym update | 修改标准词或替换其同义词列表。 | adp synonym update –synonym-id <sid> –word "腾讯云" –synonym "TencentCloud" |
| adp synonym delete | 删除指定的同义词条目。 | adp synonym delete –synonym-id <sid> –yes |
| adp synonym move | 将同义词条目移动至其他同义词分类目录。 | adp synonym move –synonym-id <sid> –category-id <cid> |
| adp synonym category list | 查看同义词分类目录树。 | adp synonym category list –app-id <id> |
| adp synonym category create | 创建新的同义词分类目录。 | adp synonym category create –name "产品简称" |
| adp synonym category rename | 重命名同义词分类目录。 | adp synonym category rename –category-id <cid> –name "新分类名" |
| adp synonym category delete | 删除同义词分类目录及其子分类（内部的同义词条目保留）。 | adp synonym category delete –category-id <cid> –yes |
| adp synonym export | 将应用的同义词库导出为 Excel（.xlsx）文件。 | adp synonym export –output ./synonyms.xlsx |
| adp synonym import | 从符合导出模板格式的 Excel（.xlsx）文件批量导入同义词。 | adp synonym import –file ./synonyms.xlsx |
| adp feedback list | 列出终端用户对应用回复提交的反馈列表。 | adp feedback list –app-id <id> |
| adp feedback get | 查看单条终端用户反馈详情（原因、期望答案、引用信息、审核备注）。 | adp feedback get –feedback-id <fid> |
| adp feedback create | 针对指定回复记录提交1条反馈及期望标准答案。 | adp feedback create –record-id <rid> –session-id <sid> –question "Q" –answer "A" –reason "答非所问" –accept-terms |
| adp feedback delete | 删除指定的终端用户反馈记录。 | adp feedback delete –feedback-id <fid> –yes |
| adp unsatisfied list | 列出终端用户标记为“不满意（点踩）”的回复列表。 | adp unsatisfied list –app-id <id> |
| adp unsatisfied get | 查看单条不满意回复前后的完整对话上下文。 | adp unsatisfied get –reply-id <rid> |
| adp unsatisfied handle | 将不满意回复批量标记为已驳回（rejected）或已忽略（ignored）。 | adp unsatisfied handle –reply-id <rid> –status ignored |
| adp unsatisfied export | 将不满意回复列表导出为 Excel（.xlsx）文件。 | adp unsatisfied export –output ./unsatisfied.xlsx |
| adp unsatisfied label list | 按分组列出供终端用户选择的不满意原因标签。 | adp unsatisfied label list –app-id <id> |
| adp unsatisfied label create | 在指定分组下新增不满意原因标签。 | adp unsatisfied label create –group "准确性" –name "信息过时" |
| adp unsatisfied label update | 重命名不满意原因标签或将其移至其他分组。 | adp unsatisfied label update –label-id <lid> –name "数据过时" |
| adp unsatisfied label delete | 删除指定的不满意原因标签。 | adp unsatisfied label delete –label-id <lid> –yes |
| adp metrics overview | 查看工作空间智能工作台的运营总览指标（活跃用户、会话数、运行时长及环比变化）。 | adp metrics overview –space-id <sid> |
| adp metrics trend | 查看工作空间智能工作台每日运行时长趋势。 | adp metrics trend –space-id <sid> |
| adp metrics top-users | 查看工作空间智能工作台按任务数排名的活跃用户榜单。 | adp metrics top-users –space-id <sid> –limit 10 |
| adp metrics detail | 查看智能工作台单用户统计明细，或加 –pu 查看单次运行的 PU 与 Token 消耗明细。 | adp metrics detail –space-id <sid> –pu |
| adp metrics export | 发起智能工作台运营数据报表导出请求（导出文件通过控制台站内信通知下载）。 | adp metrics export –space-id <sid> –yes |
| adp metrics app | 查看单个应用的调用次数、成功率、响应延迟及回复类型占比。 | adp metrics app –app-id <id> –space-id <sid> |
| adp usage | 查看应用最近7天的模型调用次数与 Token 消耗核心指标。 | adp usage –app-id <id> |
| adp billing resources | 查看当前空间可见的计费资源套餐与增值包总额度及已用额度。 | adp billing resources –space-id <sid> |
| adp billing summary | 按调用来源汇总查看模型用量统计（需管理员报表权限）。 | adp billing summary –space-id <sid> |
| adp billing detail | 逐条查看模型调用账单明细（含 Trace、调用方、Token 数）。 | adp billing detail –space-id <sid> |
| adp billing consumption | 查看带 PU 抵扣金额的资源消耗明细记录。 | adp billing consumption –space-id <sid> |
| adp billing concurrency | 查看因超出并发限制而被拒绝的请求明细记录。 | adp billing concurrency –space-id <sid> |
| adp audit meta | 查看 adp audit list 支持过滤的操作类型（Action）与业务模块（Biz）字典。 | adp audit meta |
| adp audit list | 按时间倒序查询平台操作审计日志（使用 –cursor 游标翻页）。 | adp audit list –space-id <sid> |
| adp docs search [query] | 实时搜索腾讯云智能体开发平台产品文档（无需登录鉴权）。 | adp docs search "ModifyApp" |
| adp docs list | 列出腾讯云智能体开发平台产品文档目录页列表（无需登录鉴权）。 | adp docs list –type api |
| adp docs get [document-id] | 根据文档 ID 拉取产品文档 Markdown 正文（支持 –section 只取指定结构体章节）。 | adp docs get 132545 –section ChannelSpec |
| adp docs config | 打印随包内置的 adp.jsonc JSON Schema 本地路径（离线可用）。 | adp docs config |
| adp schema | 以 JSON 格式输出 CLI 的命令树、参数定义与副作用说明（支持 –compact 与 –command）。 | adp schema –compact –format json |
| adp env list | 列出 adp 读取的所有环境变量名称及敏感标记（从不打印变量值）。 | adp env list |
| adp version | 查看本机已安装版本，并联网检查 npm 是否有新版本可升级。 | adp version |
| adp upgrade | 使用全局包管理器（npm / pnpm / yarn）将 adp 升级至最新版本。 | adp upgrade –yes |
34、如何让 AI 编程助手在不猜测参数的情况下操作新增功能？
配套的 adp Companion Skill 已内置能力自发现规范。AI 助手在遇到不熟悉的命令或结构体参数时，会自动运行 adp schema –command "<命令>" –format json 查看精确参数定义，并通过 adp docs search 与 adp docs get 实时查阅腾讯云最新产品文档。
35、为什么切换了 Profile 之后，调用接口仍然使用的是旧账号？
在凭证解析优先级中，终端环境变量 TENCENTCLOUD_SECRET_ID / TENCENTCLOUD_SECRET_KEY 的优先级高于本地 Profile 文件。你可以运行 adp auth status 查看 source 字段：若显示为 env，在终端执行 unset TENCENTCLOUD_SECRET_ID TENCENTCLOUD_SECRET_KEY 即可恢复使用 Profile 中的凭证。
36、独立站账号能否使用 adp kb doc import 导入本地知识库文档或使用 adp workflow 部署工作流？
可以。公有云会将底层 LKE 请求发送至 lke.tencentcloudapi.com，独立站与自定义站点则会使用当前 Profile 的密钥直接将请求发送至对应的 ADP 网关主机。
37、相关文档
通过 WorkBuddy 连接器上线 ADP 智能体