Agentic Prompt Chaining

Chain agents so each step's output feeds the next

Run agents in sequence — each step receives the previous step’s output.

from praisonaiagents import Agent, AgentFlow

researcher = Agent(name="Researcher", instructions="Research the topic. Return facts only.")
writer = Agent(name="Writer", instructions="Turn the research into a clear summary.")

flow = AgentFlow(steps=[researcher, writer])
result = flow.start("Benefits of renewable energy")
print(result["output"])

The user submits one goal; each agent step passes its output to the next.

Quick Start

1. Simple Usage

   Chain two agents with AgentFlow:

   from praisonaiagents import Agent, AgentFlow
   
   researcher = Agent(name="Researcher", instructions="Research the topic.")
   writer = Agent(name="Writer", instructions="Write a summary from the research.")
   
   flow = AgentFlow(steps=[researcher, writer])
   result = flow.start("Benefits of renewable energy")

2. With Configuration

   Add branching with route and step hooks:

   from praisonaiagents import Agent, AgentFlow, route, Task
   
   classifier = Agent(name="Classifier", instructions="Classify the request as success or failure.")
   
   flow = AgentFlow(
       steps=[
           classifier,
           route({
               "success": [Agent(name="Process", instructions="Process the request.")],
               "failure": [Agent(name="Fallback", instructions="Handle the error.")],
           }),
       ],
   )

How It Works

AgentFlow runs steps in order. Each agent’s reply becomes the next step’s input. Use route() for conditional paths, Task(should_run=...) to skip steps, or StepResult(stop_workflow=True) to exit early.

Configuration Options

Best Practices

Related