WikiContextProvider as 14_wiki_filesystem.py, but with a web backend wired in. The write sub-agent gets the workspace tools plus web_search / web_fetch from ExaMCPBackend (keyless), so a single update_wiki(...) call can fetch a URL or search the web, digest the result, and file it as a wiki page.
wiki_with_web.py
"""
Wiki Context Provider (filesystem + web ingestion)
==================================================
Same `WikiContextProvider` as `14_wiki_filesystem.py`, but with a
web backend wired in. The write sub-agent gets the workspace tools
plus `web_search` / `web_fetch` from `ExaMCPBackend` (keyless), so a
single `update_wiki(...)` call can fetch a URL or search the web,
digest the result, and file it as a wiki page.
The read sub-agent stays scoped to the wiki on purpose — "what does
the wiki say about X" should answer from the wiki, not silently
consult the web. Compose a separate `WebContextProvider` at the
outer agent if you want web on the read path.
Requires: OPENAI_API_KEY
"""
from __future__ import annotations
import asyncio
import shutil
from pathlib import Path
from agno.agent import Agent
from agno.context.web import ExaMCPBackend
from agno.context.wiki import FileSystemBackend, WikiContextProvider
from agno.models.openai import OpenAIResponses
# ---------------------------------------------------------------------------
# Seed an empty wiki directory next to the cookbook
# ---------------------------------------------------------------------------
WIKI_PATH = Path(__file__).resolve().parent / "demo-wiki-web"
if WIKI_PATH.exists():
shutil.rmtree(WIKI_PATH)
WIKI_PATH.mkdir()
(WIKI_PATH / "README.md").write_text(
"# Demo Wiki (with web ingestion)\n\n"
"Pages live under `papers/`, `articles/`, and the root.\n"
)
# ---------------------------------------------------------------------------
# Create the provider — storage + web ingestion are two separate backends.
# ExaMCPBackend keyless is good enough for the demo; swap for ExaBackend
# or ParallelMCPBackend if you have keys.
# ---------------------------------------------------------------------------
wiki = WikiContextProvider(
id="wiki",
backend=FileSystemBackend(path=WIKI_PATH),
web=ExaMCPBackend(),
model=OpenAIResponses(id="gpt-5.4-mini"),
)
# ---------------------------------------------------------------------------
# Create the Agent
# ---------------------------------------------------------------------------
agent = Agent(
model=OpenAIResponses(id="gpt-5.4"),
tools=wiki.get_tools(),
instructions=wiki.instructions(),
markdown=True,
)
# ---------------------------------------------------------------------------
# Run the Agent
# ---------------------------------------------------------------------------
async def _run() -> None:
await wiki.asetup()
try:
print(f"\nwiki.status() = {wiki.status()}\n")
ingest_prompt = (
"Add a one-page summary of CPython's release schedule to "
"papers/cpython-release-cycle.md. Search the web (python.org "
"or PEP 602) for the source, digest it into a brief markdown "
"page, and cite the URL in a Source section."
)
print(f"> {ingest_prompt}\n")
await agent.aprint_response(ingest_prompt)
print()
read_prompt = (
"What does the wiki say about CPython's release cycle? Cite the page."
)
print(f"> {read_prompt}\n")
await agent.aprint_response(read_prompt)
ingested = list(WIKI_PATH.glob("papers/*.md"))
assert ingested, "agent did not file any pages under papers/"
print(f"\n[ok] ingested {len(ingested)} page(s):")
for p in ingested:
print(f" {p.relative_to(WIKI_PATH)} ({p.stat().st_size} bytes)")
finally:
await wiki.aclose()
if __name__ == "__main__":
asyncio.run(_run())
Run the Example
1
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activate
uv venv --python 3.12
.venv\Scripts\activate
2
Install dependencies
uv pip install -U agno notion-client openai
3
Export your API keys
export EXA_API_KEY="your_exa_api_key_here"
export NOTION_API_KEY="your_notion_api_key_here"
export OPENAI_API_KEY="your_openai_api_key_here"
$Env:EXA_API_KEY="your_exa_api_key_here"
$Env:NOTION_API_KEY="your_notion_api_key_here"
$Env:OPENAI_API_KEY="your_openai_api_key_here"
4
Run the example
Save the code above as
wiki_with_web.py, then run:python wiki_with_web.py