(Tentative)
| Definition | Functional Requirements | Syntax | Semantics |
Definition
BK Query Directive (PGM-BQD)
- Is produced by A-User Control to initiate a query to Basic Knowledge.
- Represents a structured instruction that encapsulates the PC-Prompt and contextual metadata for reasoning.
- Includes the prompt string, interaction focus, user state snapshot, and trace metadata to guide BK response generation.
Functional Requirements
| Function | Description |
| Prompt Content | Natural language query derived from Prompt Creation. |
| Interaction Focus | Identifies the semantic target of the query. |
| User State Snapshot | Captures engagement, affective tone, and disposition at query time. |
| Modulation Flags | Optional cues for tone, style, or pacing preferences. |
| Trace Metadata | Provides provenance for auditability and response alignment. |
Syntax
https://schemas.mpai.community/PGM1/V1.0/data/BKQueryDirective.json
Semantics
| Label | Description |
| Header | BK Query Directive Header |
| – Standard-BQD | The characters “PGM-BQD-V” indicating schema family and type |
| – Version | Major version – 1 or 2 characters |
| – Dot-separator | The character “.” separating version components |
| – Subversion | Minor version – 1 or 2 characters |
| DirectiveID | Unique identifier for this BK Query Directive instance |
| PCPrompt | Natural language prompt generated by Prompt Creation |
| InteractionFocus | Semantic target of the query |
| – ItemID | Identifier of the focused Item |
| – ItemType | Semantic category of the Item |
| – Description | Natural language description of the Item |
| UserStateSnapshot | User state at the time of query |
| – EngagementLevel | User’s cognitive engagement level |
| – AffectiveTone | Emotional tone inferred from user response |
| – Disposition | Inferred user disposition or attitude |
| ModulationFlags | Optional tone, style, or pacing preferences |
| – Tone | Preferred tone for BK response |
| – Style | Preferred communication style |
| – Pacing | Suggested pacing for BK response |
| Trace | Provenance metadata for BK Query Directive |
| – PCPromptHash | Hash of the originating PC-Prompt |
| – Timestamp | Time of directive creation |