Confirmation Required with Multiple Tools

This example demonstrates human-in-the-loop functionality with multiple tools that require confirmation. It shows how to handle user confirmation during tool execution and gracefully cancel operations based on user choice.

1. Create a Python file

   confirmation_required_multiple_tools.py

   import json
   import httpx
   from agno.agent import Agent
   from agno.db.sqlite import SqliteDb
   from agno.models.openai import OpenAIResponses
   from agno.tools import tool
   from agno.tools.wikipedia import WikipediaTools
   from agno.utils import pprint
   from rich.console import Console
   from rich.prompt import Prompt
   
   console = Console()
   
   
   @tool(requires_confirmation=True)
   def get_top_hackernews_stories(num_stories: int) -> str:
       """Fetch top stories from Hacker News.
   
       Args:
           num_stories (int): Number of stories to retrieve
   
       Returns:
           str: JSON string containing story details
       """
       # Fetch top story IDs
       response = httpx.get("https://hacker-news.firebaseio.com/v0/topstories.json")
       story_ids = response.json()
   
       # Yield story details
       all_stories = []
       for story_id in story_ids[:num_stories]:
           story_response = httpx.get(
               f"https://hacker-news.firebaseio.com/v0/item/{story_id}.json"
           )
           story = story_response.json()
           if "text" in story:
               story.pop("text", None)
           all_stories.append(story)
       return json.dumps(all_stories)
   
   
   agent = Agent(
       model=OpenAIResponses(id="gpt-5.2"),
       tools=[
           get_top_hackernews_stories,
           WikipediaTools(requires_confirmation_tools=["search_wikipedia"]),
       ],
       markdown=True,
       db=SqliteDb(db_file="tmp/example.db"),
   )
   
   run_response = agent.run(
       "Fetch 2 articles about the topic 'python'. You can choose which source to use, but only use one source."
   )
   while run_response.is_paused:
       for requirement in run_response.active_requirements:
           if requirement.needs_confirmation:
               # Ask for confirmation
               console.print(
                   f"Tool name [bold blue]{requirement.tool_execution.tool_name}({requirement.tool_execution.tool_args})[/] requires confirmation."
               )
               message = (
                   Prompt.ask("Do you want to continue?", choices=["y", "n"], default="y")
                   .strip()
                   .lower()
               )
   
               if message == "n":
                   requirement.reject(
                       "This is not the right tool to use. Use the other tool!"
                   )
               else:
                   requirement.confirm()
   
       run_response = agent.continue_run(
           run_id=run_response.run_id,
           requirements=run_response.requirements,
       )
       pprint.pprint_run_response(run_response)
   
2. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   
3. Install dependencies

   uv pip install -U agno openai httpx rich
   
4. Export your OpenAI API key

   Mac/Linux

     export OPENAI_API_KEY="your_openai_api_key_here"
   
5. Run Agent

   python confirmation_required_multiple_tools.py