帮你快速理解、总结文档立即下载

ADP CLI 功能概述

最近更新时间:2026-11-04 15:35:31
我的收藏
本文介绍如何安装和使用 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-remote
adp dev
adp deploy --dry-run

二、CLI + Skill 完整安装与体验流程

步骤1:安装 ADP CLI 工具

请确保本机已安装 Node.js 20 及以上版本,选择以下任一包管理器全局安装 @tencentcloudadp/cli:

使用 npm 安装(推荐)

npm install -g @tencentcloudadp/cli

# 验证安装版本
adp --version

使用 pnpm 或 yarn 安装

# 使用 pnpm
pnpm add -g @tencentcloudadp/cli

# 或使用 yarn
yarn 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 list
adp 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,name
adp models --fields modelId,name --limit 10

# 2. 初始化本地项目并在云端创建应用草稿
mkdir order-helper && cd order-helper
adp 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.md
adp kb search --question "怎么办理退货?"

# 5. 预览待发布差异,确认无误后正式发布上线
adp deploy --dry-run
adp 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 网关主机。

相关文档