Autonomy - PraisonAI

Agents can operate at different autonomy levels - from suggesting actions to fully autonomous.

Quick Start

Simple Usage

import { Agent } from 'praisonai';

const agent = new Agent({
  instructions: 'You help with code',
  autonomy: 'suggest'  // Only suggests, never acts
});

await agent.chat('Fix the bug in app.js');
// → "I suggest changing line 42 to..."

With Configuration

const agent = new Agent({
  instructions: 'You complete tasks autonomously',
  autonomy: 'full_auto'
});

await agent.chat('Update the readme');
// → Agent edits the file directly

User Interaction Flow

Configuration Levels

// Level 1: String - Named mode
const agent = new Agent({
  autonomy: 'suggest'  // 'suggest', 'auto_edit', 'full_auto'
});

// Level 2: Dict - With limits
const agent = new Agent({
  autonomy: {
    mode: 'auto_edit',
    maxEdits: 10,
    requireConfirmation: true
  }
});

// Level 3: Instance - Full control
import { AutonomyManager } from 'praisonai';

const manager = new AutonomyManager({
  mode: 'full_auto',
  policies: {
    allowFileEdits: true,
    allowCommands: false
  }
});

Autonomy Modes

Mode	Behavior
`suggest`	Only suggests, never acts
`auto_edit`	Asks before making changes
`full_auto`	Acts without asking

API Reference

AgentConfig

Agent configuration including autonomy

Best Practices

Start with suggest

Begin in suggest mode until you trust the agent’s decisions.

Use auto_edit for productivity

Auto-edit balances speed with human oversight.

Reserve full_auto for safe tasks

Only use full_auto for well-tested, low-risk workflows.

Approval

Human approval

Guardrails

Safety limits

​Quick Start

​User Interaction Flow

​Configuration Levels

​Autonomy Modes

​API Reference