PGM-AUA V1.0 AIMs - Prompt Contextualisation

Go to PGM-AUA V1.0 AI Modules

Function

Ref. Model

1. Function

The Prompt Contextualisation (PGM‑PCX) AIM enriches the Intent and the Propositions produced by Intent and Referent Analysis with Goal constraints, scene context and User State adaptation, producing the planning inputs required by the Prompt Planning and Formatting AIM to assemble the PC Prompt.

PGM‑PCX:

Derives a Goal from the Intent, specifying the objectives, action types, priorities, target Entities, predicate conditions, and constraints that govern how the Basic Knowledge AIM should respond.
Determines the expressive configuration appropriate to the User States and the interaction context, producing a User Personality carrying tone, style, pacing, and narrative goal.
Tags the scene context by producing additional Propositions representing contextual facts, timing guidance, and phrasing constraints relevant to the current interaction.
Draws on the scene context and the domain knowledge, obtained by Context Description from Domain Access, carried by the Context Descriptors when it is needed to derive Goal constraints or determine the appropriate expressive configuration.
Queries the Private Storage via PRC Interaction History when prior interaction context is needed to adapt the Goal or expressive configuration to the User’s history.

The PGM‑PCX AIM does not assemble or format the prompt. Rather, it produces the Goal, expressive, and contextual inputs that the Prompt Planning and Formatting AIM requires to construct the PC Prompt.

2. Reference Model

Figure 1 depicts the Reference Model of the Prompt Contextualisation (PGM‑PCX) AIM.

Figure 1 – The Prompt Contextualisation (PGM‑PCX) AIM

3. Input/Output Data

Table 1 specifies the Input and Output Data of the Prompt Contextualisation (PGM‑PCX) AIM.

Table 1 – I/O Data of the Prompt Contextualisation (PGM‑PCX) AIM

Input	Description
Intent	Structured representation of the User’s goal-directed purpose produced by the Intent and Referent Analysis AIM, carrying category, action type, parameters, and confidence score.
Proposition	Fully resolved referential expressions produced by the Intent and Referent Analysis AIM, expressed as subject–predicate–object triples with spatial and temporal context.
AUC-PRC Request	Request from the A‑User Control AIM specifying scope, depth, and policy constraints for prompt construction.
PRC Interaction History Response	Interaction History Response from Private Storage providing prior interaction context to support Goal derivation and User State adaptation.
Context Descriptors	Structured descriptors of the current interaction context produced by Context Description, carrying the scene context and the domain knowledge that Context Description obtains from Domain Access, needed to derive Goal constraints and the expressive configuration.
Output	Description
Goal	Structured representation of the objectives, action types, priorities, target Entities, predicate conditions, and constraints that govern how the Basic Knowledge AIM should respond to the User’s intent.
Personality	Expressive configuration appropriate to the current User State and interaction context, carrying User’s tone, style, pacing, and narrative goal. The Prompt Planning and Formatting AIM uses this configuration to create PC Prompt.
Proposition	Additional scene context expressed as subject–predicate–object triples, carrying contextual facts, timing guidance, and phrasing constraints relevant to the current interaction.
AUC-PRC Response	Response reporting the processing outcome of this AIM.
PRC Interaction History Request	Request for Interaction History issued to Private Storage.

4. Sub-AIMs

No Sub-AIMs.

5. JSON Metadata

https://schemas.mpai.community/PGM1/V1.0/AIMs/PromptContextualisation.json

6. Profiles

No Profiles.

7. Reference Software

Not part of this specification.

8. Conformance Testing

Table 2 provides the Conformance Testing Method for the Prompt Contextualisation (PGM‑PCX) AIM.

If a schema contains references to other schemas, conformance of data for the primary schema implies that any data referencing a secondary schema shall also validate against the relevant schema, if present, and conform with the Qualifier, if present.

Table 2 – Conformance Testing Method for the Prompt Contextualisation (PGM‑PCX) AIM

Receives	Intent	Shall validate against the Intent schema.
	Proposition	Shall validate against the Proposition schema.
	AUC-PRC Request	Shall validate against the AUC-PRC Request schema.
	PRC Interaction History Response	Shall validate against the PRC Interaction History schema.
	Context Descriptors	Shall validate against the Context Descriptors schema.
Produces	Goal	Shall validate against the Goal schema.
	Personality	Shall validate against the Personality schema.
	Proposition	Shall validate against the Proposition schema.
	AUC-PRC Response	Shall validate against the AUC-PRC Response schema.
	PRC Interaction History Request	Shall validate against the PRC Interaction History schema.

9. Performance Assessment