使用问题排查

功能概述

先确定问题发生的入口、资源和操作步骤，再检查对应配置与运行记录。以下按使用场景列出常见现象与处理方法。

1. 登录、入口与权限

现象	检查与处理
找不到业务菜单	在 Saber 宿主检查当前角色的菜单与按钮权限
分享页提示无权访问	检查身份、资源使用权与匿名访问配置
运行页不可操作	检查资源启用状态，恢复后重新打开页面

入口说明见 入口与工作区导航。开发调试环境的凭证与联调问题见技术手册 AI 业务独立调试。

2. 模型与应用

现象	检查与处理
模型连接失败	核对接口地址、模型标识与 API Key，查看连接反馈
草稿正确而运行页结果不同	核对资源与线上版本；草稿改动重新发布后，从发布左侧 运行 打开线上版本核对
流程变量不可选	完成上游连线，核对输出字段与数据类型
流程无法连续对话	配置对话流程的模型输入和结束流式来源；需要内置记忆时使用对话编排
人工确认停在等待状态	在运行页提交对应选项，回到执行过程核对恢复分支

详细步骤见 大模型、流程编排 与 节点配置与变量引用。

3. 知识检索与问数

现象	检查与处理
上传后资料不可检索	在数据集检查摄取任务、分段正文与向量状态
召回结果为空	核对启用分段、向量模型维度、阈值和问题表述
回答缺少依据	展开检索片段，核对引用是否支持结论
问数生成错误 SQL	检查数据源、已保存选表、字段说明、术语和示例
SQL 正确而图表不符	对照原始数据，核对分类、指标与系列映射

先通过 命中测试与知识问答 或 SQL 查询控制台 取得可对照的结果，再调整问答配置。

4. 创作与扩展

材料上传后先确认解析完成并勾选，再提交创作任务。生成完成后逐条检查建议并选择采纳，再分别核对作品的版式、事实和版本。

MCP、插件与外部平台调用失败时，先在各自资源页核对参数与调试结果，再检查引用它们的流程节点。消息投递同时检查模板变量、渠道配置与接收端结果。

5. 记录与接口

保留资源主键、发生时间、运行标识和具体错误。在资源 日志 检查输入、输出与失败节点，在 会话记录 回放上下文，在 用量账单 核对模型计量。

HTTP 401 优先检查 API 密钥与到期时间。流式响应先核对内容类型和对应协议；原生执行、兼容对话与工作区调试事件使用不同结构。技术说明见 响应协议与异常处理。