Senparc.Xncf.KnowledgeBase
0.6.0-preview8
Prefix Reserved
dotnet add package Senparc.Xncf.KnowledgeBase --version 0.6.0-preview8
NuGet\Install-Package Senparc.Xncf.KnowledgeBase -Version 0.6.0-preview8
<PackageReference Include="Senparc.Xncf.KnowledgeBase" Version="0.6.0-preview8" />
<PackageVersion Include="Senparc.Xncf.KnowledgeBase" Version="0.6.0-preview8" />
<PackageReference Include="Senparc.Xncf.KnowledgeBase" />
paket add Senparc.Xncf.KnowledgeBase --version 0.6.0-preview8
#r "nuget: Senparc.Xncf.KnowledgeBase, 0.6.0-preview8"
#:package Senparc.Xncf.KnowledgeBase@0.6.0-preview8
#addin nuget:?package=Senparc.Xncf.KnowledgeBase&version=0.6.0-preview8&prerelease
#tool nuget:?package=Senparc.Xncf.KnowledgeBase&version=0.6.0-preview8&prerelease
Senparc.Xncf.KnowledgeBase
Senparc.Xncf.KnowledgeBase is an NCF module for importing text sources, publishing versioned vector collections, and providing RAG retrieval to other XNCF modules.
Features
- Stores inline text and FileManager source IDs as independently traceable chunks.
- Extracts supported source files through FileManager, then performs one bounded, overlapping chunk pass.
- Publishes a new timestamped vector collection only after every chunk has been written successfully, so readers never see a half-built collection.
- Uses the configured
TextEmbeddingmodel for both indexing and retrieval and exposes source names in recall results. - Provides bounded retry, top-K limits, RAG context length limits, and fail-fast validation for unsupported vector stores.
- Protects management, import, and recall APIs with the NCF
AdminOnlypolicy. - Includes matching migrations for Dm, MySql, Oracle, PostgreSQL, SqlServer, and Sqlite.
Installation
<PackageReference Include="Senparc.Xncf.KnowledgeBase" Version="0.4.0-preview5" />
Key API
KnowledgeBaseService.CreateOrUpdateAsyncsynchronizes metadata, inline content, and selected FileManager files.KnowledgeBaseService.EmbeddingKnowledgeBaseAsyncbuilds and atomically publishes a new vector collection.KnowledgeBaseService.RecallTestAsyncandBuildRagContextAsyncprovide retrieval and bounded context generation.KnowledgeBaseItemAppServicesupports management-page source/chunk inspection.RecallTestAppServicesupports administrator retrieval evaluation.
Current boundaries
- Persistent KnowledgeBase retrieval currently supports Redis and Qdrant. In-memory stores are rejected because they do not survive a request-scoped runner; other vector providers require an AgentKernel adapter before they can be enabled safely.
- PDF, legacy Office, images, audio, OCR, web crawling, automatic collection cleanup, reranking, and document-level ACL filtering are not implemented.
- A FileManager source is ingested as a snapshot. Deleting or changing the original file does not silently rewrite an already published knowledge collection; re-import and re-embed explicitly.
- Vector-store and model credentials remain host configuration. Do not index secrets or restricted documents without a tenant/document permission policy.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Microsoft.Agents.AI (>= 1.8.0)
- Microsoft.Agents.AI.Abstractions (>= 1.8.0)
- Microsoft.Extensions.AI.OpenAI (>= 10.5.1)
- Microsoft.Extensions.FileProviders.Embedded (>= 10.0.2)
- OllamaSharp (>= 5.4.25)
- OpenAI (>= 2.10.0)
- Senparc.AI (>= 0.27.4)
- Senparc.AI.AgentKernel (>= 0.1.11)
- Senparc.CO2NET.WebApi (>= 2.1.9-preview)
- Senparc.Ncf.AreaBase (>= 0.23.3-preview7)
- Senparc.Ncf.DatabasePlant (>= 0.21.7-preview7)
- Senparc.Ncf.Service (>= 0.23.7-preview7)
- Senparc.Xncf.AIKernel (>= 0.15.3-preview10)
- Senparc.Xncf.AreasBase (>= 0.13.5-preview7)
- Senparc.Xncf.FileManager (>= 0.6.0-preview1)
- System.ClientModel (>= 1.11.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Senparc.Xncf.KnowledgeBase:
| Package | Downloads |
|---|---|
|
Senparc.Xncf.AgentsManager
Agents 管理模块 |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.6.0-preview8 | 0 | 8/12/2026 |
| 0.5.1-preview7 | 53 | 8/8/2026 |
| 0.5.0-preview6 | 66 | 8/3/2026 |
| 0.4.0-preview5 | 55 | 7/31/2026 |
| 0.3.1-preview4 | 52 | 7/28/2026 |
| 0.3.0-preview3 | 55 | 7/26/2026 |
| 0.2.3-preview2 | 173 | 7/15/2026 |
| 0.2.2-preview1 | 65 | 7/3/2026 |
| 0.2.1-preview1 | 69 | 6/17/2026 |
| 0.1.11.1-preview | 74 | 5/22/2026 |
| 0.1.2-preview | 75 | 6/16/2026 |
v0.1 创世
[2025-07-27] v0.1.5-preview1s update Knowledge Base
[2025-11-01] update basic libraries, including Senparc.AI
[2025-01-07] v0.1.8-preview.1 Reset all database migrations
[2026-04-24] Simplify FunctionRender request parameters and keep SelectionList UI metadata compatibility
[2026-07-02] v0.2.2-preview1 新增 PromptRange 与 AgentsManager 使用记录能力,升级 Senparc.AI.AgentKernel 并完成兼容性适配
1、新增 PromptRange 与 AgentsManager 使用记录能力
2、升级 Senparc.AI.AgentKernel 并完成兼容性适配
[2026-07-07] v0.2.3-preview2 Dependency updates from upstream modules
1、Dependency update from Senparc.Xncf.AIKernel to 0.13.5-preview4
2、升级 Senparc.AI 至 0.27.3、Senparc.AI.AgentKernel 至 0.1.10
[2026-07-17] v0.3.0-preview3 为 KnowledgeBase 模块接入统一资源本地化并优化功能文案
1、接入统一资源本地化机制,支持模块功能文案按当前文化动态显示
2、更新 FunctionRender 与请求模型文案的资源化解析
3、统一模块注册信息、菜单名称与功能描述的本地化输出
4、同步管理页面与前端交互文案的多语言显示
5、同步 AIKernel 0.14.0-preview5 的 NeuChar 模型 API 版本适配
[2026-07-29] v0.3.1-preview4 通过文件服务读取知识库文件并限制物理路径
1、复用 NcfFileService 读取文件内容,统一文件存储边界校验
2、避免篡改数据库路径字段后直接访问站点外部文件
[2026-07-31] v0.4.0-preview5 扩展 KnowledgeBase 管理界面的多语言能力
1、补齐知识库编辑、检索测试、菜单与交互文案的多语言资源
2、升级 Senparc.AI 组件与 CO2NET WebApi 兼容依赖
[2026-08-04] v0.5.0-preview6 新增知识库生命周期管理与 Agent 模板集成
1、扩展知识库及条目生命周期字段并补齐六类数据库迁移与快照
2、完善知识库管理页、应用服务、召回测试与请求响应模型
3、支持 AgentsManager 按知识库状态完成关联和调用
[2026-08-08] v0.5.1-preview7 Dependency updates from upstream projects
1、Dependency update from Senparc.Ncf.AreaBase to 0.23.2-preview6
2、Dependency update from Senparc.Ncf.DatabasePlant to 0.21.6-preview6
3、Dependency update from Senparc.Ncf.Service to 0.23.6-preview6
4、Dependency update from Senparc.Xncf.AIKernel to 0.15.2-preview9
5、Dependency update from Senparc.Xncf.FileManager to 0.5.1-preview6
6、Dependency update from Senparc.Xncf.AreasBase to 0.13.4-preview6
[2026-08-13] v0.6.0-preview8 完善知识库文件删除保护、召回测试与管理界面
1、增加知识库文件删除边界保护并同步资源服务策略
2、优化知识库列表、召回测试页面及多语言交互反馈
3、适配统一 Agent 执行和文件资源边界变更