Michael JohnsonCloudflare 2. října 2026 představila Web Search API prostřednictvím AI Gateway — rozhraní pro webové vyhledávání určené AI agentům a aplikacím. Při spuštění společnost připojila Ceramic.ai, Exa a Linkup. Oficiální přehledová dokumentace, ověřená 8. října a aktualizovaná 2. října, označuje produkt jako otevřenou betu.
Pro vývojáře je hlavní změnou možnost přidat vyhledávání do stávajícího pracovního postupu s modely. Podle popisu integrace s AI Gateway se na vyhledávací požadavky vztahují stejné protokoly, analytika, fakturace a nástroje řízení přístupu jako na požadavky k modelům. Vyhledávání tak lze považovat za samostatnou, sledovatelnou fázi plnění úkolu agenta.
Proč agent potřebuje vyhledávací dotaz
Cloudflare v oznámení uvádí praktický problém: agent může hádat adresu požadované stránky, ale požadavek na chybnou URL pak vrátí chybu 404. Vyhledávací nástroj nabízí jiný postup: sestavit dotaz, získat adresy relevantních materiálů a využít nalezené informace při přípravě odpovědi.
Druhým případem použití je práce se změnami, ke kterým došlo po trénování modelu. Cloudflare zvlášť zmiňuje aktuální události, měnící se API a nová vydání nástrojů. Pro agenta, který pomáhá psát kód, může být užitečné hledat dokumentaci ke konkrétní verzi knihovny nebo k nově přidanému parametru. Při tomto postupu vyhledávání dodává podklady pro kontext a aplikace určuje, které výsledky předá modelu.
Praktické doporučení pro tým: ukládejte společně s nalezeným úryvkem také jeho URL a znění dotazu. Při ověřování odpovědi pak lze zjistit, o jaký materiál se agent opíral. U úloh spojených s verzemi je také vhodné do vyhledávacího dotazu výslovně zahrnout název produktu a požadovanou verzi.
Jak se nové API připojuje
Dokumentace popisuje dva způsoby volání: REST API z externího backendu a AI binding uvnitř Cloudflare Workers. Poskytovatel se vybírá parametrem provider. Všechny tři služby vracejí výsledky ve společném formátu: nadpisy, URL a popisy. Aplikace tak může při zpracování odpovědi snadněji přejít k jinému poskytovateli.
Jednotný formát se hodí pro vlastní adaptér vyhledávacího nástroje. Jeho úkolem je přijmout dotaz agenta, zavolat vybraného poskytovatele a předat modelu vybrané výsledky. Na úrovni aplikace je třeba samostatně rozhodnout, kdy stačí popis ve výsledcích vyhledávání a kdy je nutné otevřít nalezenou stránku a ověřit konkrétní tvrzení.
Vestavěné nástroje na straně serveru v AI Gateway jsou v článku o spuštění označeny jako budoucí možnost. Cloudflare uvádí, že webové vyhledávání bude jedním z prvních takových nástrojů. Scénář představený při spuštění počítá s vlastní orchestrací: zpracováním volání nástroje a předáním výsledku vyhledávání v následujícím požadavku modelu.
Jaké podmínky jsou potvrzené
Podle podmínek plateb v dokumentaci lze požadavky platit kredity AI Gateway podle veřejné ceny API příslušného poskytovatele, bez dodatečné přirážky Cloudflare. Podporována je také možnost Bring Your Own Key, tedy použití vlastního API klíče poskytovatele vyhledávání. Při volbě této varianty by si tým měl předem určit, kde bude sledovat spotřebu a kontrolovat účtované částky.
V ověřeném oznámení a na přehledové stránce nejsou uvedeny konkrétní ceny ani číselné kvóty požadavků. Rozpočet integrace je proto třeba sestavit až po ověření tarifu vybraného poskytovatele. Akceptační testy je vhodné založit na vlastních úlohách: podílu vhodných zdrojů, době odezvy, počtu vyhledávacích požadavků na dokončený úkol a zpracování chyb.
Samostatným bodem je uchovávání dat. Cloudflare v popisu Zero Data Retention slibuje označovat partnery, kteří podporují ZDR. U konkrétní trasy vyhledávání je třeba zvlášť ověřit podmínky uchovávání dat u poskytovatele a nastavení protokolů AI Gateway: oznámení zároveň potvrzuje, že vyhledávací požadavky se zaznamenávají v systému pro sledování provozu.
Poskytovatelé se také zavazují dodržovat požadavky Cloudflare na Verified bots: identifikovat svého bota, respektovat robots.txt a pokyny pro procházení webu, udržovat rozumnou četnost požadavků a respektovat preference vlastníků webů. Přehled Web Search API potvrzuje, že každý výsledek musí obsahovat odkaz na zdroj.
Pro vývojáře představuje spuštění přehledný způsob, jak připojit webové vyhledávání k agentovi a evidovat ho ve společném systému. Hodnocení je vhodné začít malou sadou skutečných úkolů, výslovným výběrem poskytovatele a ukládáním odkazů do odpovědí. Právě tato rozhodnutí určí, nakolik nalezené materiály aplikaci pomohou při plnění konkrétní práce.