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

# autonomy • AI Agent SDK

> Agent Autonomy Module.

# autonomy

AI Agent

Agent Autonomy Module.

Provides agent-centric autonomy configuration and helpers.
This module integrates escalation, doom loop detection, and observability
directly into the Agent class as first-class capabilities.

Unified Architecture:

* AutonomyStage is an alias for EscalationStage (single source of truth)
* AutonomyTrigger delegates to EscalationTrigger (DRY)
* DoomLoopTracker adds recovery actions on top of basic detection

Usage:

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

# Enable autonomy with defaults
agent = Agent(instructions="...", autonomy=True)

# Enable with custom config
agent = Agent(
    instructions="...",
    autonomy={
        "max_iterations": 30,
        "doom_loop_threshold": 5,
        "auto_escalate": True
    }
)

# Run autonomous task
result = agent.run_autonomous("Refactor the auth module")
print(result.success, result.output)
```

## Import

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

## Classes

> [card] [AutonomyConfig](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/AutonomyConfig.md)
>
> Configuration for Agent autonomy features.

> [card] [AutonomySignal](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/AutonomySignal.md)
>
> Signals detected from prompts for autonomy decisions.

> [card] [AutonomyTrigger](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/AutonomyTrigger.md)
>
> Detects signals from prompts for autonomy decisions.

> [card] [AutonomyResult](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/AutonomyResult.md)
>
> Result of an autonomous execution.

> [card] [DoomLoopTracker](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/DoomLoopTracker.md)
>
> Tracks actions to detect doom loops with graduated recovery.

> [card] [AutonomyMixin](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/AutonomyMixin.md)
>
> Helper-only trait for autonomy utilities.

### Constants

| Name | Value |
| - | - |
| `VALID_AUTONOMY_LEVELS` | `{'suggest', 'auto_edit', 'full_auto'}` |
| `_ESCALATION_TO_AUTONOMY_SIGNAL` | `{'simple_question': 'simple_question', 'file_references': 'file_references', 'code_blocks': 'code_blocks', 'edit_intent': 'edit_intent', 'test_intent': 'test_intent', 'refactor_intent': 'refactor_inte...` |
| `_AUTONOMY_TO_ESCALATION_SIGNAL` | `{v: k for k, v in _ESCALATION_TO_AUTONOMY_SIGNAL.items()}` |
| `VALID_AUTONOMY_MODES` | `{'caller', 'iterative'}` |
| `_LEVEL_TO_DEFAULT_MODE` | `{'suggest': 'caller', 'auto_edit': 'caller', 'full_auto': 'iterative'}` |


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