router_basic.py
"""
Router Basic
============
Demonstrates topic-based routing between specialized research steps before content publishing.
"""
import asyncio
from typing import List
from agno.agent.agent import Agent
from agno.tools.hackernews import HackerNewsTools
from agno.tools.websearch import WebSearchTools
from agno.workflow.router import Router
from agno.workflow.step import Step
from agno.workflow.types import StepInput
from agno.workflow.workflow import Workflow
# ---------------------------------------------------------------------------
# Create Agents
# ---------------------------------------------------------------------------
hackernews_agent = Agent(
name="HackerNews Researcher",
instructions="You are a researcher specializing in finding the latest tech news and discussions from Hacker News. Focus on startup trends, programming topics, and tech industry insights.",
tools=[HackerNewsTools()],
)
web_agent = Agent(
name="Web Researcher",
instructions="You are a comprehensive web researcher. Search across multiple sources including news sites, blogs, and official documentation to gather detailed information.",
tools=[WebSearchTools()],
)
content_agent = Agent(
name="Content Publisher",
instructions="You are a content creator who takes research data and creates engaging, well-structured articles. Format the content with proper headings, bullet points, and clear conclusions.",
)
# ---------------------------------------------------------------------------
# Define Steps
# ---------------------------------------------------------------------------
research_hackernews = Step(
name="research_hackernews",
agent=hackernews_agent,
description="Research latest tech trends from Hacker News",
)
research_web = Step(
name="research_web",
agent=web_agent,
description="Comprehensive web research on the topic",
)
publish_content = Step(
name="publish_content",
agent=content_agent,
description="Create and format final content for publication",
)
# ---------------------------------------------------------------------------
# Define Router Selector
# ---------------------------------------------------------------------------
def research_router(step_input: StepInput) -> List[Step]:
topic = step_input.previous_step_content or step_input.input or ""
topic = topic.lower()
tech_keywords = [
"startup",
"programming",
"ai",
"machine learning",
"software",
"developer",
"coding",
"tech",
"silicon valley",
"venture capital",
"cryptocurrency",
"blockchain",
"open source",
"github",
]
if any(keyword in topic for keyword in tech_keywords):
print(f"Tech topic detected: Using HackerNews research for '{topic}'")
return [research_hackernews]
print(f"General topic detected: Using web research for '{topic}'")
return [research_web]
# ---------------------------------------------------------------------------
# Create Workflow
# ---------------------------------------------------------------------------
workflow = Workflow(
name="Intelligent Research Workflow",
description="Automatically selects the best research method based on topic, then publishes content",
steps=[
Router(
name="research_strategy_router",
selector=research_router,
choices=[research_hackernews, research_web],
description="Intelligently selects research method based on topic",
),
publish_content,
],
)
# ---------------------------------------------------------------------------
# Run Workflow
# ---------------------------------------------------------------------------
if __name__ == "__main__":
input_text = "Latest developments in artificial intelligence and machine learning"
# Sync
workflow.print_response(input_text)
# Sync Streaming
workflow.print_response(
input_text,
stream=True,
)
# Async
asyncio.run(
workflow.aprint_response(
input_text,
)
)
# Async Streaming
asyncio.run(
workflow.aprint_response(
input_text,
stream=True,
)
)
Run the Example
1
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activate
uv venv --python 3.12
.venv\Scripts\activate
2
Install dependencies
uv pip install -U agno cel-python ddgs fastapi openai
3
Export your OpenAI API key
export OPENAI_API_KEY="your_openai_api_key_here"
$Env:OPENAI_API_KEY="your_openai_api_key_here"
4
Run the example
Save the code above as
router_basic.py, then run:python router_basic.py