> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Events AI

Events AI lives in the TruU Admin Console under **Core → Events AI**. You search and review activity using natural language and filters. Whatever is active appears as chips under the search bar so the rules behind your results are always visible.

Data in this view comes from your organization’s current Events AI data pipeline in TruU. Which events you see depends on your tenant configuration, time range, permissions, and platform data retention—not every historical event may appear here. For long‑range or archival questions, use Events or contact TruU.

***

## What You See on the Page

<Frame>
  <img src="https://mintcdn.com/truu-2/yHxSQHHD9XiZyxK2/images/image-106.png?fit=max&auto=format&n=yHxSQHHD9XiZyxK2&q=85&s=8e768da5109ca3fad29cc750f202a237" alt="Image" width="5300" height="4512" data-path="images/image-106.png" />
</Frame>

| **Area**                    | **Purpose**                                                                                         |
| :-------------------------- | :-------------------------------------------------------------------------------------------------- |
| Search                      | Enter a question or keywords. Press **Enter** or the search icon. **X** clears the field.           |
| Time                        | Sets the evaluation window; a natural-language question may adjust it.                              |
| Filter                      | Filter icon (funnel): opens the filter panel. The badge shows how many filters are active.          |
| Applied filters             | One chip per condition. **Edit** opens the panel; **Clear all** removes them.                       |
| How to use Events AI        | Text link to product help or your published guide (same topic as this page).                        |
| Feedback · Export · Refresh | Toolbar icons beside the page title: feedback, export events (if your role allows), reload results. |

***

## Search

<Frame>
  <img src="https://mintcdn.com/truu-2/yHxSQHHD9XiZyxK2/images/image-107.png?fit=max&auto=format&n=yHxSQHHD9XiZyxK2&q=85&s=7e2c986b2520a8d11e287d1bc5e544cc" alt="Image" width="5300" height="4512" data-path="images/image-107.png" />
</Frame>

1. Type, then press **Enter** or click search. While a run is in progress, search controls stay disabled so you don’t submit twice.
2. **X** clears the field and resets toward the default view.
3. Focusing the field may show recent searches and suggestions; choosing one runs it.
4. After a run, read **Applied filters** to see how your wording was translated into structured rules.

**Table shortcuts:** **User** and **Device** cells may offer **Go to user** / **Go to device** or **Add as filter**. **Status** or **Event** may apply a filter in one click.

<Frame>
  <img src="https://mintcdn.com/truu-2/yHxSQHHD9XiZyxK2/images/image-108.png?fit=max&auto=format&n=yHxSQHHD9XiZyxK2&q=85&s=5c85b0ba2181fd3dcf81195f75c0edfe" alt="Image" width="1786" height="770" data-path="images/image-108.png" />
</Frame>

***

## Time Range

Pick a **preset** or a **custom** start and end (including time of day). Only events inside that window are evaluated. If results are large, start with a narrow window, then widen.

<Frame>
  <img src="https://mintcdn.com/truu-2/yHxSQHHD9XiZyxK2/images/image-111.png?fit=max&auto=format&n=yHxSQHHD9XiZyxK2&q=85&s=9c8a0500de8218b533c5d0a74473d91d" alt="Image" width="1360" height="368" data-path="images/image-111.png" />
</Frame>

***

## Filters

Open the panel from the **filter** icon or **Edit** on the chip strip. Each row is field → operator → value.

Fields include: **User**, **Email**, **Event tag** (sometimes labeled **Event category** in places), **Event type**, **Auth method**, **Status**, **Search text**, **Device** and **Target**.

Operators include: **equals**, **not equals**, and text match options such as **contains** / **includes** and **does not contain** / **excludes**—match the labels in your UI.

Within one group, conditions connect with **AND** or **OR** (not mixed in the same group—use **Add filter group** for complex logic). **Apply** saves and refreshes; the search text is usually cleared so chips define the query. **Clear all** clears rows in the panel; **Cancel** discards edits. Rows with an empty value are not applied.

<Frame>
  <img src="https://mintcdn.com/truu-2/yHxSQHHD9XiZyxK2/images/image-109.png?fit=max&auto=format&n=yHxSQHHD9XiZyxK2&q=85&s=ada5dc180495c4e61862a9a28f471951" alt="Image" width="3240" height="1104" data-path="images/image-109.png" />
</Frame>

***

## Applied Filters

Each chip shows **field**, **operator**, and **value**. Remove one chip with its **x**, or use **Clear all** to reset the strip and search field together.

