AgentOven

Recipes Guide

How to create, bake, approve, and manage AgentOven recipes from manifests and the CLI.

AgentOven recipes are DAG-based workflows for multi-agent systems. A recipe can chain agents, pause for human approval, branch into parallel steps, and resume with the next stage when the gate is approved.

The SDK supports real recipe objects for both parallel and sequential workflows.

1. Start with a recipe manifest

Use YAML when you want a portable definition that teams can review in git.

yaml

name: content-review
description: Review, rewrite, and approve a document
steps:
  - id: research
    agent: research-bot
  - id: review
    kind: human-gate
    notify: ["slack:#content-review"]
  - id: write
    agent: content-writer
    depends_on: [review]
  - id: approve
    kind: human-gate
    notify: ["slack:#content-ops"]
  - id: publish
    agent: publisher
    depends_on: [approve]

Each step should have a unique id. Use agent steps for work done by agents and kind: human-gate steps when a person must approve the next phase.

2. Create the recipe

bash

agentoven recipe create content-review --from recipe.yaml

In Python, the equivalent flow uses Recipe, Step, client.create_recipe(...), and client.bake_recipe(...).

python

from agentoven import AgentOvenClient, Recipe, Step

client = AgentOvenClient()
recipe = Recipe(
  name="content-review",
  steps=[
    Step(name="research", agent="research-bot"),
    Step(name="approve", human_gate=True, depends_on=["research"]),
  ],
)

client.create_recipe(recipe)
run_id = client.bake_recipe("content-review", input={"topic": "launch post"})

If you prefer declarative management for multiple resources, you can also use agentoven apply with a manifest that contains both agents and recipes.

bash

agentoven apply -f platform.yaml
3. Bake and run it

bash

agentoven recipe bake content-review --input '{"document_url":"https://example.com/doc"}'

The run will stream step status as the DAG executes. If the recipe includes a human gate, the run pauses until the gate is approved.

4. Approve a gate

bash

agentoven recipe approve content-review \
  --run-id abc123 \
  --gate-id gate-1 \
  --approved true \
  --comment "Approved for publish"

That resumes the workflow from the next step.

5. Common patterns