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

# Action Event • AI Agent SDK

> ActionEvent: Lightweight action trace event.

# ActionEvent

> Defined in the [**protocol**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/protocol.md) module.

AI Agent

Lightweight action trace event.

Represents a single action in the agent execution trace.
Designed for minimal memory footprint and fast serialization.

## Properties

**event\_type** `str`

No description available.

**timestamp** `float`

No description available.

**schema\_version** `str`

No description available.

**agent\_id** `Optional[str]`

No description available.

**agent\_name** `Optional[str]`

No description available.

**tool\_name** `Optional[str]`

No description available.

**tool\_args** `Optional`

No description available.

**tool\_result\_summary** `Optional[str]`

No description available.

**duration\_ms** `Optional[float]`

No description available.

**status** `Optional[str]`

No description available.

**error\_message** `Optional[str]`

No description available.

**metadata** `Dict[str, Any]`

No description available.

> [accordion] Internal & Generic Methods
>
> * **to\_dict**: Convert to dictionary, excluding None values.
> * **to\_json**: Convert to JSON string.

## Source

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


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