在 WorkBuddy 调用茶语客员工

先了解：两端怎样协作

你在 WorkBuddy 里提出需求，由连接器把任务交给获准调用的茶语客员工。员工执行后，WorkBuddy 读取进度、结果或需要你补充的问题。茶语客负责员工、任务权限和员工用量，WorkBuddy 负责发起调用与展示返回内容。

这篇教程介绍当前已上线的联动方式：WorkBuddy 调用茶语客员工，茶语客向它返回结果和追问。茶语客主动向 WorkBuddy 派单，需要另外的授权和功能接入，当前生产版尚未提供。两端的全部聊天记录也不会因这条连接自动同步。

适合先练习文字草稿、文本分析和问答。当前连接可以创建任务、查询进度和结果、回答追问、取消未结束任务；发布内容、发私信、浏览器操作、代码执行和附件任务不在本连接的执行范围内。WorkBuddy 与茶语客员工调用的模型可能分别计费，使用前核对两端账号的额度与用量规则。

一、准备账号、员工和模型

1. 登录自己的茶语客工作台，确认有 API 使用权益，并选定本次工作的团队和工作空间。
2. 确认已经启用适合工作的员工，并配好可用的模型和额度。下面以“营销运营官”处理文字草稿为例；自己的列表没有这个员工时，联系管理员准备，或改用实际获准的员工。
3. 安装并登录 WorkBuddy，确认该电脑能访问 https://agent.ynsmhy.com。使用正式服务无需在电脑上安装茶语客的数据库或后端。

完成标志：茶语客员工可用，WorkBuddy 已登录，账号和模型都具备本次文字任务所需的权限与额度。

二、在茶语客授权员工

1. 进入 资源 → API中转 → 员工 API，也可直接打开员工 API。
2. 在“选择我的员工”中选中需要使用的员工，点击“发布为 API”。已经出现在“已发布员工”列表中的员工，无需重复发布。团队员工由所有者或管理员操作。
3. 进入 资源 → 连接中心，选择 WorkBuddy。打开连接中心。
4. 填写便于管理的连接名称，例如“我的 WorkBuddy 营销电脑”，在“允许调用的员工”中只勾选本次需要的员工。
5. 本篇后面要创建文字任务，保持“仅查询，不允许创建、回答或取消任务”不勾选。如果你只需要检查连接和查看员工列表，可以选择仅查询。
6. 点击“创建30天专用 Key”，再点击“复制完整配置”和“检查茶语客连接”。检查通过后，还要在 WorkBuddy 验证员工列表与实际任务。

完整 Key 只在创建后的当前页面内存中暂存，刷新或离开后无法再次查看。复制的完整配置含真实 Key，只粘贴到自己的 WorkBuddy 连接设置中；页面上的占位符预览不能直接用来连接。每位同事用自己的账号创建连接，不共用验收账号或其他人的 Key。

完成标志：已选定员工，取得自己的完整配置，茶语客连接检查通过。

三、在 WorkBuddy 添加自定义 MCP

1. 打开 WorkBuddy 左侧的专家·技能·连接器 → 连接器 → 自定义连接器 → 添加 MCP。英文界面对应 Experts · Skills · Connectors → Connectors → Custom connectors → Add MCP；不同客户端版本以实际入口为准。
2. 粘贴上一步取得的完整配置。如果已经有其他连接器，只把新条目合并到现有的 mcpServers 中，保留其他条目。
3. 将这个新条目的名称改成 chayuke-production，点击 Save / 保存。
4. 出现信任或授权提示时，由本人阅读并确认；保存后确认该连接器已启用。若当前任务未启用它，在任务输入框的 ＋ → 连接器 中开启。

下面是脱敏配置示例。优先使用茶语客“复制完整配置”取得的版本；示例中的占位符必须替换成自己的专用 Key：

{
  "mcpServers": {
    "chayuke-production": {
      "type": "streamableHttp",
      "url": "https://agent.ynsmhy.com/mcp",
      "headers": {
        "Authorization": "Bearer REPLACE_WITH_YOUR_MCP_KEY"
      },
      "timeout": 30000
    }
  }
}

地址应精确为 https://agent.ynsmhy.com/mcp，不要增加末尾斜杠、中文标点或空格。Bearer 与 Key 之间保留一个空格。timeout 是一次连接请求的超时设置，不是整个业务任务的执行时限。

市场连接器的安装方式以实际上架状态为准。本文采用当前可用的自定义 MCP 方式，连接成功后即可继续操作。WorkBuddy 的 MCP 配置字段可参阅官方连接器文档。

四、先检查连接，不急着派任务

在 WorkBuddy 新建工作任务，粘贴下面这段话。这里只做连接和员工检查：

只使用 chayuke-production 连接器。
调用 chayuke_connection_get 检查连接，再调用 chayuke_agents_list 列出我获准调用的员工。
展示连接状态、到期时间及其时区、员工名称和实际返回的 agent_code。
暂时不要创建任务，也不要调用其他连接器。

正常执行连接提供 8 个工具；只读 Key 提供 5 个工具。工具已发现说明连接具备调用条件，下一步还要用一个小任务验证业务流程。

