For AI agents: the complete documentation index is available at https://docs.danqiuos.com/llms.txt, the full documentation bundle is available at https://docs.danqiuos.com/llms-full.txt, and this page is available as Markdown at https://docs.danqiuos.com/operations/troubleshooting.md.

常见问题与排障

先定位失败环节,再修改配置。常见运行链路是:触发 → 身份 → 上下文 → 技能 → 工具 → 数据或系统 → 人工确认 → 输出与留痕。

员工只回答,没有执行

依次检查岗位是否应该承担该任务、Skill 是否启用并绑定、对应 Toolkit 是否授权、必需输入是否齐全,以及当前请求是否匹配技能触发条件。

用一个更明确的最小任务复现,例如“读取指定订单台账,列出约定交期已过且尚未完成的记录”。检查是否出现对应工具轨迹,而不是只给 prompt 增加“主动调用工具”。

技能未触发或选择错误

检查多个 Skill 是否职责重叠、描述是否贴近业务动作、常驻规则是否定义了路由。用不同真实话术测试同一意图,并加入相近但不该触发的反例。

常见问题对照

症状优先检查修复后验证
数据不存在或字段错误应用/表标识、字段 key、当前身份权限独立回读实际记录
计划任务不执行启用状态、时区、触发时间、目标员工人工试跑和下一次触发记录
消息未送达接收人绑定、渠道连接、发送权限实际送达记录与接收端
浏览器操作失败登录状态、页面变化、风控与人工接管重新执行最小网页操作
交付物打不开文件生成、工作区查看与成果提交范围用实际接收人打开;未授权者不可见
资料上传后搜不到目标知识库、处理进度、语义索引、查询权限用已知问题检索并核对引用
任务不能流转项目允许的状态迁移、角色与工作区范围合法路径成功,非法跳步被阻止
内网查询失败设备在线、目标网络、服务发现、Secret 引用用目标员工完成真实查询
网页已登录但操作失败账号权限、页面改版、登录态过期恢复正确登录态后验证业务结果
应用只显示演示数据目标账号与 Team、Feature、真实后端连接真实记录或真实空状态,写入可回读
应用发布未完成发布任务状态和错误信息active 与最终地址、直接打开及刷新业务页
CLI 参数报错本机版本、该命令当前帮助、来源版本按当前契约小范围验证,不猜旧别名
任务卡住是否等待人工、依赖任务或外部系统完成前置条件后的状态推进

处理权限与连接问题

不要通过临时放大全部权限绕过问题。先确认请求者、员工、团队和资源之间的关系,再检查业务所需的最小范围。涉及验证码、重新登录或风险确认时,交给相应人员处理。

记录并复现

保留环境与版本、目标团队、最小输入、预期结果、实际状态、工具轨迹和错误信息。分享排障记录前移除凭据与不必要的业务内容。

修复后重新运行原始失败用例,再核对相关正常用例。如果权限、数据或部署版本不支持该能力,应记录限制,不把未支持能力写成已修复。

相关文档:验收、组织权限、企业连接。