# AI Logs

The **AI Logs** view lets you monitor and control everything related to the AI Agents enabled in your tenant.

The dashboard provides clear visual tools to measure agent efficiency, track session handling, and analyze errors so you can iterate on your agents with confidence.

<figure><img src="https://1530167654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GgoeZEZYjZrpjOU6w52%2Fuploads%2Fgit-blob-3763e3bbdf69a088734f2aa31288274248666940%2Fagentic_logs.png?alt=media" alt="AI Logs"><figcaption><p>AI Logs</p></figcaption></figure>

You can also access logs related to a particular AI agent directly from the **AI Agents** view:

<figure><img src="https://1530167654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GgoeZEZYjZrpjOU6w52%2Fuploads%2Fgit-blob-00680e42a339749b243a11366ff5c871caf2e831%2Fagentic_agent_logs.png?alt=media" alt="AI Agent Logs" width="360"><figcaption><p>AI Agent Logs</p></figcaption></figure>

The available charts give you quick insight into AI Agents effectiveness:

* **Resolution Efficiency** highlights total AI requests and sessions.
* **Session Severity Distribution** summarizes session outcomes.
* **Session Error Trend** shows error rates over the last four weeks.

The logs are grouped into [requests](#requests), [jobs](#jobs), and [sessions](#sessions). For deeper insight into agent behavior, open the logs dedicated to a specific component or agent. Use search and the available filters in each view to find a specific log entry.

Each log entry is marked with the highest applicable severity: info, warning, or error. This means that if a given entry (request, job or session) contains an info and an error, it is marked with the error flag.

## Requests

The **Requests** view lists every request involving AI Agents. Each entry includes the related metadata and system log, showing exactly what occurred when the request was registered.

<figure><img src="https://1530167654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GgoeZEZYjZrpjOU6w52%2Fuploads%2Fgit-blob-8ee6b8e16b813029d58ec8053ae6c10722428070%2Fagentic_logs_requests.png?alt=media" alt="AI Requests Logs"><figcaption><p>AI Requests Logs</p></figcaption></figure>

## Jobs

The **Jobs** view captures system actions related to AI Agents, such as agent chat, import, or export operations. Open the details to understand what succeeded, what failed, and why.

<figure><img src="https://1530167654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GgoeZEZYjZrpjOU6w52%2Fuploads%2Fgit-blob-40271545874ec78a6e4dd90ccb6acb08cb852e68%2Fagentic_logs_jobs.png?alt=media" alt="AI Jobs Logs"><figcaption><p>AI Jobs Logs</p></figcaption></figure>

## Sessions

Use the **Sessions** view to inspect a specific AI session.

{% hint style="success" %}
A **session** starts with the request when an agent is called, and it lasts through any collaboration with other agents or users invoked by this agent. For example, incorrect invoice complaint triggers the Complaint Agent and the request starts a new session, which lasts through the whole agents flow:

1. Request -> Complaint Agent -> Collaboration Agent -> Complaint Agent
2. Request (Slack message) -> Support Agent
3. Request (second Slack message) -> Support Agent

The three subsequent requests are within the same session.
{% endhint %}

Filter the logs by agent to focus on the relevant conversation. The details panel presents a linear timeline of every agent step, which gives more business-oriented overview highlighting only the most important logs and all the warnings and errors. Clicking on a card in the session brings you to the details view of the related log entry/entries.

<figure><img src="https://1530167654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GgoeZEZYjZrpjOU6w52%2Fuploads%2Fgit-blob-f7d571128bf902569baf9198b369937e8a7cb1e3%2Fagentic_logs_sessions_multi.png?alt=media" alt="AI Sessions Logs"><figcaption><p>AI Sessions Logs</p></figcaption></figure>
