知识空间

简述

知识空间用于把符合规范的 Git 仓库挂载为租户级知识库：同步拉取分支上的文档并解析为可检索切片，供 工具管理 中的搜索或文档查询工具绑定使用。您可以在列表查看同步进度与文档数量，进入详情后管理文档、触发增量或全量同步、浏览解析日志，并在 权限引擎 中配置访问规则。

功能位置

点击侧边栏 知识空间。页面标题 知识空间，右上方 新建知识库。

配置与规则

• 点击名称所在行进入知识库详情。
• 编辑：跳转表单页修改绑定信息与凭证。
• 删除：弹出 删除知识库，确认按钮 确定删除。成功后提示「删除成功」。

新建与编辑

表单分为 基本信息 与 Git 绑定 两块，顶部 保存 提交。

基本信息

• 知识库名称：必填，不超过 64 个字符。
• 描述：选填，不超过 256 个字符。

Git 绑定

• 仓库地址：必填，使用 HTTPS。
• 分支：默认 main，可按仓库习惯修改。
• 认证方式：无或 Token；选择 Token 时需填写访问令牌。
• 表单底部说明仓库需符合《可编程文档规范》：根目录包含 schema/，其它目录存放 .md 文档。

新建成功后提示「创建成功」并返回列表；编辑保存提示「保存成功」同样返回列表。

知识库详情

顶部展示返回箭头、知识库名称，动作区包含 编辑、主按钮 同步并解析 及下拉 全量同步。

文档列表

表格列：标题、路径、切片数、更新时间。默认每页 20 条并带分页。点击行进入单篇 文档详情。

正文提供多枚页签阅读不同视角：数据 Markdown、doc-meta、切片、阅读 Markdown、原文档，便于校对解析质量或导出素材。

同步与解析

展示 上次同步时间、文档数、同步次数。下方 解析日志 列出历次任务，状态徽章包含 运行中、成功、部分成功、失败 等文案，并附带增量或全量标记、文件总数与成功失败统计。展开条目可查看单个文件的解析结果与错误原因。

主按钮 同步并解析 触发增量同步；下拉 全量同步 触发完整对齐。完成后依据结果显示「同步完成」「全量同步完成」

权限引擎

提供面向该知识库的权限规则维护界面，用于约束文档或切片在不同主体下的可见性；规则保存后与检索链路联动。

注意事项

• Token 仅保存在服务端用于拉仓，请在仓库侧定期轮换并同步更新表单。
• 全量同步耗时长且会重建索引，建议在业务低峰执行。
• 删除知识库会断开所有引用该空间的工具绑定配置，请先调整 Agent 工具列表。

与其他功能的关系

• 工具管理：搜索与文档查询工具在「知识库绑定」分区选择此处创建的知识空间。
• 帮助中心：发布站点时 Tab 可映射知识库中的文档目录。
• 渠道 / 会话：不直接依赖知识空间，但通过 Agent 与工具间接消费检索结果。

业务场景示例

文档随 Git 迭代自动上架

角色与目标
技术写作团队在 Git 维护手册，希望控制台每周展示最新章节。

系统配置
创建知识空间指向团队仓库与分支，启用 Token 拉取；工作日使用 同步并解析，发版日执行 全量同步 兜底。

场景效果
工具检索命中内容与仓库 HEAD 对齐；解析日志可快速定位失败文件。