跳到主要内容

对话与运行问题

先检查页面显示的连接状态、错误提示、助手状态标签和配置卡。重复发送同一消息可能导致任务执行两次。

现象排查入口
消息停在发送中、连接状态异常消息发送失败或一直等待
新建对话时选不到助手助手暂不可运行
对话能继续，但显示“能力不完整”能力不完整
回复正常结束，却没用到预期能力结果不对
消息里提到文件，但无法取得文件无法下载

消息发送失败或一直等待​

**连接状态显示正在重连：**等待连接恢复。客户端会继续发送或自动重试，维护更新期间无需再次发送同一消息。

**连接已恢复但消息没有变化：**取消这次发送，再发送一次。页面给出错误码或明确原因时，保留该信息，支持人员可以据此定位。

助手提示「暂不可运行」或无法开始对话​

按页面状态分支处理：

  • **只有“草稿”标签：**维护者需要先发布，草稿不能开始正式对话。
  • **提示缺少技能：**技能可能未发布、已归档或被撤权；维护者应替换依赖并重新发布助手。
  • **出现配置卡：**按卡片补齐必填项。即使你持有密钥，未填写时仍视为缺失。
  • **提示远程连接鉴权失败：**让连接维护者轮换或重新写入凭据；重发消息不会修复失效密钥。

助手显示「能力不完整」但对话仍在继续​

技能归档后，助手会跳过已归档技能，并可能显示「能力不完整」。助手及其他依赖正常时，其他能力继续运行。技能被冻结或不存在，或固定发布版本被撤回、缺失、校验失败时，会阻止该次运行；平台技能被撤回且访问不再满足时，受影响对话还可能变为只读。

缺失的能力正是本次任务需要的能力时，停止当前任务，把助手名称和缺失技能提示交给维护者。维护者移除或替换技能并发布新版本后，需要新建对话验证；旧对话不会自动换版本。

回复没有使用预期技能或结果不对​

先新建一条对话复现。新对话正常时，技能已经保存，差异来自原对话固定使用的旧助手版本。

新对话仍异常时，按依赖类型检查：技能是否挂载在已发布版本；外部服务的主机是否声明、请求是否超时或超限；知识源是否已发布并允许助手检索。一次只改变一个条件，便于定位解决问题的一步。

生成的文件无法下载​

先在工作区文件树里找同名文件。能预览但下载失败，可以重试；文件树里不存在时，助手可能只在回复中写了路径，文件尚未提交到工作区。

文件存在但页面提示无权访问时，确认当前账号仍能打开这条对话。权限收回或内容已经按保留规则清理后，需要管理员处理；重复下载不会恢复文件。

提供对话 ID、问题发生时间、助手名称、页面上的完整错误文字，以及问题能否在新对话中复现。支持信息中禁止包含密码、API Key 或运行配置值。