Web Context Provider with Parallel
`ParallelBackend` speaks directly to Parallel's web API via the `parallel-web` SDK (>= 1.0).
ParallelBackend speaks directly to Parallel's web API via the parallel-web SDK (>= 1.0). Two tools: web_search(objective) returns URL + excerpt pairs for a natural-language objective; web_extract(url) fetches full-page content.
"""
Web Context Provider with Parallel
==================================
`ParallelBackend` speaks directly to Parallel's web API via the
`parallel-web` SDK (>= 1.0). Two tools: `web_search(objective)` returns
URL + excerpt pairs for a natural-language objective; `web_extract(url)`
fetches full-page content.
Pick this over Exa when you want Parallel's search ranking, excerpt
shape, or pricing.
Requires:
OPENAI_API_KEY
PARALLEL_API_KEY (https://platform.parallel.ai/)
pip install parallel-web
"""
from __future__ import annotations
import asyncio
from agno.agent import Agent
from agno.context.web import ParallelBackend, WebContextProvider
from agno.models.openai import OpenAIResponses
# ---------------------------------------------------------------------------
# Create the provider
# ---------------------------------------------------------------------------
backend = ParallelBackend() # reads PARALLEL_API_KEY from env
web = WebContextProvider(backend=backend, model=OpenAIResponses(id="gpt-5.6-luna"))
# ---------------------------------------------------------------------------
# Create the Agent
# ---------------------------------------------------------------------------
agent = Agent(
model=OpenAIResponses(id="gpt-5.4"),
tools=web.get_tools(),
instructions=web.instructions() + "\nAlways cite URLs inline.",
markdown=True,
)
# ---------------------------------------------------------------------------
# Run the Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
print(f"\nweb.status() = {web.status()}\n")
prompt = "What is the latest stable release of CPython? Cite the source."
print(f"> {prompt}\n")
asyncio.run(agent.aprint_response(prompt))Run the Example
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activateInstall dependencies
uv pip install -U agno openai parallel-webExport your API keys
export OPENAI_API_KEY="your_openai_api_key_here"
export PARALLEL_API_KEY="your_parallel_api_key_here"Run the example
Save the code above as web_parallel.py, then run:
python web_parallel.pyFull source: cookbook/12_context/03_web_parallel.py