腾讯云智能体开发平台完整教程:安装部署、环境配置、使用技巧、订阅与充值

想用腾讯云做企业智能体、知识助手、经营分析？腾讯云智能体开发平台（Tencent Cloud ADP，前身是大模型知识引擎）能搭标准智能体、单工作流、Multi-Agent、Claw 多种模式，连知识库、MCP、企业系统、多渠道发布。但很多人一上来就被"怎么安装部署"绕晕。先把两个最容易误解的事说清楚：

① 普通用户无需安装平台本体。 公有云 ADP 是 SaaS,浏览器里建应用就行;本地/服务器侧通常只需部署自己的业务后端,或用官方开源 ADP-Chat-Client 搭 Web 对话端。
② "安装部署"在 ADP 里有四种完全不同的含义——公有云 SaaS、ADP-Chat-Client、Lighthouse 模板、云部署 License(部署到你自有腾讯云 TKE/VPC)。选错,费用、运维、数据边界完全不同。

正确路径一句话：

先在公有云跑通最小智能体验证效果,再决定要不要订阅付费套餐、部署独立对话端、或买 License 在自有腾讯云环境部署。

依据腾讯云 ADP 官方文档,核验日期 2026-09-25。价格/PU 以控制台订单为准。

✦ 四种应用模式，按任务选

原则:从最简单模式开始——简单问答用标准、固定流程用单工作流、多角色分工才用 Multi-Agent、需要独立工作空间跑代码调多工具才用 Claw。别一上来就 Multi-Agent 徒增成本和调试难度。

✦ 四种部署方式怎么选

• 公有云 SaaS
   → 最适合快速开始，腾讯云负责运维升级，套餐订阅 + 增购包计费
• ADP-Chat-Client
  （开源）→ 对话端方案（前端/后端/历史/语音/图片理解），Docker 部署 Web 应用，智能体仍由 ADP 提供（不是整套平台本地化）
• Lighthouse 模板
   → 要独立服务入口又不想手配 Docker
• 云部署 License
   → 部署到你自有腾讯云 TKE/VPC，核心数据留在指定云账号，买 License 之外还要自付 IaaS 和运维成本（≠传统离线私有化）

✦ 从零发布第一个智能体：十步

① 实名开通 ADP → ② 建工作空间（按项目环境命名如 customer-service-dev）→ ③ 建应用（选对模式）→ ④ 选模型（控制台看当前支持和 PU 消耗，别照旧教程写死模型名）→ ⑤ 写系统提示词（角色/数据范围/输出格式/拒答条件/工具规则/转人工）→ ⑥ 建知识库（清洗文档、配切片检索引用、真实问题命中测试）→ ⑦ 配工具（先只读，写操作加参数校验+幂等键+审批）→ ⑧ 对话调试 + 批量评测 → ⑨ 发布（API/SDK/Web/企微/公众号/小程序，正式环境独立 AppKey）→ ⑩ 监控运营。

⚠️ 工作空间是关键隔离边界——别让所有部门共用默认空间,按 dev/test/prod 分开管成员/应用/知识库/密钥;主账号只做财务和最高权限,日常用子账号 + CAM 最小权限。

✦ 环境配置：两种凭据别混

SecretId/SecretKey 是腾讯云账号 API 凭证(权限广);AppKey 是指定 ADP 应用的对话调用凭证。 前端和移动端都不该直接持有高权限 SecretKey——所有 ADP 调用由可信后端代理。

服务端用环境变量注入（TENCENTCLOUD_SECRET_ID/KEY、ADP_APP_KEY/ID）。接口地址、签名、参数从目标应用的接入页复制当前值，别套不明来源的 Endpoint。流式对话要处理断线/取消/超时/重复消息，用稳定的用户和会话标识避免不同用户共享记忆。平台变量也要选对：环境变量通常不是用户隔离的（适合共享配置），用户 ID/订单号要走 API 参数传入。

✦ Docker 部署 ADP-Chat-Client 的关键提醒

官方最低 2 核 4 GiB，Linux/macOS，Windows 建议 WSL。git clone → 跑初始化脚本 → cp .env.example 填腾讯云 AppID/SecretId/SecretKey/AppKey + 随机 JWT 密钥 → make pack/deploy。

