Definition
Functional Requirements
Syntax
Semantics
Conformance Testing
Performance Assessment
Definition
USR Directive (PGM‑USD) is a Directive issued by A‑User Control to User State Refinement. It is the call in the A‑User Control interaction: User State Refinement runs autonomously and reports its conclusion as a USR Status; having read that conclusion, A‑User Control may call with a USR Directive that either accepts it or overrides the refined Engagement and Entity State, correlated to the USR Status it answers.
Functional Requirements
- Directive Identification and Traceability: The directive shall include a unique identifier (USRDirectiveID) and a timestamp (USRDirectiveTime) to ensure traceability.
- Environment Identification: The directive shall include identifiers for the M-Instance (MInstance) and U-Environment (UEnvironment) in which the directive applies.
- Session Identification: The directive shall include a SessionID identifying the A-User session to which the directive belongs.
- Exchange Phase: The directive shall indicate whether it opens a new exchange or continues an existing one, and on a continuation shall reference the USR Status (USRStatusID) it follows.
- Correction: The directive may carry A‑User Control’s decision to accept the reported conclusion or to override it, supplying the corrected Engagement and/or Entity State and an optional rationale.
- Data Exchange Metadata: The directive shall include DataXMData to provide standardised metadata supporting interoperability, traceability, and data exchange control.
- Descriptive Metadata: The directive may include DescrMetadata to provide additional human-readable context.
Syntax
https://schemas.mpai.community/PGM1/V1.0/data/USRDirective.json
Semantics
| Label | Description |
|---|---|
| Header | USR Directive header identifier. Value: “PGM-USD-V1.0”. |
| MInstance | Identifier of the M-Instance in which the directive applies. |
| UEnvironment | Identifier of the U-Environment associated with the directive. |
| USRDirectiveID | Unique identifier for this USR Directive instance. |
| USRDirectiveTime | Timestamp indicating when the directive was produced. |
| SessionID | Identifier of the A-User session to which the directive belongs. |
| Exchange | Container indicating the directive’s place in the interaction. |
| – Phase | Whether the directive opens a new exchange or continues one: new | continuation. |
| – USRStatusID | Identifier of the USR Status this directive follows, present on a continuation. |
| Correction | Container carrying A-User Control’s decision on the reported conclusion. |
| – Decision | Whether A-User Control accepts the reported conclusion or overrides it: accept | override. |
| – Engagement | Overriding engagement, when Decision is override: Level (0 to 1) and Mode. |
| – EntityState | Overriding Entity State, when Decision is override, compliant with MPAI-MMC V2.5. |
| – Rationale | Optional explanation of the correction. |
| 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.
