本文指导开发人员和业务人员在 WorkBuddy 客户端中启用腾讯云 ADP 连接器，通过自然语言对话完成腾讯云智能体开发平台的空间查询、应用创建、知识库导入、草稿调试与线上发布。
通过连接器接入后，系统会在后台自动完成以下工作，您无需打开终端或手动输入任何命令行指令：
自动准备组件：首次连接或版本更新时，WorkBuddy 自动在后台下载并配置所需工具组件。
本机网页授权：首次连接自动在系统浏览器弹出本机专属授权页。密钥经校验后仅保存在本机个人目录，不会进入对话记录。
自动加载技能：连接器内置智能体开发平台的领域技能知识。您在对话中提及相关需求时，WorkBuddy 会自动调用对应能力执行操作。
前提条件
在连接之前，请根据您所使用的智能体开发平台站点准备访问密钥（SecretId 和 SecretKey）。公有云与独立站属于两套独立的账号体系，请按以下对应方式获取：
站点类型 | 适用人群 | 密钥获取方式 |
腾讯云公有云 | 使用腾讯云官网控制台的用户 | 前往 腾讯云 CAM API 密钥管理控制台 创建或查看 SecretId（以 AKID 开头）与 SecretKey。若使用子账号，需由管理员授予智能体开发平台相关权限，详情请参见 CAM 权限说明。 |
ADP 独立站 | ||
自定义地址 | 使用私有化部署或专属网关的企业用户 | 联系企业管理员获取服务访问地址及配套的 SecretId 与 SecretKey。 |
注意：
SecretKey 仅在新建密钥时显示 1 次，请妥善保存。如不慎遗失，可在对应控制台新建密钥替代。
操作步骤
步骤 1：打开连接器管理面板
1. 启动 WorkBuddy 客户端，在左侧栏选择 专家·技能·连接器 > 连接器。
2. 在连接器管理面板右上方的搜索连接器输入框中输入“腾讯云 ADP”，或在官方内置、企业连接器列表中定位到腾讯云 ADP 卡片。
步骤 2：连接并完成授权
1. 在腾讯云 ADP 卡片右侧单击连接。
首次连接时，界面提示“正在下载连接器 腾讯云 ADP...”，并在后台自动完成组件安装。
若本机此前已完成授权且凭证有效，卡片状态直接更新为已连接，可跳过后续子步骤。
2. 当卡片状态变为连接中并提示“将跳转页面授权连接...”时，系统默认浏览器会自动打开 ADP CLI 登录本机授权页。请在页面中填写以下信息：
站点：在下拉框中选择公有云、独立站或自定义地址。若选择自定义地址，需同时填入服务访问地址。
SecretId：粘贴您在前提条件中获取的 SecretId。
SecretKey：粘贴您在前提条件中获取的 SecretKey。
3. 单击页面底部的验证并保存。系统会立即校验密钥的有效性。校验通过后，页面提示“登录完成，凭据已保存到本机 profile，可以关闭此页面并回到对话”。
4. 返回 WorkBuddy 客户端，腾讯云 ADP 卡片状态显示为已连接。
说明：
对话中按需授权：若您未执行步骤 2 便直接在对话中发起 ADP 操作，WorkBuddy 会自动提供密钥获取链接。您可以发送指令“帮我打开网页登录 ADP”唤起本机授权页。
多账号切换：若需同时管理公有云与独立站账号，可在对话中发送“帮我新增一个名为 indie 的独立站登录配置并打开网页填写密钥”，后续发送“把默认 ADP 账号切换到 indie”即可切换。
更新与断开：连接器会在每次连接时自动检查并更新版本。若需更换密钥或清除本机凭证，可在卡片上单击重新授权或断开。
步骤 3：盘点工作空间与同步存量应用
连接成功后，返回 WorkBuddy 对话窗口即可使用自然语言管理资源。
1. 在对话输入框中发送以下指令，查看当前账号下的工作空间、现有应用及可用大模型：
列出我在腾讯云 ADP 上的所有工作空间和应用，并看看默认空间下有哪些可用的大模型。
WorkBuddy 会在对话窗口中输出结构化的工作空间列表、应用清单与模型列表。
2. 若您需要修改团队已有的存量应用（例如网页控制台上已修改过知识库绑定、插件挂载或提示词），请在修改前先发送以下指令同步云端配置：
先帮我读取“企业售后客服助手”在云端的最新配置，并同步到当前本地文件夹。
平台的知识库关联、插件列表和技能挂载均采用整体替换机制。修改前先拉取云端最新状态，可避免网页控制台新增的挂载项被本地旧文件覆盖。若您是从零新建应用，可跳过本步直接进入步骤 4。
步骤 4：从零创建、调试并发布智能体应用
本步骤以创建并上线“企业售后客服助手”为例，指导您完成从模式选型、草稿迭代、知识导入到正式发布的完整流程。
1. 根据业务需求选择合适的应用模式。四种应用模式的适用场景与约束如下表所示：
应用模式 | 适用业务场景 | 选型建议与约束 |
标准模式 | 知识库问答（RAG）、企业标准 FAQ 客服、文案生成。 | 结构轻量，适合以文档检索与问答对为核心的单智能体场景。 |
Multi-Agent 模式 | 复杂业务拆解、主智能体调度多个子智能体、挂载插件与工作流。 | 通用推荐模式，支持后续随时扩展子智能体与外部工具。 |
单工作流模式 | 业务逻辑固定、严格按步骤执行的自动化任务。 | 正式发布前，必须为应用启用并绑定 1 条入口工作流。 |
Claw 模式 | 需要独立沙箱执行代码、处理文件、安装技能及运行时动态切换能力的自主智能体。 | 创建时需提前确定；创建后无法与其他 3 种模式互相转换。 |
2. 在 WorkBuddy 中打开 1 个本地空文件夹（用于存放项目配置与提示词文件），在对话输入框中发送以下指令创建应用草稿：
在默认空间帮我创建一个名为“企业售后客服助手”的 Claw 模式应用，设定角色为耐心、专业的企业售后顾问，先保存在草稿，不要直接发布。
WorkBuddy 会在云端创建该应用，并在当前文件夹下生成项目配置文件（adp.jsonc）与角色提示词文件（instructions.md），同时将售后顾问人设同步至云端开发草稿。
3. 将准备好的业务知识文档（例如 faq.md 或产品说明 PDF）放入当前文件夹，在对话输入框中发送以下指令导入知识库：
把当前文件夹里的 faq.md 导入到“企业售后客服助手”的知识库里，并帮我看看文档解析完成了没有。
WorkBuddy 会将文档上传至该应用的默认知识库，自动跟踪异步切分与向量化进度，并在解析完成后提示您文档已就绪。
4. 在开发草稿阶段继续调优提示词或挂载工具。例如在对话输入框中发送以下指令：
帮我修改一下客服助手的提示词：要求每次回答退换货问题时，先安抚用户情绪，再分步骤列出寄回地址和注意事项，同步到云端草稿。
WorkBuddy 会更新本地提示词并同步至云端开发草稿。
说明：
平台严格隔离开发草稿与线上发布版本。日常调整提示词、挂载插件或绑定知识库时，WorkBuddy 默认仅更新开发草稿，不会影响线上已发布版本的正常服务。
5. 确认草稿与知识库准备就绪后，在对话输入框中发送以下指令预览变更、正式发布并进行对话测试：
先帮我预览一下“企业售后客服助手”这次准备发布的变更内容，确认没问题后正式发布上线（备注：首发上线），最后帮我发一条测试消息问问“商品收到破损怎么退换”。
WorkBuddy 会先展示本次草稿相较于线上版本的变更明细，经您确认后发布正式版本，并向刚发布的线上版本发送测试问题。当对话窗口返回智能体针对退换货问题的流式回答时，说明应用已成功发布上线。
常见问题
1. 在本机授权网页单击验证并保存后提示失败怎么办？
请按以下顺序排查：
核对所选站点：以 AKID 开头的腾讯云公有云密钥必须在站点下拉框中选择公有云；从独立站获取的密钥必须选择独立站。
检查密钥内容：确认粘贴的 SecretId 与 SecretKey 首尾不含多余空格，且密钥处于启用状态。
检查子账号权限：若使用腾讯云子账号，请联系管理员确认已授予智能体开发平台相关访问策略。
2. WorkBuddy 提示连接器授权超时怎么办？
为保障凭证安全，每次弹出的本机授权网页有效期为 5 分钟。若超过 5 分钟未提交密钥，网页会自动失效并关闭。请返回 WorkBuddy 的连接器管理面板，在腾讯云 ADP 卡片上重新单击连接生成新的授权页面。
3. 为什么修改了提示词后，在对话测试中仍看到旧的回复逻辑？
在线对话测试访问的是最近 1 次已发布的线上版本，而日常修改默认仅保存在开发草稿中。请在对话窗口中向 WorkBuddy 发送“帮我把当前应用草稿正式发布上线”，待发布完成后再发起对话测试。
4. 新版本发布上线后效果不理想，如何快速恢复？
每次正式发布都会生成独立的历史版本快照。您只需在对话窗口中向 WorkBuddy 发送“帮我查看企业售后客服助手的历史发布记录，并回滚到上一个版本”，经确认后即可恢复至先前的稳定版本。
5. 为什么在独立站账号下无法直接上传本地知识库文档或部署工作流画布？
本地文档一键上传导入知识库与本地工作流画布部署功能目前仅支持腾讯云公有云站点。在使用 ADP 独立站账号时，您可以在 WorkBuddy 中通过自然语言管理工作空间、创建与配置应用、管理智能体与技能、配置渠道、发布版本及发起对话测试；知识库文档上传与工作流编排请前往独立站网页控制台完成。
6. 遇到不熟悉的渠道配置或平台报错时，如何在对话中快速排查？
连接器内置了腾讯云官方文档实时检索能力。当配置企业微信、微信公众号、钉钉机器人接入或遇到平台报错时，您可以直接向 WorkBuddy 发送“帮我查阅腾讯云 ADP 官方文档中关于企业微信渠道配置的要求，并检查当前配置”，由 WorkBuddy 自动拉取最新官方文档为您核对并给出修复建议。
