Michael Johnson2 października 2026 roku Cloudflare zaprezentowała Web Search API przez AI Gateway — interfejs wyszukiwania w sieci dla agentów i aplikacji AI. Na początku firma podłączyła Ceramic.ai, Exa i Linkup. Oficjalna dokumentacja przeglądowa, sprawdzona 8 października i zaktualizowana 2 października, określa produkt jako otwartą betę.
Dla programisty najważniejszą zmianą jest możliwość dodania wyszukiwania do istniejącego środowiska pracy z modelami. Zgodnie z opisem integracji z AI Gateway, zapytania wyszukiwawcze korzystają ze wspólnych z zapytaniami do modeli dzienników, analityki, rozliczeń i mechanizmów kontroli dostępu. Dzięki temu wyszukiwanie można traktować jako osobny, monitorowany etap realizacji zadania przez agenta.
Po co agentowi zapytanie wyszukiwawcze
W ogłoszeniu Cloudflare opisuje praktyczny problem: agent może zgadywać adres potrzebnej strony, a zapytanie pod błędny URL kończy się błędem 404. Narzędzie wyszukiwania oferuje inną ścieżkę: sformułowanie zapytania, uzyskanie adresów odpowiednich materiałów i wykorzystanie znalezionych informacji przy przygotowywaniu odpowiedzi.
Drugi scenariusz dotyczy zmian, które zaszły po wytrenowaniu modelu. Cloudflare wymienia osobno najnowsze wydarzenia, zmieniające się API i nowe wersje narzędzi. W przypadku agenta pomagającego w pisaniu kodu przydatne może być wyszukanie dokumentacji konkretnej wersji biblioteki lub niedawno dodanego parametru. W takim procesie wyszukiwanie dostarcza materiałów do kontekstu, a aplikacja decyduje, które wyniki przekazać modelowi.
Praktyczny wniosek dla zespołu: zapisujcie adres URL i treść zapytania razem ze znalezionym fragmentem. Dzięki temu podczas weryfikacji odpowiedzi można odtworzyć, na jakim materiale opierał się agent. W zadaniach dotyczących wersji warto też wyraźnie uwzględnić w zapytaniu nazwę produktu i wymaganą wersję.
Jak podłączyć nowe API
Dokumentacja opisuje dwa sposoby wywołania: REST API z zewnętrznego backendu oraz powiązanie AI binding wewnątrz Cloudflare Workers. Dostawcę wybiera się za pomocą parametru provider. Wszystkie trzy usługi zwracają wyniki we wspólnym formacie: tytuły, adresy URL i opisy. Ułatwia to zmianę dostawcy po stronie przetwarzania odpowiedzi przez aplikację.
Wspólny format sprawdza się w przypadku własnego adaptera narzędzia wyszukiwania. Jego zadaniem jest przyjęcie zapytania agenta, wywołanie wybranego dostawcy i przekazanie modelowi wybranych wyników. Na poziomie aplikacji warto osobno ustalić, kiedy wystarczy opis z listy wyników, a kiedy trzeba otworzyć znalezioną stronę i zweryfikować konkretne twierdzenie.
Wbudowane narzędzia serwerowe AI Gateway zostały w publikacji o uruchomieniu przedstawione jako przyszła możliwość. Cloudflare informuje, że wyszukiwanie w sieci będzie jednym z pierwszych takich narzędzi. Scenariusz pokazany przy uruchomieniu zakłada własną orkiestrację: obsługę wywołania narzędzia i przekazanie odpowiedzi z wyszukiwania do kolejnego zapytania do modelu.
Jakie warunki zostały potwierdzone
Zgodnie z warunkami rozliczeń w dokumentacji, zapytania można opłacać kredytami AI Gateway według publicznej ceny API danego dostawcy, bez dodatkowej marży Cloudflare. Obsługiwane jest również Bring Your Own Key, czyli użycie własnego klucza API dostawcy wyszukiwania. Przy wyborze tego rozwiązania zespół powinien z góry ustalić, gdzie będzie monitorować zużycie i weryfikować naliczone opłaty.
W sprawdzonym ogłoszeniu i na stronie przeglądowej nie podano konkretnych stawek ani liczbowych limitów zapytań. Dlatego budżet integracji należy oszacować po sprawdzeniu cennika wybranego dostawcy. Testy odbiorcze warto oprzeć na własnych zadaniach: odsetku trafnych źródeł, czasie odpowiedzi, liczbie zapytań wyszukiwawczych na ukończone zadanie oraz obsłudze błędów.
Osobną kwestią jest przechowywanie danych. W opisie Zero Data Retention Cloudflare obiecuje oznaczać partnerów obsługujących ZDR. Warunki przechowywania danych u dostawcy dla konkretnej ścieżki wyszukiwania oraz ustawienia dzienników AI Gateway należy sprawdzić osobno: ogłoszenie potwierdza jednocześnie rejestrowanie zapytań wyszukiwawczych w systemie monitorowania.
Dostawcy zobowiązują się również przestrzegać wymagań Cloudflare dotyczących Verified bots: identyfikować swoje boty, uwzględniać robots.txt i dyrektywy indeksowania, utrzymywać rozsądną częstotliwość żądań oraz respektować preferencje właścicieli witryn. Przegląd Web Search API potwierdza obowiązek dołączenia źródła do każdego wyniku.
Dla programistów uruchomienie usługi zapewnia czytelny sposób podłączenia wyszukiwania w sieci do agenta oraz wspólny mechanizm jego ewidencji. Ocenę warto zacząć od niewielkiego zestawu rzeczywistych zadań, jawnego wyboru dostawcy i zachowywania linków w odpowiedziach. To właśnie te decyzje przesądzą o tym, jak dobrze znalezione materiały pomogą aplikacji wykonać konkretne zadanie.