> ## 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

<div className="flex items-center gap-2">
  <Badge color="teal">Function</Badge>
</div>

> This function is defined in the [**context\_events**](../modules/context_events) 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

<ParamField query="emitter" type="ContextTraceEmitter" required={true}>
  The emitter to use within the context. The emitter for use within the context.
</ParamField>

### Returns

<ResponseField name="Returns" type="Generator['ContextTraceEmitter', None, None]">
  The result of the operation.
</ResponseField>

## 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 title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/trace/context_events.py#L88">
  `praisonaiagents/trace/context_events.py` at line 88
</Card>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Context Concept" icon="layer-group" href="/docs/docs/concepts/context" />

  <Card title="Context Management" icon="sliders" href="/docs/docs/features/context-management" />

  <Card title="Context Strategies" icon="diagram-project" href="/docs/docs/features/context-strategies" />
</CardGroup>