> ## 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 • AI Agent SDK

> Trace Module for PraisonAI Agents.

# trace

<Badge color="blue">AI Agent</Badge>

Trace Module for PraisonAI Agents.

Provides lightweight action tracing for the `output="actions"` mode.
Shows agent lifecycle events, tool calls, and final output without
verbose internal details.

Zero Performance Impact:

* All imports are lazy loaded via **getattr**
* NoOpSink is the default (zero overhead when not used)
* Disabled emitter has near-zero overhead

Usage:
from praisonaiagents import Agent

# Simple usage - shows action trace

agent = Agent(instructions="...", output="actions")
agent.start("Do something")

# Advanced - capture to file

from praisonaiagents.trace import ActionTraceConfig

agent = Agent(
instructions="...",
output="actions",
trace=ActionTraceConfig(
sink\_type="jsonl",
file\_path="trace.jsonl",
)
)

## Import

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import trace
```