WorkBuddy 实战手册
WorkBuddy 实战手册

Appearance

连接器与自动化失败排障 ​

适用症状 ​

连接器显示已授权但读不到数据、结果范围不对、MCP 工具调用失败、自动化超时、定时任务没有运行、运行失败后重复写入或发送，都先把问题分成“身份/权限”“数据/配置”“运行状态”“外部副作用”四类。

快速诊断 ​

先暂停写入、发布、发送和删除动作，保存连接器名称、执行账号、授权时间、任务标识、触发时间、输入范围、错误原文、重试次数和目标对象。用测试账号、测试资源和只读查询做对照，不要用扩大权限来判断是否可用。

检查顺序 ​

  1. 身份： 核对实际执行账号、组织/租户、角色、席位和连接器授权人。
  2. 范围： 核对项目、群组、文档、字段、时间范围、分页和过滤条件是否对应测试资源。
  3. 能力： 区分 Tools、Resources、读写操作、通知和删除等能力；能查询不代表能写入。
  4. 运行状态： 查看触发方式、运行标识、当前状态、超时、错误步骤和最后一次成功运行。
  5. 副作用： 目标对象是否已经写入或发送？在未知状态下先查询和人工核对，不能直接重试。

修复路径 ​

授权成功但结果为空或不完整 ​

先用同一账号在测试资源做最小只读查询，分别核对权限、对象范围、分页和时间。若结果仍不确定，保留错误和请求范围，交给连接器负责人或当前官方支持，不让模型填补缺失数据。

连接器调用超时 ​

判断是单个资源、单次网络问题还是所有请求都失败。缩小时间范围和数据量，先运行只读任务；对有副作用的操作不自动重试。连续超时则停用任务并记录最后一次已知状态。

自动化重复或卡在运行中 ​

暂停触发器和外发，按运行标识查找是否已经生成产物或写入目标。确认状态前不重新触发；恢复时增加输入版本、重复保护、超时和人工门禁，并使用自动化监控、重试、幂等与停用的验收清单。

账号或权限过期 ​

不要直接申请全量权限。先确认账号状态、角色、席位、组织策略和连接器授权，再按最小范围重新授权并重做只读测试。人员变更或 Server 来源变化时要重新审核。

验证是否恢复 ​

  • 测试账号和连接器返回的身份、资源和范围可解释；
  • 只读查询结果可以回到原系统抽样核对；
  • 失败任务不会无限重试，未知副作用已经人工确认；
  • 同一输入不会生成重复文件、消息或外部记录；
  • 任务可以停用、回退、恢复，错误和责任人可追踪；
  • 连接器、MCP、触发器、通知和数据保留能力以当前版本和组织配置重新核对。

不要做什么 ​

  • 不要用全组织权限、管理员账号或生产群来验证普通连接器问题；
  • 不要把连接成功、HTTP 成功或任务显示运行中当成业务成功；
  • 不要在未知写入状态下连续点击重试；
  • 不要在 Prompt、日志、截图或错误单中粘贴 API Key、Token、Cookie 和回调密钥；
  • 不要运行来源、版本和网络访问无法确认的 MCP Server 或脚本。

停止与求助信息 ​

出现越权读取、重复外发、数据疑似丢失、凭证泄露、未知扣费、持续服务端错误、任务无法停用或外部状态无法确认时，立即停止。提供脱敏诊断摘要：身份、连接目标、范围、运行标识、时间线、错误、重试、影响和已采取的回退动作。

相关内容 ​

来源与版本说明 ​