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

​
Quick Start

1

Suggest Mode (Safest)

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..."
2

Full Auto Mode

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

ModeBehavior
suggestOnly suggests, never acts
auto_editAsks before making changes
full_autoActs without asking

​
API Reference

AgentConfig

Agent configuration including autonomy

​
Best Practices

Begin in suggest mode until you trust the agent’s decisions.
Auto-edit balances speed with human oversight.
Only use full_auto for well-tested, low-risk workflows.

Approval

Human approval

Guardrails

Safety limits