通过连接器接入后，系统会在后台自动完成以下工作，你无需打开终端或手动输入任何命令行指令：
·自动准备组件：首次连接或版本更新时，WorkBuddy 自动在后台下载并配置所需工具组件。
·本机网页授权：首次连接自动在系统浏览器弹出本机专属授权页。密钥经校验后仅保存在本机个人目录，不会进入对话记录。
·自动加载技能：连接器内置智能体开发平台的领域技能知识。你在对话中提及相关需求时，WorkBuddy 会自动调用对应能力执行操作。
一、前提条件
在连接之前，请根据你所使用的智能体开发平台站点准备访问密钥（SecretId 和 SecretKey）。公有云与独立站属于两套独立的账号体系，请按以下对应方式获取：
| 站点类型 | 适用人群 | 密钥获取方式 |
| 腾讯云公有云 | 使用腾讯云控制台的用户 | 前往 腾讯云 CAM API 密钥管理控制台 创建或查看 SecretId（以 AKID 开头）与 SecretKey。若使用子账号，需由管理员授予智能体开发平台相关权限，详情请参见 CAM 权限说明。 |
| ADP 独立站 | 使用独立站的用户 | 登录 ADP 独立站控制台，或点击右上角头像，选择企业管理 > 密钥管理 > 新建 API 密钥，创建并复制 SecretId 与 SecretKey（不以 AKID 开头）。 |
| 自定义地址 | 使用私有化部署或专属网关的企业用户 | 联系企业管理员获取服务访问地址及配套的 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 卡片状态显示为已连接。
注意：说明：
四、步骤 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. 遇到不熟悉的渠道配置或平台报错时，如何在对话中快速排查？
连接器内置了腾讯云产品文档实时检索能力。当配置企业微信、微信公众号、钉钉机器人接入或遇到平台报错时，你可以直接向 WorkBuddy 发送“帮我查阅腾讯云 ADP 产品文档中关于企业微信渠道配置的要求，并检查当前配置”，由 WorkBuddy 自动拉取最新产品文档为你核对并给出修复建议。