<Frame>
  <img src="https://mintcdn.com/truu-2/yHxSQHHD9XiZyxK2/images/image-110.png?fit=max&auto=format&n=yHxSQHHD9XiZyxK2&q=85&s=5995d0fbae78a1ea7baf02778a858068" alt="Image" width="968" height="237" data-path="images/image-110.png" />
</Frame>

***

## Results: List vs Aggregation

**Event list** — one row per event (time, category and tags, status, user, device, target, etc.).

**Aggregation** — for questions about counts, “most”, or “distribution”, you may see a summary table (for example by user or auth method). Clicking a summary value often adds filters and moves you toward the underlying events.

<Frame>
  <img src="https://mintcdn.com/truu-2/P9vdjHp_CyGaVc2i/images/image-97.png?fit=max&auto=format&n=P9vdjHp_CyGaVc2i&q=85&s=2f1ef957e9094498b5dccc2c748b29c2" alt="Image" width="6180" height="4512" data-path="images/image-97.png" />
</Frame>

***

## Row Details

Expand a row for **Event details** (structured fields) and **JSON** (full payload). Labels for event type, auth method, and status should match the filter dropdowns.

<Frame>
  <img src="https://mintcdn.com/truu-2/P9vdjHp_CyGaVc2i/images/image-98.png?fit=max&auto=format&n=P9vdjHp_CyGaVc2i&q=85&s=31606a406d4cf3f81181ce5fed2eb84c" alt="Image" width="2588" height="1260" data-path="images/image-98.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/truu-2/P9vdjHp_CyGaVc2i/images/image-101.png?fit=max&auto=format&n=P9vdjHp_CyGaVc2i&q=85&s=fd56130ee21817a2dfc5cc8884d78fa2" alt="Image" width="2588" height="1260" data-path="images/image-101.png" />
</Frame>

***

## Export

The dialog summarizes your search query, time range, applied filters, and how many events will be included. Confirm those match what you intend (list results vs an aggregation you still have on screen). Processing is asynchronous; use the in-app notification and email link before it expires.

<Frame>
  <img src="https://mintcdn.com/truu-2/P9vdjHp_CyGaVc2i/images/image-103.png?fit=max&auto=format&n=P9vdjHp_CyGaVc2i&q=85&s=d2c2a40955e7add2e9e60542a37b2500" alt="Image" width="1932" height="248" data-path="images/image-103.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/truu-2/P9vdjHp_CyGaVc2i/images/image-102.png?fit=max&auto=format&n=P9vdjHp_CyGaVc2i&q=85&s=518fd9a1e5622346a10c376db9f4e9b5" alt="Image" width="3090" height="2256" data-path="images/image-102.png" />
</Frame>

***

## Feedback

Use Feedback when results are wrong or unclear. Choose a category, describe what you expected versus what you saw. TruU receives your query, time range, and applied filters with the message.

<Frame>
  <img src="https://mintcdn.com/truu-2/P9vdjHp_CyGaVc2i/images/image-104.png?fit=max&auto=format&n=P9vdjHp_CyGaVc2i&q=85&s=a9cf3940211bbd73aa7cdfa5a8b4089c" alt="Image" width="1932" height="248" data-path="images/image-104.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/truu-2/P9vdjHp_CyGaVc2i/images/events-ai-10-feedback.png?fit=max&auto=format&n=P9vdjHp_CyGaVc2i&q=85&s=5302a39044d0360ab0d2edd13ede4741" alt="Events Ai 10 Feedback" width="3090" height="2256" data-path="images/events-ai-10-feedback.png" />
</Frame>

***

## Privacy considerations

Natural language search is built so your security and privacy stay first.

#### Your event data stays in TruU’s trust boundary

The AI does not learn from your event payloads. It is aware of data structure and field names only—it does not see, process, or store your actual event content for model training. Sensitive event data remains in TruU’s secure backends, under the same protections as the rest of the platform you use today.

#### How it works

* The LLM is oriented around schemas and query patterns, not customer content.
* The model acts as a translation layer: your words become structured queries.
* Retrieval of events happens in TruU’s existing backend systems after that translation.

#### Enterprise-grade AI safeguards

* TruU uses an enterprise LLM with strict isolation and no retention policies appropriate for this use.
* Customer queries and data are not used to train or improve the model.
* AI processing follows the same encryption, access controls, and compliance standards as the core Admin Console.
