Definition
Functional Requirements
Syntax
Semantics
Conformance Testing
Performance Assessment
Definition
Interaction History (PGM‑IHI) is a data type representing the ordered record of turns exchanged during an A‑User session. It provides Prompt Creation with the prior interaction context needed to assemble a coherent and session-continuous PRC Prompt for deliberation by Basic Knowledge. Interaction History is stored in and retrieved from A‑User Storage exclusively under instruction from A‑User Control.
Functional Requirements
- Session Identification: The data type shall include a SessionID and session-level metadata (MInstanceID, UEnvironmentID, SessionStartTime, TurnCount) to identify the session to which the history belongs.
- Turn-Level Recording: The data type shall include an ordered array of Turn records, each identified by a TurnIndex and Timestamp.
- Role Identification: Each Turn shall identify the Role of the producing entity (A-User, H-User, or BKN).
- Prompt Recording: Each Turn shall include the PRC Prompt submitted to Basic Knowledge for that turn, enabling PRC to maintain referential continuity across turns.
- Response Recording: Each Turn shall include the BKN Response produced for that turn.
- User State Recording: Each Turn may include the User Entity State at the time of the turn, enabling PRC to track user state evolution across the session.
- AUC Instruction Recording: Each Turn may include the AUC Instruction that triggered the turn, supporting auditability and traceability.
- Data Exchange Metadata: The data type shall include DataXMData compliant with MPAI-PTF V1.0 for interoperability and traceability.
- Descriptive Metadata: The data type may include DescrMetadata for optional human-readable context.
Syntax
https://schemas.mpai.community/PGM1/V1.0/data/InteractionHistory.json
Semantics
| Label | Description |
|---|---|
| Header | Interaction History header identifier. Value: “PGM-IHI-V1.0”. |
| MInstanceID | Identifier of the M-Instance in which the session occurred. |
| UEnvironmentID | Identifier of the U-Environment associated with the session. |
| SessionID | Identifier of the A-User session to which this history belongs. |
| SessionStartTime | Timestamp of session initialisation. |
| TurnCount | Total number of turns recorded in this history instance. |
| Turns[] | Ordered array of Turn records representing the interaction history. |
| – TurnIndex | Ordinal position of the turn within the session, starting from 0. |
| – Timestamp | Timestamp at which the turn was initiated. |
| – Role | Role of the producing entity: A-User | H-User | BKN. |
| – PRCPrompt | The PRC Prompt submitted to Basic Knowledge for this turn. |
| – BKNResponse | The response produced by Basic Knowledge for this turn. |
| – UserEntityState | Optional User Entity State at the time of the turn. |
| – AUCInstruction | Optional AUC Instruction that triggered this turn. |
| DataXMData | Data Exchange Metadata compliant with MPAI-PTF V1.0. |
| DescrMetadata | Optional descriptive metadata providing additional human-readable context. |
Conformance Testing
Not part of this specification.
Performance Assessment
Not part of this specification.
