Skip to main content
Integrate custom API tools with Agno agents for specialized workflows specific to your use case.

​
Prerequisites

  • You can pass the following arguments when instantiating agents to use custom API tools:
    • ‘base_url’ (Optional[str]): Base URL for API calls
    • ‘username’ (Optional[str]): Username for basic authentication
    • ‘password’ (Optional[str]): Password for basic authentication
    • ‘api_key’ (Optional[str]): API key for authentication
    • ‘headers’ (Optional[Dict[str, str]]): Default headers to include in requests
    • ‘verify_ssl’ (bool): Whether to verify SSL certificates
    • ‘timeout’ (int): Request timeout in seconds

from agno.agent import Agent
from agno.tools.api import CustomApiTools

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------

# Example 1: Enable specific API functions
agent = Agent(
    tools=[CustomApiTools(base_url="https://dog.ceo/api", enable_make_request=True)],
    markdown=True,
)

# Example 2: Enable all API functions
agent_all = Agent(
    tools=[CustomApiTools(base_url="https://dog.ceo/api", all=True)],
    markdown=True,
)

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    agent.print_response(
        'Make api calls to the following two different endpoints- /breeds/image/random and /breeds/list/all to get a random dog image and list of dog breeds respectively. Make sure that the method is "GET" for both the api calls.'
    )

​
Run the Example

# Clone and setup repo
git clone https://github.com/agno-agi/agno.git
cd agno/cookbook/91_tools

# Create and activate virtual environment
./scripts/demo_setup.sh
source .venvs/demo/bin/activate

python custom_api_tools.py
For details, see csv-tools cookbook.