human_in_the_loop.py
"""
Human in the Loop — Dojo Demo
==============================
HITL tool: generate_task_steps (requires_confirmation)
Dojo expects generate_task_steps that returns:
- steps: list of {description: str, status: "enabled"|"disabled"|"executing"}
The frontend renders a step selector UI where user can toggle steps and confirm/reject.
"""
from typing import List
from agno.agent.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools import tool
from pydantic import BaseModel, Field
class TaskStep(BaseModel):
description: str = Field(description="Description of the step")
status: str = Field(
default="enabled", description="Status: enabled, disabled, or executing"
)
@tool(requires_confirmation=True)
def generate_task_steps(steps: List[TaskStep]) -> str:
"""Generate a list of task steps for the user to review and confirm.
The frontend will display these steps with checkboxes.
User can enable/disable steps before confirming execution.
"""
enabled_steps = [s for s in steps if s.status == "enabled"]
return f"Executing {len(enabled_steps)} steps: " + ", ".join(
s.description for s in enabled_steps
)
hitl_agent = Agent(
name="human_in_the_loop",
model=OpenAIResponses(id="gpt-5.5"),
tools=[generate_task_steps],
instructions="""You help users plan tasks that require confirmation.
When asked to plan something (trip, recipe, project, etc.):
1. Break it down into clear steps (5-10 steps typically)
2. Use the generate_task_steps tool with a list of steps
3. Each step should have a description and status="enabled"
Example: For "plan a trip to Paris", create steps like:
- Book flights
- Reserve hotel
- Plan activities
- Pack luggage
- etc.
The user will review and confirm which steps to execute.""",
markdown=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[agui,os]" ddgs google-genai openai requests
3
Export your API keys
export GOOGLE_API_KEY="your_google_api_key_here"
export OPENAI_API_KEY="your_openai_api_key_here"
$Env:GOOGLE_API_KEY="your_google_api_key_here"
$Env:OPENAI_API_KEY="your_openai_api_key_here"
4
Clone Agno
Clone the repository and run the remaining commands from its root:
git clone https://github.com/agno-agi/agno.git
cd agno
5
Run the example
Run the example from the repository root:
python cookbook/05_agent_os/interfaces/agui/showcase.py