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
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Senparc.Xncf.PromptRange" Version="0.20.16" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Senparc.Xncf.PromptRange" Version="0.20.16" />
                    
Directory.Packages.props
<PackageReference Include="Senparc.Xncf.PromptRange" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Senparc.Xncf.PromptRange --version 0.20.16
                    
#r "nuget: Senparc.Xncf.PromptRange, 0.20.16"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Senparc.Xncf.PromptRange@0.20.16
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Senparc.Xncf.PromptRange&version=0.20.16
                    
Install as a Cake Addin
#tool nuget:?package=Senparc.Xncf.PromptRange&version=0.20.16
                    
Install as a Cake Tool

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/PromptRangeAppService manage prompt ranges and dashboard data.
  • PromptItemService/PromptItemAppService manage prompt trees, versions, import/export, and range-name responses.
  • LlmModelService/LlmModelAppService manage available language-model metadata.
  • PromptResultService/PromptResultAppService manage generated results, robot/human scores, chat continuation, and feedback.
  • PromptTextEmbeddingExecutionOptions, PromptImageController, PromptAudioController, and PromptStreamController expose execution integration points.
  • PromptResult_TextEmbeddingSearchRequest and PromptResult_TextEmbeddingSearchResponse model 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), exact tactic, keyword (up to 200 characters), pageIndex (1-based), pageSize (1–50, default 10). Returns items and totalCount; each item's content is 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=promptCode orders by the full PromptCode string ascending, with newer IDs breaking ties. Sorting runs before pagination. Items and full-content responses include currentScore (-1 means unrated); evalAvgScore and evalMaxScore remain 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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
Loading failed

[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.