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

# protocol • AI Agent SDK

> Action Trace Protocol for PraisonAI Agents.

# protocol

AI Agent

Action Trace Protocol for PraisonAI Agents.

Lightweight protocol for tracing agent actions. Uses only stdlib
to ensure zero dependencies and minimal overhead.

Schema Version: 1.0

## Import

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

## Classes

> [card] [ActionEventType](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/ActionEventType.md)
>
> Types of action events.

> [card] [ActionEvent](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/ActionEvent.md)
>
> Lightweight action trace event.

> [card] [TraceSinkProtocol](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/TraceSinkProtocol.md)
>
> Protocol for trace event sinks.

> [card] [NoOpSink](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/NoOpSink.md)
>
> No-operation sink that discards all events.

> [card] [ListSink](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/ListSink.md)
>
> Sink that collects events in a list.

> [card] [ActionTraceConfig](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/ActionTraceConfig.md)
>
> Configuration for action tracing.

> [card] [TraceEmitter](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/TraceEmitter.md)
>
> Emitter for action trace events.

## Functions

> [card] [get\_default\_emitter()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/get_default_emitter.md)
>
> Get the default trace emitter.

> [card] [set\_default\_emitter()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/set_default_emitter.md)
>
> Set the default trace emitter.

### Constants

| Name | Value |
| - | - |
| `SCHEMA_VERSION` | `'1.0'` |


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