phaseo:web_search hinzu, damit das Modell im Web suchen kann, wenn es aktuelle oder durch Quellen belegte Informationen braucht. Das Modell formuliert die Suchanfrage und kann innerhalb einer Anfrage mehrmals suchen; Phaseo gibt URLs, Titel, Snippets, Hervorhebungen und optional Seitentext zurück, und das Modell schreibt eine fundierte Antwort.
tools unter /v1/responses und /v1/messages.
Parameter
Was das Modell sendet
Jeder Aufruf enthält einequery. Das Modell kann außerdem max_results, engine, search_context_size, die Domainlisten, include_text, include_highlights, max_characters und diese Lokalisierungshinweise senden:
Werte, die das Modell sendet, ersetzen für diesen Aufruf die Standardwerte des Tools.
max_results bleibt durch den Rest von max_total_results begrenzt; ist dieser aufgebraucht, geben weitere Aufrufe max_total_results_reached zurück.
Engine auswählen
Ist eine verwaltete Engine nicht aktiviert, gibt der Aufruf
search_not_configured an das Modell zurück.
Mit engine: "native" unter /v1/chat/completions oder /v1/responses geht die Anfrage nur an Anbieter, die die Websuche selbst ausführen. Bedient keiner von ihnen das Modell, führt Phaseo stattdessen seine Standard-Engine aus und rechnet sie als verwaltete Suche ab.
Die Anbieter, die die Websuche an diesen Endpunkten selbst ausführen, sind OpenAI, Azure OpenAI-Deployments unter /v1/responses, xAI und DeepSeek bei deepseek/deepseek-v4.1-flash-1017. DeepSeek sucht nur dann selbst, wenn die Websuche das einzige Tool der Anfrage ist, ohne Domain-Listen oder Nutzerstandort, ohne JSON-Ausgabe und ohne erzwungenes tool_choice. Seine API lehnt Domain-Listen, einen Standort und JSON-Ausgabe ab, schaltet die Websuche ab, wenn die Anfrage weitere Tools enthält, und kann keine Suche erzwingen. Andere Anfragen an dieses Modell nutzen stattdessen die Suche von Phaseo, die neben deinen eigenen Tools funktioniert. Bei aktiviertem Reasoning führt DeepSeek eine tiefere Suche aus, die Seiten über mehrere Schritte öffnet und liest.
Das Senden von OpenAIs eigenem Tool { "type": "web_search" } funktioniert genauso wie engine: "native". Setze native nur in der Tool-Definition: Fordert das Modell native in einem Aufruf an, gibt der Aufruf unsupported_search_engine zurück, weil das Tool des Anbieters vor dem Senden der Anfrage gewählt werden muss.
Nach Domain filtern
Verwendeallowed_domains, wenn die Antwort aus einer festen Quellenauswahl stammen muss, und excluded_domains, um bestimmte Websites aus einer sonst offenen Suche auszuschließen.
- Perplexity nimmt eine der beiden Listen, nicht beide, und bis zu 20 Domains. Ausgeschlossene Domains werden in seinem Sperrlistenformat gesendet.
- Firecrawl nimmt eine der beiden Listen, nicht beide.
- TinyFish nimmt beide und wandelt sie in der Suchanfrage in die Operatoren
site:und-site:um. - DeepSeek nimmt beide und wandelt sie in
site:- und-site:-Operatoren um. Seine Anfragen sind auf 128 Zeichen begrenzt, daher wird die Suchanfrage gekürzt, um Platz für die Operatoren zu schaffen. Überschreiten allein die Domain-Listen das Limit, gibt der Aufrufsearch_query_too_longzurück.
Was das Tool zurückgibt
Ein JSON-Ergebnis mit der Engine, der Suchanfrage und einemresults-Array. Jedes Ergebnis hat title, url, snippet oder highlights sowie text, wenn Seitentext angefordert wurde und die Engine ihn liefert.
Nutzung und Preise
Jede Suche erhöht die Werte inusage.server_tool_use:
server_tool_web_search_requests und server_tool_web_search_extra_results festlegt. Fehlgeschlagene Suchen werden nicht berechnet, und TinyFish Search ist in seinen veröffentlichten Tarifen kostenlos, daher fügt engine: "tinyfish" keine Suchkosten hinzu. Suchen mit kostenpflichtigen Engines erfordern Guthaben, auch wenn das Modell kostenlos ist. Native Suche wird über native_web_search_requests zum veröffentlichten Preis des Anbieters abgerechnet: zum Beispiel $10 pro 1,000 Suchen bei OpenAI und Anthropic und $0.75 pro 1,000 bei DeepSeek, wo nur Suchen mit Ergebnissen zählen. DeepSeek berechnet außerdem jeden Seitenabruf, bei dem es eine URL mit seinem Link-Lese-Tool liest, mit $0.75 pro 1,000, als native_web_fetch_requests. Bei aktiviertem Reasoning kann eine einzige DeepSeek-Antwort ein Dutzend oder mehr Suchen ausführen, und die gelesenen Ergebnisse erhöhen die Eingabe-Tokens.