第一个知识库

本页从一个全新实例开始，完成身份、模型、信源、文档和第一条带引用回答。Docker 与桌面客户端的操作一致。

1. 创建本地身份

首次打开 SAG 时填写名字。系统会创建或恢复当前本机的单用户身份，并在后续 API 请求中使用 JWT。

本地身份不是公共云账号。默认部署没有第三方登录，也不会把知识上传到 SAG 项目方的服务。

2. 配置模型

打开 设置 -> 模型。你需要两类能力：

可以使用 302.AI 快速配置，也可以填写任意 OpenAI 兼容端点。若 Embedding 与 LLM 使用同一服务，Embedding 的 Key 与 Base URL 可以复用 LLM 配置。

保存前运行连接测试。模型名称必须是服务端实际支持的标识，示例默认值不代表所有兼容服务都提供同名模型。

3. 创建信源

进入 知识库，创建一个信源。信源是文档、索引、图谱和访问范围的逻辑边界；一个 DataEngine 实例也对应一个逻辑信源。

建议使用能说明内容范围的名称，例如“产品文档”“研究论文”或“客户支持手册”，避免使用“测试 1”一类后续难以辨识的名字。

4. 导入文档

打开信源并上传 Markdown、文本、PDF 或 Office 文档。SAG 会按以下状态推进：

已上传 -> 解析中 -> 分块与向量化 -> 事件/实体抽取 -> 就绪

只有状态为 就绪 的文档会稳定参与检索。大文档或远程解析服务会让后台任务持续更久，可以在文档列表查看进度和错误。

5. 检索并核对原文

进入 搜索，先使用快速模式输入一个文档中确实存在的问题。点击任一结果的“查看原文”，确认右侧内容与问题对应。

如果结果范围太广，限制到刚创建的信源；如果问题需要跨段关系，再切换到精确模式。

6. 获取带引用回答

创建新对话，使用 @ 选择知识来源，然后提出同一个问题。回答完成后检查：

• 回答是否附带可点击引用；
• 引用能否打开到具体原文块；
• 回答中的关键事实是否能被引用直接支持。

完成标准

当下面四项都成立时，第一个知识库已经可以使用：

• 文档状态为“就绪”；
• 快速检索能召回相关内容；
• 结果可以打开原文；
• 对话回答包含可验证引用。

接下来可继续阅读导入与解析，或把同一知识库通过MCP交给外部 Agent。