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

# Sessions

Sessions group related traces (multiple requests / turns) under a shared identifier—useful for conversational AI and multi-step workflows.

* Set a session ID at the trace level so all spans in a trace share it.
* Use the Sessions view in the Laminar UI to review all traces in the same session.

Set the session ID early in your request/handler entry point so downstream spans inherit it.

<Note>
  You must set the session ID inside a span context so it can attach to the current trace (for example, inside an <code>@observe</code>d function / <code>observe()</code> call, or by passing <code>sessionId</code> / <code>session\_id</code> via observe options).
</Note>

## What is a Session?

A **trace** usually represents one request / one conversational turn. A **session** groups multiple traces that belong to the same higher-level flow (for example, an entire chat conversation or checkout process).

## Example

<Tabs items={['TypeScript', 'Python']}>
  <Tab title="TypeScript">
    ```typescript theme={null}
    import { observe } from '@lmnr-ai/lmnr';

    // One trace per turn/request; reuse the same sessionId across turns
    export async function handleTurn(conversationId: string, userMessage: string) {
      return observe({ name: 'handleTurn', sessionId: conversationId }, async () => {
        // ... LLM calls / tools ...
      });
    }
    ```

    See also: [`observe(..., { sessionId })`](/sdk/observe#ts-observe) and [`Laminar.setTraceSessionId`](/sdk/trace-methods#ts-laminar-set-trace-session-id)
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    from lmnr import Laminar, observe

    # One trace per turn/request; reuse the same session_id across turns.
    # Note: set_trace_session_id must be called inside a span context (e.g., an @observe'd function).
    @observe()
    def handle_turn(conversation_id: str, user_message: str):
        Laminar.set_trace_session_id(conversation_id)
        # ... LLM calls / tools ...
    ```

    See also: [`@observe()`](/sdk/observe#py-observe) and [`Laminar.set_trace_session_id`](/sdk/trace-methods#py-laminar-set-trace-session-id)
  </Tab>
</Tabs>

## Viewing Sessions in Laminar

1. Navigate to the **Traces** page
2. Select the **Sessions** tab
3. Click a session to expand and see all traces within it

<img className="block" src="https://mintcdn.com/hipocap/jGau1UNMEqA4k6Af/images/sessions.png?fit=max&auto=format&n=jGau1UNMEqA4k6Af&q=85&s=91070c798bb089ea5597ef5d6b791cf3" alt="Sessions tab showing traces grouped by session" width="3024" height="1722" data-path="images/sessions.png" />

Each trace within a session contains the same information as a standalone trace:

<img className="block" src="https://mintcdn.com/hipocap/jGau1UNMEqA4k6Af/images/trace-session.png?fit=max&auto=format&n=jGau1UNMEqA4k6Af&q=85&s=a187bfa659b91463ae90fb68c5bd3b5c" alt="Trace detail view for a trace within a session" width="1220" height="1706" data-path="images/trace-session.png" />

## Common Patterns

* **Chatbots:** session = `conversation_id`, trace = one user turn.
* **Workflows:** session = `checkout-{userId}`, trace = each step (`validateCart`, `processPayment`, `createOrder`).