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

> ## Agent Instructions
> To act on Atlan objects, use the Atlan MCP server at https://api.atlan.com/mcp or the atlanai CLI; `atlanai --map json` prints its command map. Run a read-only identity check before any write.
> The docs MCP server at /mcp searches these docs only. It cannot read or change Atlan objects.
> SDK packages: Python `atlanai` (PyPI) and TypeScript `@atlanai/sdk` (npm). Show Python first, then TypeScript.

# Sessions and events

> Understand activity evidence recorded for an Agent or harness session.

A session is a recorded execution for an agent or harness. It links the subject
and its context to the reported events, traces, and observations. Creating a
session does not execute a run.

## Core flow

1. Open the agent profile and select **Sessions**.
2. Select a session to inspect the recorded activity for that execution.
3. Use its timestamps and linked traces to compare the Registry record with the
   external runtime.
4. Use session messages only when the harness uploaded a transcript.

## Verify the result

Match the session identifier, Agent identifier, and event timestamps. Do not
treat acceptance of a session upload as proof that the external execution
completed. Compare the reported timestamp, outcome, and final events with the
runtime when you need to confirm an outcome.

<Card title="Agent API reference" icon="code" href="/api/references/api-reference">
  Browse the public session and event operations.
</Card>