GetTriggeredAct

Returns info of the action that initiated the execution of the flow instance.

GetTriggeredAct()

Returned fields

  • commandActId (UUID | None): ID of the act;
  • referenceIdn (str | None): IDN of the event that triggered the flow;
  • integrationIdn (str | None): IDN of the integration that sent the event;
  • connectorIdn (str | None): IDN of the connector that sent the event;
  • person (str | None): the name of the persona that sent the event;
  • timeInterval (int | None): time interval between triggered act and previous act in seconds;
  • datetime (datetime | None): time of act. See datetime doc;
  • text (str | None): message text, if applicable;
  • englishText (str | None): the text of the message in English, if applicable;
  • originalText (str | None): original text of the message without filters and not translated into English, if applicable;
  • languageCode (str | None): the code of the language in which the message was written, if applicable;
  • arguments (dict[str, str]): additional arguments that were sent with the event. See SendSystemEvent doc

Example

A skill sends an event using SendSystemEvent with custom arguments:

{{ SendSystemEvent(
    eventIdn="end_session",
    connectorIdn="system",
    transcript=transcript,
    semaphore=semaphore,
    quality_metrics=quality_metrics
) }}

In the flow subscribed to that event, GetTriggeredAct() returns:

{% set act = GetTriggeredAct() %}

{# act will look like:
   act.referenceIdn      → "end_session"
   act.timeInterval      → 0
   act.text              → None
   act.datetime          → datetime.datetime(2023, 1, 1, 1, 1, 1)
   act.englishText       → None
   act.integrationIdn    → None
   act.connectorIdn      → "system"
   act.originalText      → None
   act.languageCode      → None
   act.person            → Alex
   act.commandActId      → 6162ffea-74d9-4723-9c3e-c7a224876f4f
   act.arguments         → {
       "transcript": "conversation transcript",
       "semaphore": { ... },
       "quality_metrics": { ... }
   }
#}

{# Access individual arguments: #}
{{ act.arguments.transcript }}