> ## 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**](../modules/protocol) module.

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

Lightweight action trace event.

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

## Properties

<ResponseField name="event_type" type="str">
  No description available.
</ResponseField>

<ResponseField name="timestamp" type="float">
  No description available.
</ResponseField>

<ResponseField name="schema_version" type="str">
  No description available.
</ResponseField>

<ResponseField name="agent_id" type="Optional[str]">
  No description available.
</ResponseField>

<ResponseField name="agent_name" type="Optional[str]">
  No description available.
</ResponseField>

<ResponseField name="tool_name" type="Optional[str]">
  No description available.
</ResponseField>

<ResponseField name="tool_args" type="Optional">
  No description available.
</ResponseField>

<ResponseField name="tool_result_summary" type="Optional[str]">
  No description available.
</ResponseField>

<ResponseField name="duration_ms" type="Optional[float]">
  No description available.
</ResponseField>

<ResponseField name="status" type="Optional[str]">
  No description available.
</ResponseField>

<ResponseField name="error_message" type="Optional[str]">
  No description available.
</ResponseField>

<ResponseField name="metadata" type="Dict[str, Any]">
  No description available.
</ResponseField>

<Accordion title="Internal & Generic Methods">
  * **to\_dict**: Convert to dictionary, excluding None values.
  * **to\_json**: Convert to JSON string.
</Accordion>

## Source

<Card title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/trace/protocol.py#L33">
  `praisonaiagents/trace/protocol.py` at line 33
</Card>