> For the complete documentation index, see [llms.txt](https://docs.apono.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apono.io/docs/agent-privilege-guard/apono-agent-privilege-guard-reference/ai-sessions.md).

# AI Sessions

An **AI session** records an agent’s activity from the time it connects through the Apono Agentic Gateway until it disconnects. Each session is associated with the agent’s identity and the user on whose behalf it acts.

The **AI Sessions** tab on the **Activity & Reports** page provides a centralized audit trail of agent activity. It allows you to:

* Identify sessions: Review the agent, associated user, start time, and session status.
* Review activity: See the action categories and intent policy decisions recorded during each session.
* Investigate actions: Trace access grants and tool calls in the order they occurred.

{% hint style="info" %}
AI Sessions records activity under agent identities. Human access activity remains available in the existing **Activity** and **Session Audit** tabs.

Learn more about the [Activity](/docs/audits-and-reports/requests-audit/activity.md) and [Session Audit](/docs/audits-and-reports/session-audit.md) tabs.
{% endhint %}

***

### View AI sessions

A session appears when an agent connects through the Apono Agentic Gateway. Active sessions display a live indicator. Completed sessions display their total duration.

<figure><img src="/files/LUTk5DEWqwt8JOXomNku" alt="" width="563"><figcaption><p>AI Sessions</p></figcaption></figure>

On the [**AI Sessions**](https://app.apono.io/agentic/audit) tab, the table provides a summary of each session.

<table><thead><tr><th width="165.3388671875">Column</th><th>Description</th></tr></thead><tbody><tr><td><strong>Session ID</strong></td><td>Unique identifier for the session</td></tr><tr><td><strong>Started</strong></td><td><p>When the session started</p><p>Active sessions display a live indicator. Completed sessions display their total duration.</p></td></tr><tr><td><strong>User</strong></td><td>Name and email address of the user associated with the agent</td></tr><tr><td><strong>Agent</strong></td><td>Agent identity and client type, such as Claude Code, Claude Desktop, or MCP CLI Proxy</td></tr><tr><td><strong>Actions</strong></td><td><p>Action categories recorded during the session</p><p><strong>Possible values</strong>:</p><ul><li><strong>Read</strong></li><li><strong>Create</strong></li><li><strong>Update</strong></li><li><strong>Delete</strong></li><li><strong>Admin</strong></li></ul></td></tr><tr><td><strong>Decisions</strong></td><td><p>Intent policy decisions applied during the session</p><p><strong>Possible values</strong>:</p><ul><li><strong>ALLOW</strong></li><li><strong>HIL</strong></li><li><strong>DENY</strong></li></ul><p>Sessions without tool calls do not display actions or decisions.</p></td></tr></tbody></table>

#### View session details

Follow these steps:

1. On the [**AI Sessions**](https://app.apono.io/agentic/audit) tab, in the search field, enter a value to filter the sessions.
2. Set the date range to refine the list of sessions. By default, all sessions are listed.

<details>

<summary>All Time</summary>

**Relative**

Follow these steps to set a relative date range:

1. Click **All Time**, the date range settings appear.
2. On the **Relative** tab, from the **Last** dropdown menu, select a time measure.
3. In the **Last** text field, enter a number.
4. (Optional) Click **Round to the hours|days|months** to begin the time filtering from the nearest hour, day, or month.
5. Click **Apply**. The filter turns blue and shows a summary.
6. Click the top or outside of the dropdown menu to close it.

**Absolute**

Follow these steps to set an absolute date range:

1. Click **All Time**, the date range settings appear.
2. On the **Absolute** tab, under **From**, select a start date:
   1. Select the start date from the date picker.
   2. Select the start time (local system time) from the time picker.
3. Under **To**, select the end date:
   1. Select the end date from the date picker.
   2. Select the end time (local system time) from the time picker.
4. (Optional) Click **Use UTC** to apply the Coordinated Universal Time (UTC) timezone to the start and end times instead of the local system time.
5. Click **Apply**. The filter turns blue and shows a summary.
6. Click the top or outside of the dropdown menu to close it.

</details>

3. Click the row of a session. The session details panel opens.
4. Review the session summary and **Timeline**.

{% hint style="info" %}
The summary displays the session ID, start time, agent, associated user, and status. The **Timeline** displays the session events in chronological order. Each timeline entry is timestamped.
{% endhint %}

<table><thead><tr><th width="165.6611328125">Timeline Event</th><th>Description</th></tr></thead><tbody><tr><td><strong>Session started</strong></td><td>When the agent connected through the Apono Agentic Gateway</td></tr><tr><td><strong>Access elevated</strong></td><td><p>Access grant obtained during the session</p><p>Click the access request ID to review the access flow, target resources, permissions, and access duration.</p></td></tr><tr><td><strong>Tool call</strong></td><td><p>MCP tool called by the agent</p><p>The entry shows the MCP and tool name, action category, intent policy decision, and timestamp. Repeated identical calls may be grouped into one entry.</p></td></tr></tbody></table>

5. To close the panel, click **X** in the upper-right corner.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.apono.io/docs/agent-privilege-guard/apono-agent-privilege-guard-reference/ai-sessions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.