error.triggered

Emitted when an error occurs.

Event Properties

Field	Value
event	"error.triggered"
confidential	boolean
payload	object

Public Payload

Field	Type	Description
message	string	Human-readable error description
code	string	Machine-readable error identifier
interactionId	string	Unique interaction identifier
interactionState	InteractionState	Current state of the interaction

Example

{
  "event": "error.triggered",
  "confidential": false,
  "payload": {
    "message": "Network error",
    "code": "network_error",
    "interactionId": "int_123",
    "interactionState": "ongoing"
  }
}

Confidential Payload

Field	Type	Description
message	string	Human-readable error description
code	string	Machine-readable error identifier
interaction	ExternalInteraction	Interaction context including transcripts, documents, and facts

interaction object properties

Field	Type	Description
id	string	Unique interaction identifier
title	string | null	Interaction title
state	InteractionState	Current state of the interaction
startedAt	string (ISO 8601 date)	When the interaction started (ISO 8601 date string)
transcriptCount	number	Number of transcripts in the interaction
documentCount	number	Number of documents in the interaction
facts	Fact[]	Facts extracted during the interaction

Fact properties:

Field	Type	Description
id	string	Unique fact identifier
text	string	Fact text content
group	string	Fact group/category name
source	"core" | "system" | "user"	Source of the fact: core (AI extracted), system, or user
isDiscarded	boolean	Whether the fact has been discarded

Example

{
  "event": "error.triggered",
  "confidential": true,
  "payload": {
    "message": "Network error",
    "code": "network_error",
    "interaction": {
      "id": "int_123",
      "title": "Visit",
      "state": "ongoing",
      "startedAt": "2024-01-01T00:00:00.000+00:00",
      "transcriptCount": 0,
      "documentCount": 0,
      "facts": []
    }
  }
}