Senparc.Xncf.KnowledgeBase
0.8.4
Prefix Reserved
dotnet add package Senparc.Xncf.KnowledgeBase --version 0.8.4
NuGet\Install-Package Senparc.Xncf.KnowledgeBase -Version 0.8.4
<PackageReference Include="Senparc.Xncf.KnowledgeBase" Version="0.8.4" />
<PackageVersion Include="Senparc.Xncf.KnowledgeBase" Version="0.8.4" />
<PackageReference Include="Senparc.Xncf.KnowledgeBase" />
paket add Senparc.Xncf.KnowledgeBase --version 0.8.4
#r "nuget: Senparc.Xncf.KnowledgeBase, 0.8.4"
#:package Senparc.Xncf.KnowledgeBase@0.8.4
#addin nuget:?package=Senparc.Xncf.KnowledgeBase&version=0.8.4
#tool nuget:?package=Senparc.Xncf.KnowledgeBase&version=0.8.4
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.28.0)
- Microsoft.Agents.AI.Abstractions (>= 1.28.0)
- Microsoft.Agents.AI.Harness (>= 1.28.0)
- Microsoft.Extensions.AI.OpenAI (>= 10.11.0)
- Microsoft.Extensions.FileProviders.Embedded (>= 10.0.2)
- OllamaSharp (>= 5.4.25)
- OpenAI (>= 2.14.0)
- Senparc.AI (>= 0.27.4)
- Senparc.AI.AgentKernel (>= 0.1.17)
- Senparc.CO2NET.WebApi (>= 2.1.9-preview)
- Senparc.Ncf.AreaBase (>= 0.23.12)
- Senparc.Ncf.DatabasePlant (>= 0.21.16)
- Senparc.Ncf.Service (>= 0.23.13-preview12)
- Senparc.Xncf.AIKernel (>= 0.17.4)
- Senparc.Xncf.AreasBase (>= 0.13.14)
- Senparc.Xncf.FileManager (>= 0.8.5)
- System.ClientModel (>= 1.16.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Senparc.Xncf.KnowledgeBase:
| Package | Downloads |
|---|---|
|
Senparc.Xncf.AgentsManager
Agents managementmodule |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.8.4 | 0 | 11/19/2026 |
| 0.8.3 | 89 | 11/11/2026 |
| 0.8.2 | 62 | 11/5/2026 |
| 0.8.1 | 82 | 11/2/2026 |
| 0.7.6 | 83 | 10/10/2026 |
| 0.7.5 | 83 | 10/4/2026 |
| 0.7.4 | 103 | 9/18/2026 |
| 0.7.3 | 87 | 9/16/2026 |
| 0.7.2 | 91 | 9/15/2026 |
| 0.7.1 | 135 | 8/29/2026 |
| 0.7.0 | 219 | 8/23/2026 |
| 0.7.0-preview9 | 138 | 8/14/2026 |
| 0.6.0-preview8 | 125 | 8/12/2026 |
| 0.5.1-preview7 | 133 | 8/8/2026 |
| 0.5.0-preview6 | 139 | 8/3/2026 |
| 0.4.0-preview5 | 131 | 7/31/2026 |
| 0.3.1-preview4 | 89 | 7/28/2026 |
| 0.3.0-preview3 | 93 | 7/26/2026 |
| 0.2.3-preview2 | 211 | 7/15/2026 |
| 0.2.2-preview1 | 97 | 7/3/2026 |
[2025-01-07] v0.1.8-preview.1 Reset all database migrations
[2025-07-27] v0.1.5-preview1s update Knowledge Base
[2025-11-01] update basic libraries, including Senparc.AI
[2026-04-24] Simplify FunctionRender request parameters and keep SelectionList UI metadata compatibility
[2026-07-02] v0.2.2-preview1 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[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. Updated module behavior and related support.
[2026-07-17] v0.3.0-preview3 Updated module behavior and related support.
1. integrateshared resource-localization mechanism, supportmodulefeature textdisplay dynamically according to the current culture
2. Updated module behavior and related support.
3. Updated module behavior and related support.
4. Updated module behavior and related support.
5. Updated module behavior and related support.
[2026-07-29] v0.3.1-preview4 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[2026-07-31] v0.4.0-preview5 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[2026-08-04] v0.5.0-preview6 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
3. Updated module behavior and related support.
[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 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
3. Updated module behavior and related support.
[2026-08-15] v0.7.0 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
3. Dependency update from Senparc.Xncf.AIKernel to 0.15.4
4. Updated module behavior and related support.
[2026-08-29] v0.7.1 Dependency updates from Senparc.Ncf.DatabasePlant to 0.21.10; Dependency update from Senparc.Ncf.Service to 0.23.9-preview9
1. Dependency update from Senparc.Ncf.DatabasePlant to 0.21.10
2. Dependency update from Senparc.Ncf.Service to 0.23.9-preview9
[2026-09-15] v0.7.2 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
3. Updated module behavior and related support.
[2026-09-16] v0.7.3 Dependency updates from Senparc.Xncf.AgentsManager to 0.17.2; Senparc.Web to 0.39.1
[2026-09-17] v0.7.4 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[2026-10-21] v0.7.7 adapt Senparc.AI.AgentKernel 0.1.15-preview2
1. Updated module behavior and related support.
[2026-11-03] v0.8.0 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
3. Updated module behavior and related support.
4. Updated module behavior and related support.
5. Updated module behavior and related support.
6. Updated module behavior and related support.
7. Updated module behavior and related support.
[2026-11-03] Add contextual documentation for knowledge-base setup and recall-test Top K.
[2026-11-05] v0.8.2 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
3. Dependency update from Senparc.Ncf.AreaBase to 0.23.10
4. Dependency update from Senparc.Ncf.DatabasePlant to 0.21.14
5. Dependency update from Senparc.Ncf.Service to 0.23.11-preview10
6. Dependency update from Senparc.Xncf.AIKernel to 0.17.2
7. Dependency update from Senparc.Xncf.FileManager to 0.8.3
8. Dependency update from Senparc.Xncf.AreasBase to 0.13.12
[2026-11-11] v0.8.2 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[2026-11-12] v0.8.3 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[2026-11-19] v0.8.4 Localized knowledge base management and runtime surfaces
1. Updated localized labels, resource fallbacks, and user-facing messages across affected surfaces.
2. Kept runtime behavior and module integration aligned with the affected service and registration changes.