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.

Decision Guide

This guide helps you choose the right integration model for your use case.

Quick Decision Tree

Comparison Matrix

CriteriaModel 1Model 2Model 3Model 4Model 5Model 6
LatencyLowestLowMediumMediumVariableLow
LanguagePythonAnyAnyAnyAnyPlatform
ComplexityLowLowMediumHighHighMedium
Multi-tenant
Async
Auth built-in
Streaming

By Use Case

Use CasePrimary ModelAlternative
SaaS support repliesModel 3/4Model 1
Meeting notesModel 2/5Model 1
SQL assistantModel 1Model 3
Code reviewModel 6/2Model 3
Marketing contentModel 3Model 5
Customer onboardingModel 4Model 3
Fraud detectionModel 5Model 4
Document Q&AModel 1/3Model 4
Sales coachingModel 5Model 2
Data migrationModel 2Model 1
Multi-agent routerModel 1/3Model 4
LocalizationModel 5/2Model 3

By Environment

Development

  • Recommended: Model 1 (SDK) or Model 2 (CLI)
  • Why: Fast iteration, easy debugging

Staging

  • Recommended: Model 3 (HTTP Sidecar)
  • Why: Mimics production, tests HTTP integration

Production

  • Recommended: Model 4 (Remote Runner) or Model 5 (Event-Driven)
  • Why: Scalable, secure, monitored

Configuration Consolidation

Using agents.yaml for All Config

You can consolidate serve configuration into your existing agents.yaml file instead of maintaining a separate serve.yaml:
# agents.yaml - unified configuration
framework: praisonai
topic: My Application

# Agent definitions
roles:
  assistant:
    role: AI Assistant
    goal: Help users
    tasks:
      respond:
        description: Respond to {query}

# Server configuration (optional section)
serve:
  host: 127.0.0.1
  port: 8765
  auth: api-key
  preload: true
  recipes:
    - my-recipe
    - another-recipe
Then start the server:
praisonai serve recipe --config agents.yaml
This approach:
  • ✅ Single configuration file
  • ✅ Agent definitions + server config together
  • ✅ Easier to manage
  • ✅ Version control friendly

Next Steps