> ## Documentation Index
> Fetch the complete documentation index at: https://ctrlrun-docs-python-3-13-3-14.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Action

> A proposed agent action: what, with which arguments, by whom, on what.

`ctrlrun.Action` — class, defined at `src/ctrlrun/action.py:178`

```python theme={null}
from ctrlrun import Action
```

```python theme={null}
class Action
    def __init__(name: str, arguments: Mapping[str, Any], principal: Principal, resource: str | None = None, environment: str = 'production', action_id: str = _new_action_id())
```

A proposed agent action: what, with which arguments, by whom, on what.

Equality and hashing follow the proposal, not the content: two Actions are equal iff
their `action_id` matches (SPEC-v0.1 §2.1). Identical content shares an `action_hash`.

## Next

* [Python API index](/docs/reference/api/index).
* [Get started](/docs/get-started/quickstart) · [Why](/docs/why).