完成标志：连接有效，到期时间正常，员工列表出现自己勾选授权的员工。后续使用列表实际返回的员工编号。

五、发起第一条文字草稿任务

下面的示例交给营销运营官写一份产品演示邀约，不需要上传文件，也不会发送或发布内容。可以直接复制到 WorkBuddy：

只使用 chayuke-production 连接器，先查询授权员工列表，选择“营销运营官”，使用列表实际返回的 agent_code；没有这个员工就说明并停止。

生成新的唯一 request_id，保存并告诉我，再调用 chayuke_task_create，完整转交以下需求：

为茶语客 AI 员工平台写一份面向茶企老板的产品演示邀约草稿。
已确认的能力：授权员工可生成文字草稿和文本分析；用户可查询任务进度和结果、回答员工追问、取消未结束任务。当前 WorkBuddy MCP 连接只执行文字草稿与问答。
交付：一段简短产品介绍、一条自然的演示邀约、业务负责人待确认清单。
不编造价格、客户案例、节省比例或数据存储与保密承诺；未知信息和演示时间标注“待确认”。直接写草稿，不查询外部资料，不调用其他业务工具，不发送或发布内容。

创建后查询一次原任务。未完成就展示 request_id、task_id 和状态，结束本轮，等我要求继续查询。
完成后展示员工原始结果、最终状态和已返回的用量；没有用量字段时说明未返回。
如果提交超时，先用原 request_id 查询回执，不换编号重复提交。

把返回的 request_id 和 task_id 留在同一会话里。前者用于找回这次请求，后者用于跟踪已经创建的任务。创建返回“已接收”或 accepted，表示任务已经收到，还需要继续查看最终状态。

六、查进度、读结果，再人工验收

如果任务还在执行，稍后在同一会话发送：

继续使用 chayuke-production 查询刚才的原任务，不要重新创建。
完成后展示员工原始结果、最终状态和已返回的用量。
如果正在等待补充资料，展示员工的原问题，等我回答。
本轮先查询一次，没有完成就保留编号和状态。

查询遵守接口返回的建议间隔，至少间隔 5 秒；同一轮最多查询 6 次，仍未完成就保存编号，稍后继续。员工结果是待核对的草稿，价格、事实、承诺和对外表达仍要由业务负责人确认。

七、员工追问时怎样回答

只有任务处于 waiting_user 时，才使用当前问题的 ask_id 提交答复。例如员工询问演示时间，你可以回复：

我的答复是：“演示时间还未确定，请标注双方确认后再安排。”
请使用原任务，重新确认当前有效的 ask_id。
为这次答复生成独立的 request_id，再调用 chayuke_task_reply 提交上面的原话。
提交后查询一次原任务；未完成就保留状态，不要新建任务。

将引号里的内容换成你的真实答复。任务已经结束后，需要修改交付内容时，另建一个新任务并使用新的请求编号；不要向已经失效的问题重复提交答复。

八、超时、断线或需要停止时

提交超时：先找回原请求

上一次提交没有收到确定结果。
请使用之前保存的原 request_id 调用 chayuke_request_get。
找到 task_id 就查询原任务；回执仍是 pending 或 uncertain 时只报告状态，不重新创建。

同一次操作重试，复用原请求编号和原参数；新的工作使用新的编号。创建任务、回答追问、取消任务分别有各自的请求编号。

需要停止：明确取消原任务

请停止刚才未结束的任务。
使用原 task_id，为取消生成独立 request_id，调用 chayuke_task_cancel。
随后查询原任务，告诉我最终状态，不再创建后续任务。

关闭 WorkBuddy、关闭会话或撤销 Key，都不能替代任务取消。取消也不会撤销已经发生的模型费用，以最终用量记录和服务商账单为准。

九、在两端核对这次交付

• WorkBuddy：保留请求编号、任务编号、员工原始结果、最终状态和错误时的 trace_id（如有）。
• 茶语客：确认本次员工和连接的授权、所属团队及有效期。需要核对原始任务、用量或错误时，由有权限的管理员按任务编号检查对应记录。
• 业务验收：确认是同一条任务，最终成功且有实际输出，再逐项核对交付。看到工具列表、连接检查通过或任务已接收，都是过程节点。

跑通标准：连接有效 → 员工可见 → 创建取得任务编号 → 原任务最终成功 → WorkBuddy 显示员工结果 → 业务负责人验收。

十、Key 到期与日常交接

专用 Key 默认有效期为 30 天，以自己页面返回的时间为准。到期前，在茶语客创建新 Key、重新选择所需员工，在 WorkBuddy 替换配置并验证新连接，确认正常后撤销旧 Key。

旧任务绑定创建它的 Key。即使属于同一个账号，新 Key 也不能直接接管旧 Key 的任务。换 Key 前先处理未完成任务并保存需要的结果；已经到期或丢失时，联系管理员核对旧任务。

怀疑 Key 泄露时立即撤销并联系管理员检查。交接同事只需说明连接名称、团队、授权员工、到期时间和本教程；接手同事使用自己的账号创建连接。

常见问题速查

反馈问题时提供脱敏错误、请求编号、任务编号和 trace_id，不提供完整 Key 或 Authorization 请求头。