Skip to main content
Agents can track and limit token usage for cost control.

​
Quick Start

1

Simple Usage

import { Agent } from 'praisonai';

const agent = new Agent({
  instructions: 'You are concise',
  maxTokens: 1000  // Limit output tokens
});

await agent.chat('Write a summary');
2

With Configuration

const result = await agent.chat('Hello');
console.log('Tokens used:', result.usage);
// { input: 5, output: 20, total: 25 }

​
User Interaction Flow

​
Configuration Levels

// Level 1: Number - Simple limit
const agent = new Agent({
  maxTokens: 1000
});

// Level 2: Dict - Multiple limits
const agent = new Agent({
  tokens: {
    maxInput: 4000,
    maxOutput: 1000
  }
});

// Level 3: Instance - Full control
const agent = new Agent({
  tokens: {
    maxInput: 4000,
    maxOutput: 2000,
    maxTotal: 8000,
    trackUsage: true,
    onLimit: (usage) => console.warn('Limit reached')
  }
});

​
Token Options

OptionDescription
maxTokensLimit output tokens
maxInputLimit input tokens
maxTotalTotal token budget
trackUsageEnable usage tracking

​
API Reference

LLM Module

LLM configuration including tokens

​
Best Practices

Prevent unexpectedly long responses.
Monitor costs with trackUsage.
Use token counts to estimate API costs.

Providers

LLM providers

Execution

Execution settings