Skip to main content

Overview

Allows models to access and read contents from URLs directly.

Usage

from upsonic import Agent, Task
from upsonic.tools.builtin_tools import UrlContextTool

# Create URL context tool
url_tool = UrlContextTool()

# Create task
task = Task(
    description="Read content from https://docs.python.org and explain Python basics.",
    tools=[url_tool]
)

# Create agent with Google model (required for UrlContextTool)
agent = Agent(
    model="google-gla/gemini-2.5-pro",
    name="URL Context Agent"
)

# Execute
agent.print_do(task)

Advanced Example

from upsonic.tools.builtin_tools import UrlContextTool
from upsonic import Agent, Task

url_tool = UrlContextTool()

# Multiple URL access task
task = Task(
    description="""
    Access and analyze these documentation pages:
    1. https://docs.python.org
    2. https://www.python.org/dev/peps/

    Provide a summary of Python's key features and recent PEPs
    """,
    tools=[url_tool]
)

agent = Agent(model="google-gla/gemini-2.5-pro", name="Multi-URL Agent")
agent.print_do(task)

Parameters

  • No configuration parameters (provider-managed)

Provider Support

  • Google: ✅ Exclusive support
  • Other providers: ❌ Not supported

Characteristics

  • Direct URL content access
  • Provider-managed fetching and parsing
  • Automatic handling of different content types
  • Built-in security and validation