Senparc.Xncf.PromptRange
0.20.16
Prefix Reserved
dotnet add package Senparc.Xncf.PromptRange --version 0.20.16
NuGet\Install-Package Senparc.Xncf.PromptRange -Version 0.20.16
<PackageReference Include="Senparc.Xncf.PromptRange" Version="0.20.16" />
<PackageVersion Include="Senparc.Xncf.PromptRange" Version="0.20.16" />
<PackageReference Include="Senparc.Xncf.PromptRange" />
paket add Senparc.Xncf.PromptRange --version 0.20.16
#r "nuget: Senparc.Xncf.PromptRange, 0.20.16"
#:package Senparc.Xncf.PromptRange@0.20.16
#addin nuget:?package=Senparc.Xncf.PromptRange&version=0.20.16
#tool nuget:?package=Senparc.Xncf.PromptRange&version=0.20.16
Senparc.Xncf.PromptRange
Senparc.Xncf.PromptRange is an NCF module for organizing prompts, model configurations, prompt results, chat history, scoring, and prompt usage insights.
Features
- Manages prompt ranges, prompt items, model records, and generated results.
- Supports prompt tree/list operations, import/export, score feedback, chat continuation, and history views.
- Provides text embedding search request/response models and multimodal execution options for text, images, audio, speech-to-text, and text-to-speech.
- Emits prompt initialization and optimization events through the companion abstractions package.
Installation
<PackageReference Include="Senparc.Xncf.PromptRange" Version="0.26.0-preview3" />
Key API
PromptRangeService/PromptRangeAppServicemanage prompt ranges and dashboard data.PromptItemService/PromptItemAppServicemanage prompt trees, versions, import/export, and range-name responses.LlmModelService/LlmModelAppServicemanage available language-model metadata.PromptResultService/PromptResultAppServicemanage generated results, robot/human scores, chat continuation, and feedback.PromptTextEmbeddingExecutionOptions,PromptImageController,PromptAudioController, andPromptStreamControllerexpose execution integration points.PromptResult_TextEmbeddingSearchRequestandPromptResult_TextEmbeddingSearchResponsemodel vector-search calls.
The module records prompts, model usage, scores, and generated output. Apply tenant isolation, data retention, PII redaction, provider quotas, and authorization at the host boundary.
Reusable prompt picker
Admin's shared v-prompt-range directive provides an on-demand picker for text inputs,
including both AdminChat composers and the Footer's embedded chat. See the
integration guide.
The following GET methods on PromptItemAppService use the existing AdminOnly policy
and preserve tenant/soft-delete filters on both ranges and items:
GetSelectorOptionsAsync: distinct range/lane metadata for Prompt-kind ranges.SearchSelectorAsync:rangeId(0 = all), exacttactic,keyword(up to 200 characters),pageIndex(1-based),pageSize(1–50, default 10). ReturnsitemsandtotalCount; each item'scontentis a preview of at most 240 characters. Searches name, content, range alias and full version.sortBy=score(default) orders by current score descending, with unrated items last and newer IDs breaking ties;sortBy=promptCodeorders by the full PromptCode string ascending, with newer IDs breaking ties. Sorting runs before pagination. Items and full-content responses includecurrentScore(-1means unrated);evalAvgScoreandevalMaxScoreremain available for older clients as result statistics. The picker displays the current score to one decimal place and resets to page 1 when sorting changes.GetSelectorPromptAsync(id): fetches full content only for the selected prompt.GetSelectorRangeScoresAsync(id): resolves an accessible PromptCode and returns lightweight ID/code/range/lane/current-score entries for all accessible versions in its range, ordered by PromptCode and ID. It contains no prompt text and is not limited to the picker's current page.
AdminChat's default system prompt is also stored through the PromptRange provider under the
AdminChat.SystemMessage range alias. The range is created on first use when PromptRange is
installed. Published versions with a current score (FinalScore, or the legacy average score
before shared scoring exists) are ordered by score; when no published version has a score, the
first published version is used. AdminChat links directly to the PromptRange editor so versions
can be edited, published and scored without changing source code.
The AdminChat SystemMessage settings button first calls the AdminChat initialization endpoint,
then opens /Admin/PromptRange/Prompt?alias=AdminChat.SystemMessage. This makes the range visible
even before the first AI request is sent. To test it, open AdminChat → Memory / 对话设置 →
SystemMessage → 在 PromptRange 中编辑和评分, create or edit a Prompt version, publish it, and
score two versions; the next AdminChat request uses the highest current score.
Admin's independent score-chart component uses this read-only endpoint, loading content and
AI/manual score details only when a bar is clicked. It does not create a range-level rating.
Drafts are labeled and selectable. Selection inserts literal content only; it does not execute prompts/skills, expand variables, copy model settings or send a chat message.
Explicit PromptCode references and shared scoring
IPromptReferenceService (in the abstractions package) validates exact text references
and reads/scores a concrete full PromptCode. It does not rate a range or create usage-rating
records. Each version keeps its AI and manual source scores; the last successfully saved
score wins, regardless of source. FinalScore is only the cached current value, not a
third scoring dimension. Existing PromptResult manual/AI scoring also updates that version.
New scores must be between 0 and 10 with at most one decimal place.
The reusable rating dialog provides a 0.1-step slider and a live draft bar. Dragging or clicking comparison bars never writes scores or changes the rating target. Saving applies only to the explicitly referenced PromptCode; cancelling discards the manual draft.
Before a version receives its first shared score, its old average result score is used for compatibility; historical result scores have no reliable cross-result rating timestamp. Once rated, that average never overrides the shared current value.
GetReferenceInfoAsync(id)returns the full code, source/current scores and benchmark availability.- POST
ScoreReferenceAsync({ id, score })saves the shared manual score under the AdminOnly policy. ScoreWithAIAsync(id, context, result)is a server-side provider operation for authorized hosts. It reuses PromptRange's existing benchmark evaluator, requires a nonempty benchmark/result, and limits both context and result to 64,000 characters. Failed evaluation leaves scores unchanged. Hosts must verify ownership and bind context/result to a stored explicit reference before calling.- Reference validation requires exact content and version, ordered nonoverlapping UTF-16 spans, and at most 32 references. Tenant/soft-delete filters apply to both the item and its range.
Upgrade the PromptRange and Admin databases before using this integration.
Add_PromptCode_Scores and Add_AdminChat_PromptReferences migrations cover SQLite,
SQL Server, MySQL, PostgreSQL, Oracle and Dm. They add nullable columns only; old messages
remain plain text. Generating these migration files does not apply them to a running database.
| 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.Ncf.AreaBase (>= 0.23.12)
- Senparc.Ncf.XncfBase (>= 0.29.1)
- Senparc.Xncf.AIKernel (>= 0.17.4)
- Senparc.Xncf.AreasBase (>= 0.13.14)
- Senparc.Xncf.FileManager.Abstractions (>= 0.2.1)
- Senparc.Xncf.PromptRange.Abstractions (>= 0.3.3-preview8)
- Senparc.Xncf.SystemCore (>= 0.14.14)
- Senparc.Xncf.SystemManager (>= 0.15.14)
- Senparc.Xncf.Tenant (>= 0.15.17)
- System.ClientModel (>= 1.16.0)
NuGet packages (4)
Showing the top 4 NuGet packages that depend on Senparc.Xncf.PromptRange:
| Package | Downloads |
|---|---|
|
Senparc.Xncf.XncfBuilder
Module description. |
|
|
Senparc.Xncf.WeixinManager
NCF module: publishmanagement NCF . managementfeature, extend! SDK Senparc.Weixin SDK . |
|
|
Senparc.Xncf.AgentsManager
Agents managementmodule |
|
|
Senparc.Xncf.AIAgentsHub
AI Agent Hub Module |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.20.16 | 0 | 11/19/2026 |
| 0.20.15 | 132 | 11/11/2026 |
| 0.20.14 | 114 | 11/5/2026 |
| 0.20.12 | 68 | 11/4/2026 |
| 0.20.9 | 120 | 11/2/2026 |
| 0.19.9 | 129 | 10/10/2026 |
| 0.19.8 | 121 | 10/4/2026 |
| 0.19.7 | 140 | 9/18/2026 |
| 0.19.6 | 115 | 9/16/2026 |
| 0.19.5 | 119 | 9/15/2026 |
| 0.19.4 | 202 | 8/29/2026 |
| 0.19.3 | 296 | 8/23/2026 |
| 0.19.3-preview11 | 173 | 8/14/2026 |
| 0.19.2-preview10 | 158 | 8/12/2026 |
| 0.19.1-preview9 | 163 | 8/8/2026 |
| 0.19.0-preview8 | 171 | 8/3/2026 |
| 0.18.0-preview7 | 171 | 7/31/2026 |
| 0.17.1-preview6 | 194 | 7/28/2026 |
| 0.17.0-preview5 | 186 | 7/26/2026 |
| 0.16.5-preview4 | 149 | 7/15/2026 |
[2024-08-06] v0.9.6.0-preview1 update Senparc.AI.Kernel
[2024-08-29] v0.9.9.0-preview1 Updated module behavior and related support.
[2024-08-31] v0.10.0-preview1 Updated module behavior and related support.
[2024-09-03] v0.10.1-preview1 Updated module behavior and related support.
[2024-09-04] v0.10.2-preview1 Updated module behavior and related support.
[2024-09-07] v0.10.2.10-preview1 Updated module behavior and related support.
[2024-09-07] v0.10.2.11-preview1 Updated module behavior and related support.
[2024-09-07] v0.10.3-preview1 Updated module behavior and related support.
[2024-09-08] v0.10.3.1-preview1 Updated module behavior and related support.
[2024-09-10] v0.10.4-preview1 upgrade the cache foundation libraries
[2024-09-27] v0.10.5-preview1 Updated module behavior and related support.
[2024-10-09] v0.10.7-preview1 Updated module behavior and related support.
[2024-10-16] v0.10.5-preview1 Updated module behavior and related support.
PromptRange
[2024-10-16] v0.10.8-preview1 Updated module behavior and related support.
[2024-10-16] v0.10.8-preview1 Updated module behavior and related support.
[2024-11-04] v0.11.0-preview1 Updated module behavior and related support.
[2024-11-08] v0.11.1-preview1 upgrade Senparc.AI
[2024-11-15] v0.12.0-preview1 Updated module behavior and related support.
[2024-11-15] v0.12.1-preview1 Updated module behavior and related support.
[2024-11-21] v0.13.2-preview1 Updated module behavior and related support.
[2024-11-28] v0.13.3-preview1 update CO2NET, use new SenparcSetting with UseLowerCaseApiName
property
[2024-12-27] v0.13.4-preview1 Add exception log for UseXncfModules() auto progress
[2025-01-25] v0.13.8-preview1 Update Agents functions, support for function calling
[2025-01-28] v0.13.9-preview1 update Senparc.AI
[2025-02-06] v0.13.10-preview1 update NeuCharAI model update
[2025-02-22] v0.13.11-preview1 add DeepSeek-R1 <think> tag style
[2025-03-21] v0.13.12-preview1 PromptRange's 3D charts are accurate to 1 decimal place
[2025-04-29] v0.13.14-preview1 Update CO2NET and AIKernel
[2025-05-18] v0.13.15-preview1 Update Installation
[2025-06-20] v0.13.16-preview1 Add MCP functions in XncfRegisterBase class
[2025-08-19] v0.13.17-preview.1 remove debug code in prompt.js
[2025-11-01] update basic libraries, including Senparc.AI
[2025-11-06] v0.13.19-preview.1 add AI score standard setting
[2025-11-06] v0.14.0-preview.1 Support Prompt comparison; Optimize the PromptRange layout and
provide a scalable layout
[2025-11-07] v0.14.1-preview.1 Optimize Prompt comparison
[2025-12-11] v0.14.2-preview.1 Optimize Prompt keyword highlight
[2025-12-14] v0.15.0-preview.1 PromptRange support Chat mode
[2025-12-14] v0.15.1-preview.1 Optimize Prompt score 3D chart and conversation mode for Brust Shotting mode
[2025-12-16] v0.15.2-preview.1 Optimize Prompt score 3D chart
[2025-12-17] v0.15.3-preview.1 Optimize Prompt score 3D chart, support SystemMessage storage for Chat Shooting mode
[2026-07-02] v0.16.2-preview1 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[2026-07-05] v0.16.3-preview2 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[2026-07-05] v0.16.4-preview3 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.
[2026-07-07] v0.16.5-preview4 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.
[2026-07-17] v0.17.0-preview5 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.17.1-preview6 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[2026-07-31] v0.18.0-preview7 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[2026-08-04] v0.19.0-preview8 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[2026-08-08] v0.19.1-preview9 Dependency updates from upstream projects
1. Dependency update from Senparc.Ncf.AreaBase to 0.23.2-preview6
2. Dependency update from Senparc.Ncf.XncfBase to 0.24.1-preview6
3. Dependency update from Senparc.Xncf.AIKernel to 0.15.2-preview9
4. Dependency update from Senparc.Xncf.AreasBase to 0.13.4-preview6
5. Dependency update from Senparc.Xncf.SystemCore to 0.14.4-preview6
6. Dependency update from Senparc.Xncf.SystemManager to 0.15.4-preview7
7. Dependency update from Senparc.Xncf.Tenant to 0.15.4-preview6
8. Dependency update from Senparc.Xncf.PromptRange.Abstractions to 0.2.4-preview4
[2026-08-13] v0.19.2-preview10 Dependency update from Senparc.Ncf.AreaBase to 0.23.3-preview7; Senparc.Ncf.XncfBase to 0.25.0-preview7; Senparc.Xncf.AIKernel to 0.15.3-preview10
[2026-08-15] v0.19.3 Dependency update from Senparc.Xncf.AIKernel to 0.15.3-preview12
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.19.4 Dependency updates from Senparc.Ncf.XncfBase to 0.26.1
1. Dependency update from Senparc.Ncf.XncfBase to 0.26.1
[2026-09-15] v0.19.5 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[2026-09-16] v0.19.6 Dependency updates from Senparc.IntegrationSample to 0.0.13; Senparc.Xncf.AIAgentsHub to 0.13.9; Senparc.Xncf.AgentsManager to 0.17.2; Senparc.Xncf.AgentsManagerTests to 0.0.15; Senparc.Xncf.WeixinManager to 0.24.7; Senparc.Web to 0.39.1
[2026-09-17] v0.19.7 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[2026-10-05] v0.19.8 Merge remote-tracking branch 'origin/Developer-MAF-V3' into Developer-MAF-V3-Spark
1. Updated Senparc.Xncf.PromptRange project behavior and integration for the latest feature and reliability improvements.
2. chore: update package versions and dependencies across multiple projects
[2026-10-09] v0.19.9 Dependency update from Senparc.Xncf.AIKernel to 0.16.4
v0.1.0 initial release
v0.2.0 Updated module behavior and related support.
v0.2.0.1024 Updated module behavior and related support.
v0.2.1 Updated module behavior and related support.
v0.3.0 Updated module behavior and related support.
v0.3.10 reference Senparc.Xncf.AIKernel
v0.4.0 Updated module behavior and related support.
v0.4.2 Updated module behavior and related support.
v0.4.7 Updated module behavior and related support.
v0.4.11 add PromptResultService.GetPromptConfigParameterFromAiSetting() method
v0.6.4 Updated module behavior and related support.
v0.6.5 Updated module behavior and related support.
[2026-10-21] v0.20.0 Updated module behavior and related support.
[2026-10-21] v0.20.1 generate PromptRange SkillKind migrations with dotnet ef
1. Updated module behavior and related support.
2. Updated module behavior and related support.
3. Updated module behavior and related support.
[2026-10-21] v0.20.2 upgrade Skill management with GitHub folder import, AI Draft generation, version tree preview, and safer content inspection
[2026-10-22] v0.20.3 persist Skill package artifacts through FileManager and add source metadata to PromptRange
[2026-11-02] Fix Memory default prompt note length and support scoped, evidence-based incremental extraction.
[2026-11-02] Add the AdminChat.Memory system prompt provider with published-version score selection.
[2026-11-02] Return prompt scores and support server-side average-score and PromptCode sorting in the reusable selector.
[2026-11-02] Add authorized prompt selector APIs for range/lane options, paginated keyword search and on-demand prompt content.
[2026-11-03] Recognize durable reply preferences and safely refresh unchanged, unscored Memory defaults without replacing customized or scored prompts.
[2026-11-03] v0.20.8 Updated module behavior and related support.
1. Updated module behavior and related support.
[2026-11-03] Add shared contextual documentation beside prompt range selection.
[2026-11-05] v0.20.14 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. Dependency update from Senparc.Ncf.AreaBase to 0.23.10
8. Dependency update from Senparc.Ncf.XncfBase to 0.28.2
9. Dependency update from Senparc.Xncf.AIKernel to 0.17.2
10. Dependency update from Senparc.Xncf.AreasBase to 0.13.12
11. Dependency update from Senparc.Xncf.SystemCore to 0.14.12
12. Dependency update from Senparc.Xncf.SystemManager to 0.15.12
13. Dependency update from Senparc.Xncf.Tenant to 0.15.15
14. Dependency update from Senparc.Xncf.PromptRange.Abstractions to 0.3.2-preview7
[2026-11-11] v0.20.14 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[2026-11-12] v0.20.15 Updated module behavior and related support.
1. Updated module behavior and related support.
2. Updated module behavior and related support.
[2026-11-19] v0.20.16 Localized PromptRange administration 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.