Definition
Functional Requirements
Syntax
Semantics
Conformance Testing
Performance Assessment
Definition
Context Capture Directive (PGM‑CXD) is a Directive issued by A‑User Control that specifies the parameters for a context acquisition operation by identifying the directive instance, defining the type of capture to be performed, selecting the modalities to be acquired, optionally bounding the acquisition with a time window, indicating execution priority, specifying the point of view for capture, and providing associated metadata for identification, exchange, and description.
Functional Requirements
- Directive Identification and Traceability: The directive shall include a unique identifier (CXCDirectiveID) and a timestamp (CXCDirectiveTime) to ensure traceability and correlation with execution status.
- Capture Operation Control: The directive shall specify the scope of the acquisition relative to existing context: full capture, update, delta.
- Modality Selection: The directive shall include ModalityFlags to explicitly indicate which modalities are to be captured: Text, Audio, Visual
- Temporal Bounding of Acquisition: The directive may include a TemporalScope specifying the duration over which context acquisition is performed.
- Priority Specification: The directive shall include a PriorityLevel indicating the urgency or scheduling preference of the capture operation.
- Perceptual Framing: The directive may include a PointOfView to define the perspective or capture angle to be used during acquisition.
- Data Exchange Metadata: The directive shall include DataXMData to provide standardised metadata supporting interoperability, traceability across systems, and data exchange control.
- Descriptive Metadata: The directive may include DescrMetadata to carry additional descriptive information about the directive for non-operational purposes.
Syntax
https://schemas.mpai.community/PGM1/V1.0/data/CXCDirective.json
Semantics
| Label | Description |
| Header | Directive header identifier matching pattern “PGM-CXD-Vx.y”. |
| MInstanceID | Identifier of the M-Instance in which the A-User operates. |
| UEnvironmentID | Identifier of the U-Environment associated with the M-Instance. |
| CXCDirectiveID | Unique identifier for this CXC Directive instance. |
| CXCDirectiveTime | Timestamp indicating when the directive was produced. |
| DirectiveType | Type of context operation: full capture, incremental update, or delta refinement. |
| ModalityFlags | Set of flags defining which modalities must be captured. |
| – Text | Indicates whether textual data should be captured. |
| – Audio | Indicates whether audio streams should be captured. |
| – Visual | Indicates whether visual data should be captured. |
| MLocation | Portion of M-Instance of interest.. |
| Objects[] | Objects of interest. |
| Users[] | Users of interests |
| PointOfView | viewpoint parameters for capture perspective. |
| Duration | Duration of the captur time window in milliseconds. May be zero for a snapshot. |
| PriorityLevel | Specifies execution urgency (low, normal, high). |
| DataXMData | Data Exchange Metadata compliant with MPAI-PTF V1.0, providing provenance, traceability, and interoperability information. |
| DescrMetadata | Optional descriptive metadata providing additional human-readable context. |
