Agent with External URL Input

Code

cookbook/11_models/google/gemini/external_url_input.py

"""External URL input with Gemini.

Pass files from public HTTPS URLs directly without downloading.
Supports files up to 100MB. Requires Gemini 3.x models.
"""

from agno.agent import Agent
from agno.media import File
from agno.models.google import Gemini

agent = Agent(
    model=Gemini(id="gemini-3-flash-preview"),
    markdown=True,
)

agent.print_response(
    "Summarize this document.",
    files=[
        File(
            url="https://agno-public.s3.amazonaws.com/recipes/ThaiRecipes.pdf",
            mime_type="application/pdf",
        )
    ],
)

Usage

1. Set up your virtual environment

   Mac

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

   uv venv --python 3.12
   .venv\Scripts\activate
   
2. Set your API key

   export GOOGLE_API_KEY=xxx
   
3. Install dependencies

   pip install -U google-genai agno
   
4. Run Agent

   python cookbook/11_models/google/gemini/external_url_input.py