本文介绍如何安装和使用 ADP CLI(
@tencentcloudadp/cli)及其配套 Skill,帮助您在终端或通过主流 Coding Agent (例如 Cursor、Claude Code、Codex、CodeBuddy、WorkBuddy)一站式管理腾讯云智能体开发平台的空间、应用、智能体、知识库、工作流、渠道与线上运营。一、快速入门与核心概念
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
二、CLI + Skill 完整安装与体验流程
步骤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 |
四、全量 CLI 命令
本章按业务模块将 ADP CLI 的全部命令逐条平铺展开,包含完整命令语法、功能说明与调用示例。
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 |
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 |
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 |
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 |
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> |
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> |
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> |
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> |
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 |
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 |
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> |
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 |
五、常见问题
如何让 AI 编程助手在不猜测参数的情况下操作新增功能?
配套的
adp Companion Skill 已内置能力自发现规范。AI 助手在遇到不熟悉的命令或结构体参数时,会自动运行 adp schema --command "<命令>" --format json 查看精确参数定义,并通过 adp docs search 与 adp docs get 实时查阅腾讯云最新官方文档。为什么切换了 Profile 之后,调用接口仍然使用的是旧账号?
在凭证解析优先级中,终端环境变量
TENCENTCLOUD_SECRET_ID / TENCENTCLOUD_SECRET_KEY 的优先级高于本地 Profile 文件。您可以运行 adp auth status 查看 source 字段:若显示为 env,在终端执行 unset TENCENTCLOUD_SECRET_ID TENCENTCLOUD_SECRET_KEY 即可恢复使用 Profile 中的凭证。独立站账号能否使用 adp kb doc import 导入本地知识库文档或使用 adp workflow 部署工作流?
可以。公有云会将底层 LKE 请求发送至
lke.tencentcloudapi.com,独立站与自定义站点则会使用当前 Profile 的密钥直接将请求发送至对应的 ADP 网关主机。