Michael JohnsonCloudflare stellte am 2. Oktober 2026 die Web Search API vor – eine Websuchschnittstelle für KI-Agenten und Anwendungen, die über AI Gateway bereitgestellt wird. Zum Start band das Unternehmen Ceramic.ai, Exa und Linkup ein. Die am 8. Oktober geprüfte und am 2. Oktober aktualisierte offizielle Übersichtsdokumentation kennzeichnet das Produkt als offene Beta.
Für Entwickler besteht die wichtigste Neuerung darin, dass sich die Suche in einen bestehenden Arbeitsablauf mit Modellen integrieren lässt. Laut der Beschreibung der AI-Gateway-Integration werden Suchanfragen zusammen mit Modellanfragen protokolliert und analysiert; außerdem gelten dafür dieselben Abrechnungs- und Zugriffskontrollfunktionen. So lässt sich die Suche als eigener, beobachtbarer Schritt bei der Ausführung einer Agentenaufgabe behandeln.
Warum ein Agent eine Suchanfrage braucht
In der Ankündigung von Cloudflare wird ein praktisches Problem genannt: Ein Agent kann die Adresse der gesuchten Seite erraten und dann mit einer Anfrage an eine falsche URL einen 404-Fehler erhalten. Ein Suchwerkzeug bietet einen anderen Weg: eine Anfrage formulieren, Adressen relevanter Inhalte abrufen und die gefundenen Informationen für die Antwort verwenden.
Ein zweites Einsatzszenario ist der Umgang mit Änderungen, die nach dem Training eines Modells eingetreten sind. Cloudflare nennt ausdrücklich aktuelle Ereignisse, sich ändernde APIs und neue Tool-Versionen. Für einen Agenten, der beim Programmieren hilft, könnte es beispielsweise sinnvoll sein, nach der Dokumentation einer bestimmten Bibliotheksversion oder eines neu eingeführten Parameters zu suchen. Dabei liefert die Suche Material für den Kontext; die Anwendung entscheidet, welche Ergebnisse sie dem Modell übergibt.
Eine praktische Empfehlung für Teams: Speichern Sie die URL und den Wortlaut der Suchanfrage zusammen mit dem gefundenen Auszug. So lässt sich bei der Überprüfung einer Antwort nachvollziehen, auf welches Material sich der Agent gestützt hat. Bei Aufgaben mit Versionsbezug empfiehlt es sich außerdem, den Produktnamen und die gewünschte Version ausdrücklich in die Suchanfrage aufzunehmen.
So wird die neue API eingebunden
Die Dokumentation beschreibt zwei Aufrufmöglichkeiten: eine REST API für externe Backends und ein AI Binding innerhalb von Cloudflare Workers. Der Anbieter wird über den Parameter provider ausgewählt. Alle drei Dienste liefern Ergebnisse in einem einheitlichen Format mit Titeln, URLs und Beschreibungen. Dadurch lässt sich der Anbieter wechseln, ohne die Verarbeitung der Antwort durch die Anwendung grundlegend zu ändern.
Das einheitliche Format eignet sich für einen eigenen Adapter für das Suchwerkzeug. Dieser nimmt die Anfrage des Agenten entgegen, ruft den ausgewählten Anbieter auf und übergibt dem Modell die ausgewählten Ergebnisse. Auf Anwendungsebene sollte gesondert festgelegt werden, wann eine Beschreibung aus der Trefferliste genügt und wann die gefundene Seite aufgerufen werden muss, um eine konkrete Aussage zu überprüfen.
In der Veröffentlichung zum Start werden integrierte Server-Tools für AI Gateway als künftige Funktion angekündigt. Cloudflare teilt mit, dass die Websuche eines der ersten dieser Tools sein wird. Das zum Start gezeigte Szenario setzt eine eigene Orchestrierung voraus: Der Tool-Aufruf wird verarbeitet und die Suchantwort in die nächste Anfrage an das Modell eingespeist.
Welche Bedingungen bestätigt sind
Laut den Abrechnungsbedingungen in der Dokumentation können Anfragen mit AI-Gateway-Guthaben zum öffentlichen API-Preis des jeweiligen Anbieters bezahlt werden, ohne zusätzlichen Aufschlag von Cloudflare. Auch Bring Your Own Key wird unterstützt: Dabei wird ein eigener API-Schlüssel des Suchanbieters verwendet. Bei dieser Variante sollte das Team vorab festlegen, wo es den Verbrauch überwacht und die abgerechneten Beträge abgleicht.
In der geprüften Ankündigung und der Übersichtsseite sind weder konkrete Geldbeträge noch numerische Anfragekontingente angegeben. Daher sollte das Integrationsbudget erst nach Prüfung der Preise des ausgewählten Anbieters kalkuliert werden. Abnahmetests sollten sich an den eigenen Aufgaben orientieren und beispielsweise den Anteil geeigneter Quellen, die Antwortzeit, die Zahl der Suchanfragen pro erledigtem Auftrag und den Umgang mit Fehlern erfassen.
Ein weiterer Punkt ist die Datenspeicherung. In der Beschreibung der Zero Data Retention verspricht Cloudflare, Partner mit ZDR-Unterstützung zu kennzeichnen. Für die konkrete Suchroute sollten die Speicherbedingungen des Anbieters und die Einstellungen der AI-Gateway-Protokolle gesondert geprüft werden: Zugleich bestätigt die Ankündigung, dass Suchanfragen im Observability-System erfasst werden.
Die Anbieter verpflichten sich außerdem, die Cloudflare-Anforderungen für Verified Bots einzuhalten: Sie müssen ihren Bot identifizieren, robots.txt und Crawling-Anweisungen berücksichtigen, eine angemessene Anfragerate einhalten und die Präferenzen der Website-Betreiber respektieren. Die Übersicht zur Web Search API bestätigt, dass jedem Ergebnis ein Quellenlink beigefügt werden muss.
Für Entwickler bietet der Start einen klaren Integrationspunkt für die Websuche in Agenten und eine gemeinsame Umgebung zur Erfassung ihrer Nutzung. Die Bewertung sollte mit einer kleinen Auswahl realer Aufgaben beginnen, bei denen der Anbieter ausdrücklich festgelegt und Links in den Antworten gespeichert werden. Diese Entscheidungen bestimmen, wie gut die gefundenen Inhalte der Anwendung bei konkreten Aufgaben helfen.