Manage Recipes

Step-by-step guide to updating, editing, and deleting recipes

Update recipe versions, validate changes, and retire old templates safely.

python

from praisonaiagents import Agent

agent = Agent(name="Recipe Maintainer", instructions="Guide safe recipe updates and rollbacks.")
agent.start("How do I version my recipe changes?")

The user edits agents.yaml, validates the folder, and re-runs the recipe with updated variables.

Diagram

How It Works

Diagram

How to Update a Recipe

Check Current Version
bash
```
praisonai recipe info my-recipe
```

Edit agents.yaml

Update the configuration and make changes:

yaml

# agents.yaml
framework: praisonai
topic: "{{task}}"

roles:
  agent:
    role: Updated Agent
    goal: Updated goal
    # ... modifications

Validate Changes
bash
```
praisonai recipe validate ./my-recipe
```

Test Updated Recipe

bash

praisonai recipe run ./my-recipe --var task="Test task"

How to Edit Recipe Variables

View Current Variables
bash
```
praisonai recipe info my-recipe
```

Use Variables in agents.yaml

yaml

framework: praisonai
topic: "{{task}}"

roles:
  agent:
    role: "{{role_name}}"
    goal: Complete the task
    tasks:
      main_task:
        description: |
          Task: {{task}}
          Format: {{output_format}}

Run with Variables

bash

praisonai recipe run my-recipe --var task="Research AI" --var output_format="markdown"

How to Delete a Recipe

List Installed Recipes
bash
```
praisonai recipe list
```
Remove Recipe
bash
```
praisonai recipe remove my-recipe
```
Verify Removal
bash
```
praisonai recipe list
```

Recipe Management Commands

Command	Description
`praisonai recipe list`	List all recipes
`praisonai recipe info <name>`	Show recipe details
`praisonai recipe validate <path>`	Validate recipe
`praisonai recipe remove <name>`	Remove recipe

Best Practices

Validate after every edit

Run praisonai recipe validate before re-running so a bad change is caught while it is easy to fix.

Track recipes in version control

Commit agents.yaml and tools.py so changes are reviewable and a broken update can be rolled back cleanly.

Confirm removal with list

After praisonai recipe remove, run praisonai recipe list to verify the recipe is gone and no callers still reference it.

Debug Recipes

Troubleshoot a failing update

Create Custom Recipes

Author a new recipe