> 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.

# 常见问题与排障

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

## 员工只回答，没有执行

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

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

## 技能未触发或选择错误

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

## 常见问题对照

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

## 处理权限与连接问题

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

## 记录并复现

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

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

相关文档：[验收](https://docs.danqiuos.com/operations/acceptance.md)、[组织权限](https://docs.danqiuos.com/platform/security.md)、[企业连接](https://docs.danqiuos.com/platform/integrations.md)。