Skip to main content

​
AutonomyConfig

Defined in the autonomy module.
AI Agent Configuration for Agent autonomy features. Autonomy is the safety center: doom loops, escalation, sandbox, filesystem tracking, and verification hooks all live here. Attributes: enabled: Whether autonomy is enabled level: Autonomy level (suggest, auto_edit, full_auto) mode: Execution mode — “caller” (single chat call, wrapper-equivalent) or “iterative” (internal loop with completion detection). Defaults based on level: suggest/auto_edit → “caller”, full_auto → “iterative”. max_iterations: Maximum iterations before stopping doom_loop_threshold: Number of repeated actions to trigger doom loop auto_escalate: Whether to automatically escalate complexity observe: Whether to emit observability events completion_promise: Optional string that signals completion when wrapped in <promise>TEXT</promise> clear_context: Whether to clear chat history between iterations verification_hooks: List of VerificationHook instances for output verification track_changes: Whether to track filesystem changes via shadow git. Defaults to True when level=“full_auto”, False otherwise. When enabled, agent.undo()/redo()/diff() become available. sandbox: Optional SandboxConfig, carried for forward compatibility. NOT IMPLEMENTED: nothing currently reads this field, and no sandbox is auto-enabled at any autonomy level. To isolate execution, set it on the agent itself — Agent(sandbox=…) — or run the whole workflow remotely with AgentFlow(run_on=“docker”). snapshot_dir: Directory for snapshot storage. Defaults to ~/.praisonai/snapshots. Usage::

​
Properties

​
bool
No description available.
​
str
No description available.
​
Optional[str]
No description available.
​
int
No description available.
​
int
No description available.
​
bool
No description available.
​
bool
No description available.
​
Optional[str]
No description available.
​
bool
No description available.
​
Optional
No description available.
​
Optional[bool]
No description available.
​
Optional
No description available.
​
Optional[str]
No description available.
​
Optional
No description available.
​
Optional[float]
No description available.
​
Optional[int]
No description available.
​
str
No description available.

​
Methods

effective_track_changes()

Whether track_changes is effectively enabled.
  • from_dict: Create config from dictionary.

​
Source

View on GitHub

praisonaiagents/agent/autonomy.py at line 86

Configuration Overview

Agent Config