Observations in the Amazon Connect Testing language - Amazon Connect
ParametersObservation object

Observations in the Amazon Connect Testing language

Observations represent each complete interaction that includes one observed event expected from the system and many actions to validate or simulate system behaviors.

Parameters

  • Version - The API version for the testing language, such as 2025-06-21.

  • Metadata - Optional object containing UI-specific or non-functional data

  • Observations - An array of observation objects that define the test flow

Observation object

Each observation consists of an event to observe and actions to execute when that event occurs.

  • Identifier - Unique identifier for the observation

  • Event - Defines the expected event from the system to observe

  • Actions - Array of actions to execute when the event is observed

  • Usage - Defines how many times this observation should be matched

    • Type: "EXACTLY"

    • Times: Integer value for the count, when applicable

  • Transitions - Optional object defining flow control to next observations

    • NextActions: Array of observation IDs to transition to

{
  "Version": "2025-06-21",
  "Metadata": { ... }, // Metadata to be used for data which is used for UI or any non-runtime impacting data as required.
  "Observations": [
    {
      "Identifier": "Unique identifer",
      "Event": { ... },
      "Actions": [ 
            {
                "Id": "ActionId", 
                "Type": "ActionType", // Action type could be of any type mentioned in recap (ObserveEvent, SendInstruction, Assertion, OverrideSystemBehavior, EndTest)
                "Parameters": {...},
                "Transitions" : {...}
            },
            ...
        ],
      "Usage": { "Type": "ANY" },
      "Transitions" : {
        "NextObservations": ["string-id", "string-id", "string-id"]
      }      
    },
    // Additional observations...
  ]
}