infochanged

Agents - New web_search tool in the Agents SDK, powered by the Cloudflare Web Search API

Announced: 2026-10-12
Tags: Agents
Severity: info, set by reef/rss-rule-v1
Source: https://developers.cloudflare.com/changelog/post/2026-10-12-web-search/

The <a href="https://developers.cloudflare.com/agents/">Cloudflare Agents SDK</a> now provides a <code>web_search</code> tool that searches the public web through the <a href="https://developers.cloudflare.com/web-search/">Cloudflare Web Search API</a>, powered by <a href="https://developers.cloudflare.com/web-search/providers/">ceramic.ai, Exa, and Linkup</a>. When you give the <code>web_search</code> tool to your agent, the model provides a query and max results, and receives back a short numbered list of titles, URLs, and trimmed descriptions. When you also provide the <a href="https://developers.cloudflare.com/agents/tools/web-fetch/"><code>web_fetch</code></a> tool to your agent, the model is told to use it to read the pages that the <code>web_search</code> tool returns. To use the <code>web_search</code> tool, make sure you have <a href="https://github.com/cloudflare/agents/releases/tag/agents%400.27.0" target="_blank" rel="noopener">Agents SDK v0.27.0 ↗︎</a> or greater installed, and add it to a <a href="https://developers.cloudflare.com/agents/harnesses/pi/">Pi Durable</a> <a href="https://developers.cloudflare.com/agents/harnesses/pi/extensions/">extension registry</a> before opening the harness: <div><div data-nb-tabs data-nb-sync-key="workersExamples" class><div class="relative flex border-b border-border" role="tablist" data-nb-tabs-list></div><div class="mt-3"><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="JavaScript" class><figure class="nb-code-figure" data-nb-lang="js"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="js" data-nb-lang="js"><code>import { webSearchTool } from "agents/websearch/pi"; export class MyAgent extends DurableObject { // ... harness = new PiHarness({ harness: async ({ storage, context }) => { this.registry.install({ name: "web-tools", tools: [webSearchTool({ binding: this.env.AI, provider: "exa" })], }); // ... return Harness.open( storage, { models, registry: this.registry }, context, ); }, }); }</code></pre></figure></div><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="TypeScript" class><figure class="nb-code-figure" data-nb-lang="ts"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="ts" data-nb-lang="ts"><code>import { webSearchTool } from "agents/websearch/pi"; export class MyAgent extends DurableObject<Env> { // ... readonly harness = new PiHarness({ harness: async ({ storage, context }) => { this.registry.install({ name: "web-tools", tools: [webSearchTool({ binding: this.env.AI, provider: "exa" })], }); // ... return Harness.open( storage, { models, registry: this.registry }, context, ); }, }); }</code></pre></figure></div></div></div><script type="module" src="https://developers.cloudflare.com/home/runner/work/cloudflare-docs/cloudflare-docs/src/components/ui/tabs/Tabs.astro?astro&type=script&index=0&lang.ts"></script></div> The SDK also includes AI SDK and TanStack AI adapters. To search without a model, such as from a scheduled job, use <code>createAIWebSearch()</code> or <code>createHTTPWebSearch()</code> from <code>agents/websearch</code>. For setup, options, and error handling, refer to <a href="https://developers.cloudflare.com/agents/tools/web-search/">Web search</a>.

The text above is the source's. reef added the severity, the dates it could read from the text, and the endpoints and scopes named in code.