Recipe Integration Guide

Complete guide to integrating PraisonAI recipes into your applications

Navigate personas, integration models, and use cases for shipping PraisonAI recipes in production.

python

from praisonaiagents import Agent

agent = Agent(
    name="Recipe Guide",
    instructions="Point developers to the right recipe integration docs.",
)
agent.start("Where should I start integrating a customer-support recipe?")

The user picks a path below—models, personas, or use cases—to implement recipes in their app.

Diagram

Quick Start

Simple Usage

List and run a recipe from the CLI.

bash

praisonai recipe list
praisonai recipe run my-recipe --input '{"query": "Hello"}'

With Configuration
Serve recipes over HTTP so any language can call them.
bash
```
praisonai serve recipe --port 8765
```

How It Works

Diagram

Quick Navigation

Integration Models

6 ways to integrate recipes into your stack

Use Cases

12 real-world implementation patterns

Personas

Who uses recipes and how

Decision Guide

When to use which integration model

What Are Recipes?

Recipes are pre-packaged, reusable AI workflows that encapsulate:

Agent configurations
Tool assignments
Workflow logic
Input/output schemas
Security policies

Key Benefits

Reusability: Package once, deploy anywhere
Consistency: Same behavior across environments
Security: Built-in policy enforcement
Observability: Structured logging and tracing
Versioning: Track and rollback changes

Getting Started

bash

# List available recipes
praisonai recipe list

# Run a recipe
praisonai recipe run my-recipe --input '{"query": "Hello"}'

# Start the recipe server
praisonai serve recipe --port 8765

Best Practices

Pick the integration model before writing code

Six models trade latency, language, and operational complexity. The Decision Guide maps your stack to the right one.

Version recipes like code

Recipes package agents, tools, and policies together. Keep them in source control so behaviour stays consistent across environments and rolls back cleanly.

Serve over HTTP for polyglot stacks

praisonai serve recipe exposes recipes to any language via REST. Reach for the sidecar model when the caller is not Python.

Next Steps

Review the Integration Models to choose your approach
Explore Use Cases for implementation patterns
Follow the step-by-step tutorials for your chosen model