Tool Use

Call DuckDuckGoTools through the local Ollama Responses endpoint.

Use Ollama server v0.13.3 or later, independently of the installed Python SDK version. Follow the standalone setup below: this program uses gpt-oss:20b, despite the older llama3.1:8b pull command in the preserved source comment.

tool_use.py
"""Tool use example using Ollama with the OpenAI Responses API.

This demonstrates using tools with Ollama's Responses API endpoint.

Requirements:
- Ollama v0.13.3 or later running locally
- Run: ollama pull llama3.1:8b
"""

from agno.agent import Agent
from agno.models.ollama import OllamaResponses
from agno.tools.duckduckgo import DuckDuckGoTools

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

agent = Agent(
    model=OllamaResponses(id="gpt-oss:20b"),
    tools=[DuckDuckGoTools()],
    markdown=True,
)

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    # --- Sync ---
    agent.print_response("What is the latest news about AI?")

    # --- Sync + Streaming ---
    agent.print_response("What is the latest news about AI?", stream=True)

Run the Example

Set up your virtual environment

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

Install dependencies

uv pip install -U agno ddgs ollama openai

Select the local Ollama server

In the shell used for the pull commands and Python example, clear a previous cloud key and point native clients and embeddings at your local server:

unset OLLAMA_API_KEY
export OLLAMA_HOST="http://localhost:11434"

Without this reset, OLLAMA_API_KEY makes Agno's default Ollama model route to https://ollama.com even when OLLAMA_HOST points locally. Keep a local Ollama server running for the following steps.

Prepare Ollama

Install and start Ollama server v0.13.3 or later, then pull the model used by this example:

ollama pull gpt-oss:20b

Run the example

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

python tool_use.py

Full source: cookbook/90_models/ollama/responses/tool_use.py