Connecting other Agent Events

In addition to Connecting Actions and Connecting User Ratings to your agents' session recordings in Wayfound, you can also connect other kinds of events under a general "event" message type. This could be any kind of data that is relevant to the agents' interactions with users. Some examples of this could be “user launches the bot” or “user clicks on a link”.

The AI Manager can make sense of this additional data in the recording session when analyzing your agents' activity. To help the AI Manager make the most of this data, the "event" message type comes with a description field that can contain more context about this particular datapoint. To this end, the description should be consistent with your agents' Guidelines.

Example Scenario

In this example, the AI agent provides a link to the user and the downstream system hosting the agent knows that the user clicked a particular link and that data is passed back to Wayfound. A high priority guideline is established saying “User clicks on a link that is different from what the agent provided them.” Session processing knows the user clicked on a different link by reading the event data and marks the session as “Needs Attention.”

The event is created as follows:

{
"agentId": "1d3348a5-dc4c-44d2-83b0-3e53acf74a76",
"firstMessageAt": "2025-04-11T10:51:00.000Z",
"lastMessageAt": "2025-04-11T10:54:00.000Z",
"messages": [
  
  {
    "role": "assistant",
    "content": "Hi, How may I help you?"
  },
  {
    "role": "user",
    "content": "I want help with creating agents."
  },
  {
    "role": "assistant",
    "content": "Go checkout Google's new agent builder: [Google AI Studio](https://aistudio.google.com/)"
  },
  {
    "role": "debug",
    "type": "event",
    "description": "User clicks on the link.",
    "data": { "category": "User Click Event",
              "detail": {"click": "https://www.crewai.com/"}}
  }
]
}