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

# Trace Context • AI Agent SDK

> trace_context: Context manager for trace emitter lifecycle.

# trace\_context

Function

> This function is defined in the [**context\_events**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/context_events.md) module.

Context manager for trace emitter lifecycle.

Automatically sets the emitter on entry and resets on exit,
even if an exception occurs. This is the recommended way to
use custom trace emitters.

## Signature

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
def trace_context(emitter: 'ContextTraceEmitter') -> Generator['ContextTraceEmitter', None, None]
```

## Parameters

**emitter** `ContextTraceEmitter` *required*

The emitter to use within the context. The emitter for use within the context.

### Returns

**Returns** `Generator['ContextTraceEmitter', None, None]`

The result of the operation.

## Usage

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
sink = MyCustomSink()
    emitter = ContextTraceEmitter(sink=sink, session_id="my-session", enabled=True)

    with trace_context(emitter) as ctx:
        agent = Agent(...)
        agent.chat("Hello")  # Events go to MyCustomSink
```

## Uses

* `set_context_emitter`
* `reset_context_emitter`

## Source

> [card] [View on GitHub](https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/trace/context_events.py#L122)
>
> `praisonaiagents/trace/context_events.py` at line 122

***

## Related Documentation

> [card] [Context Concept](https://praison.ai/docs/docs/concepts/context)

> [card] [Context Management](https://praison.ai/docs/docs/features/context-management)

> [card] [Context Strategies](https://praison.ai/docs/docs/features/context-strategies)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.