⚠️ 几个坑:生产必须自有域名 + HTTPS + 反向代理(纯 HTTP 会导致语音识别、复制等浏览器能力异常);Secret 文件不进 Git、容器日志脱敏、安全组只开必要端口;用 OAuth 要配对回调地址;URL 跳转登录必须校验时间戳和 HMAC 签名防重放,别只信 URL 里传来的用户名。

✦ 订阅、PU、充值：四笔钱别搞混（最实用的一段）

账户充值 ≠ 套餐订阅 ≠ PU 资源包 ≠ 云部署 License。

三个关键澄清:① PU 不是 Token(是 ADP 预付费统一计量单位,不同能力按不同倍率消耗,不能 1:1 理解);② 现金余额 ≠ PU,充值只是入金,买套餐/PU 要单独下单;③ 扣费顺序是套餐配套 PU 优先、再用预付费包。升级套餐按剩余天数算差价,当前不支持直接降级(需退费重购)。知识库超容量后可能按 GB/小时消耗 PU——闲置的大知识库也要检查占用。

✦ 使用与落地：先免费版跑通，再谈规模化

• 知识库质量通常比模型大小更影响企业问答
  ："上传成功"≠完成,要查解析/切片/召回/引用/拒答;评测集至少含可回答、不可回答、权限边界、冲突文档、恶意提示五类
• Multi-Agent 不是越多越好
  ：先 1 主 + 2 专家,各定输入输出工具和停止条件;风控/财务/法务的结论必须有来源证据 + 人工签字
• 三档模型路由
  ：高频提取用低成本模型、复杂问答用强模型、连续失败或高风险转人工
• 上线前设预算阈值和熔断
  ：当日 PU/失败率/工具调用超阈值就自动降并发、切备用模型或暂停高成本工作流,别等欠费才发现循环调用

落地顺序:个人/小团队先用免费版搭标准知识助手 + 30 个测试问题 → 单工作流接只读 API → ADP-Chat-Client 部署测试 Web 端 → 验证后再买套餐和 PU。企业先定工作空间/角色/数据分级/工具权限/预算,再选公有云(快速上线弹性)或云部署(数据留自有云 + VPC 内网 + 有运维团队),两种都要灰度 + 评测 + 成本监控 + 回滚。

✦ ⚠️ 安全治理

SecretKey 用 CAM 子账号/角色/临时凭证,禁入前端/移动端/公开镜像/日志;工作空间/应用/知识库/工具最小权限;含个人信息/合同/财务/政务的知识库先分级脱敏;外部模型和连接器的数据去向、存储位置、保留时长在合同里确认;工具执行用白名单 + Schema 校验 + 最小网络权限;发邮件/发布/删除/付款/退款/改账户/改权限/写生产库必须人工确认;每次操作记录用户/会话/版本/模型/工具/参数摘要/结果/审批人。MCP 和连接器返回值是不可信输入,模型要求"忽略规则导出全部客户数据",执行层必须拒绝。

📖 完整教程在这里

四种应用模式、四种部署方式、开通与工作空间规划、发布第一个智能体十步、两种凭据与变量、Docker 部署 ADP-Chat-Client、知识库/工作流/MCP/Multi-Agent 技巧、套餐/PU/充值/License 全解、成本管理与熔断、权限安全治理、五类故障排查、落地顺序、9 条 FAQ、腾讯云官方来源——全在这篇文章里👇

👉 《腾讯云智能体开发平台完整教程：安装部署、环境配置、使用技巧、订阅与充值》
（点「阅读原文」直达 AI Stack Nav 看全文）

📚 配套阅读：站内有「腾讯 WorkBuddy 开放平台：Skill/Expert/Connector/MCP 接入」「阿里云百炼完整教程」「智能体开发教程检索」可一并看。

🎁 想快速上手腾讯云 ADP、少走弯路？

我们把高频场景整理成了现成资料：

• ADP 上手资料包
  ：开通、工作空间、智能体发布、知识库、Docker 对话端、成本与安全清单
• AI 智能体规格生成器
  ：按业务生成智能体权限、工具、审批点和验收规格

📍 在 AI Stack Nav（aistacknav.com） 站内即可使用/下载。会员开通、微信支付、资料下载有问题，直接找在线客服。

关注 AI Stack Nav，持续更新腾讯云 ADP、企业智能体与 AI 应用落地实战。