Async Tools

Demonstrates async team execution with mixed research and scraping tools.

async_tools.py
"""
Async Tools
===========

Demonstrates async team execution with mixed research and scraping tools.
"""

import asyncio
from uuid import uuid4

from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.team import Team
from agno.tools.agentql import AgentQLTools
from agno.tools.websearch import WebSearchTools
from agno.tools.wikipedia import WikipediaTools

# ---------------------------------------------------------------------------
# Setup
# ---------------------------------------------------------------------------
custom_query = """
{
    title
    text_content[]
}
"""

# ---------------------------------------------------------------------------
# Create Members
# ---------------------------------------------------------------------------
wikipedia_agent = Agent(
    name="Wikipedia Agent",
    role="Search wikipedia for information",
    model=OpenAIResponses(id="gpt-5-mini"),
    tools=[WikipediaTools()],
    instructions=[
        "Find information about the company in the wikipedia",
    ],
)

website_agent = Agent(
    name="Website Agent",
    role="Search the website for information",
    model=OpenAIResponses(id="gpt-5-mini"),
    tools=[WebSearchTools()],
    instructions=[
        "Search the website for information",
    ],
)

# ---------------------------------------------------------------------------
# Create Team
# ---------------------------------------------------------------------------
user_id = str(uuid4())
team_id = str(uuid4())

company_info_team = Team(
    name="Company Info Team",
    id=team_id,
    model=OpenAIResponses(id="gpt-5.2"),
    tools=[AgentQLTools(agentql_query=custom_query)],
    members=[wikipedia_agent, website_agent],
    markdown=True,
    instructions=[
        "You are a team that finds information about a company.",
        "First search the web and wikipedia for information about the company.",
        "If you can find the company's website URL, then scrape the homepage and the about page.",
    ],
    show_members_responses=True,
)

# ---------------------------------------------------------------------------
# Run Team
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    asyncio.run(
        company_info_team.aprint_response(
            "Write me a full report on everything you can find about Agno, the company building AI agent infrastructure.",
            stream=True,
        )
    )

Browser setup and extraction

Install Chromium after the Python dependencies:

python -m playwright install chromium

AgentQLTools opens a visible browser, so run this example with a desktop display. Its current custom-query method returns dictionary keys rather than extracted values. Replace AgentQLTools(agentql_query=custom_query) with AgentQLTools() to use the default text-content scraper. This keeps scraping on the team leader; the two members provide Wikipedia and web search results.

Run the Example

Set up your virtual environment

uv venv --python 3.12
source .venv/bin/activate

Install dependencies

uv pip install -U agno agentql ddgs openai playwright wikipedia

Export your API keys

export AGENTQL_API_KEY="your_agentql_api_key_here"
export OPENAI_API_KEY="your_openai_api_key_here"

Run the example

Save the code above as async_tools.py, then run:

python async_tools.py

Full source: cookbook/03_teams/03_tools/async_tools.py