Model Routing

How PraisonAI decides which vendor your model string reaches

PraisonAI picks the vendor from your model string, so claude-3-5-sonnet-latest goes to Anthropic and gemini-2.0-flash goes to Google — no prefix required.

Quick Start

1. Just name the model

   Name the model and PraisonAI routes it to the right vendor.

   import { Agent } from 'praisonai';
   
   const openai = new Agent({ instructions: 'x', llm: 'gpt-4o-mini' });
   const claude = new Agent({ instructions: 'x', llm: 'claude-3-5-sonnet-latest' });
   const gemini = new Agent({ instructions: 'x', llm: 'gemini-2.0-flash' });
   
   await claude.chat('Hello!');

2. Be explicit when the name isn't enough

   Add a provider/ prefix for custom-named or gateway models the bare name would not resolve.

   import { Agent } from 'praisonai';
   
   const anthropic = new Agent({ instructions: 'x', llm: 'anthropic/my-custom-claude' });
   const openai    = new Agent({ instructions: 'x', llm: 'openai/gpt-4o' });
   const google    = new Agent({ instructions: 'x', llm: 'google/gemini-2.0-flash' });

How It Works

PraisonAI runs four checks in order to resolve every model string.

An explicit provider/model prefix wins over everything, including a custom baseURL.

Routing Decision Table

This table is the single source of truth for user-visible routing behaviour.

The baseURL Exception

import { Agent } from 'praisonai';

// Bare name + baseURL → stays OpenAI-compatible (proxy case)
new Agent({ llm: 'claude-3-5-sonnet-latest',
            baseURL: 'https://my-gateway.example/v1' });

// Explicit prefix + baseURL → explicit prefix wins (unambiguous)
new Agent({ llm: 'anthropic/claude-3-5-sonnet-latest',
            baseURL: 'https://my-gateway.example/v1' });

Per-Agent Credentials

Pass apiKey on the agent and PraisonAI honours it for whichever provider the model routes to.

import { Agent } from 'praisonai';

const agent = new Agent({
  instructions: 'You are helpful.',
  llm: 'claude-3-5-sonnet-latest',
  apiKey: process.env.MY_ANTHROPIC_KEY,   // no ANTHROPIC_API_KEY needed
});

A programmatically-passed apiKey is honoured for every provider — env vars are optional, not required.

Best Practices

Related