Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.praison.ai/llms.txt

Use this file to discover all available pages before exploring further.

PraisonAI tools are designed with reliability-first principles.

Search Provider Priority

Automatic Fallback

search_web tries providers in order until one succeeds

Retry Logic

Each provider retries 3 times with exponential backoff

Quick Start

Error Handling

results = search_web("query")
if results and "error" in results[0]:
    print(f"Failed: {results[0]['error']}")
System processes may return None for CPU/memory. Defaults to 0.0.

API Keys

ProviderEnvironment VariableQuality
TavilyTAVILY_API_KEY⭐⭐⭐ Best
ExaEXA_API_KEY⭐⭐⭐ Best
You.comYDC_API_KEY⭐⭐ Good
DuckDuckGoNone needed⭐ Basic
Set TAVILY_API_KEY for best search quality. DuckDuckGo is the free fallback.

Auto-Approve Tools

approve:
  - write_file
  - execute_command

agents:
  writer:
    tools:
      - write_file
Only auto-approve tools you trust.

Schema-level Reliability

Runtime reliability (error handling, retries, fallbacks) complements schema-time reliability for comprehensive tool safety. Schema validation catches broken tools at development time:
  • Invalid OpenAI function schemas
  • Missing required fields like properties
  • Non-JSON-serializable values
  • Duplicate tool names in lists
Runtime reliability handles execution errors:
  • Network failures and timeouts
  • API rate limits and retries
  • Provider fallbacks
  • Process crashes
For schema validation details and fixing validation errors, see Tool Schema Validation.