Knowledge Sources

Knowledge Source 是平台中用于承载可检索文档集合的业务对象，不只是文件夹。

它负责什么

• 保存默认分块策略与参数
• 管理文档上传、inspect 和 ingestion
• 作为 Agent 挂载的检索来源
• 在某些场景下承担托管纠错来源

主链路

flowchart LR
  Source[Knowledge Source] --> Upload[Upload Document]
  Upload --> Inspect[Inspect / Preview]
  Inspect --> Ingest[Ingestion]
  Ingest --> Chunks[Chunks and Embeddings]
  Chunks --> Mount[Mount to Agent]
  Mount --> Runtime[Chat Retrieval]

Studio 管理页行为

• /knowledge-sources 列表页应稳定渲染知识源清单、搜索入口和详情导航，不应以白屏作为默认结果。
• /knowledge-sources/:sourceId 详情页应在异步数据加载完成后稳定渲染来源标题、文档工作区和检索测试入口，不应因 React hook 顺序变化进入白屏。
• 如果 Studio 查询失败，页面继续使用现有的请求错误态；如果前端渲染期发生运行时异常，页面应降级为受控错误态，而不是直接白屏。

继续阅读

• RAG 系统
• RAG 运维
• Studio Runbooks