Web-Suchwerkzeug
Das Web-Suchwerkzeug gibt Claude direkten Zugriff auf Echtzeit-Webinhalte und ermöglicht es ihm, Fragen mit aktuellen Informationen über seinen Wissensstichtag hinaus zu beantworten. Claude zitiert automatisch Quellen aus Suchergebnissen als Teil seiner Antwort.
Bitte teilen Sie uns Ihre Erfahrungen mit dem Web-Suchwerkzeug über unser Feedback-Formular mit.
Unterstützte Modelle
Die Web-Suche ist verfügbar für:
- Claude Opus 4 (
claude-opus-4-20250514
) - Claude Sonnet 4 (
claude-sonnet-4-20250514
) - Claude Sonnet 3.7 (
claude-3-7-sonnet-20250219
) - Claude Sonnet 3.5 (neu) (
claude-3-5-sonnet-latest
) - Claude Haiku 3.5 (
claude-3-5-haiku-latest
)
Wie die Web-Suche funktioniert
Wenn Sie das Web-Suchwerkzeug zu Ihrer API-Anfrage hinzufügen:
- Claude entscheidet basierend auf der Eingabeaufforderung, wann gesucht werden soll.
- Die API führt die Suchen durch und stellt Claude die Ergebnisse zur Verfügung. Dieser Prozess kann sich mehrmals innerhalb einer einzigen Anfrage wiederholen.
- Am Ende seines Zuges liefert Claude eine endgültige Antwort mit zitierten Quellen.
Wie man die Web-Suche verwendet
Der Administrator Ihrer Organisation muss die Web-Suche in der Console aktivieren.
Stellen Sie das Web-Suchwerkzeug in Ihrer API-Anfrage bereit:
Tool-Definition
Das Web-Suchwerkzeug unterstützt die folgenden Parameter:
Maximale Verwendungen
Der Parameter max_uses
begrenzt die Anzahl der durchgeführten Suchen. Wenn Claude mehr Suchen als erlaubt versucht, wird das web_search_tool_result
ein Fehler mit dem Fehlercode max_uses_exceeded
sein.
Domain-Filterung
Bei der Verwendung von Domain-Filtern:
- Domains sollten nicht das HTTP/HTTPS-Schema enthalten (verwenden Sie
example.com
anstelle vonhttps://example.com
) - Subdomains werden automatisch einbezogen (
example.com
decktdocs.example.com
ab) - Unterpfade werden unterstützt (
example.com/blog
) - Sie können entweder
allowed_domains
oderblocked_domains
verwenden, aber nicht beide in derselben Anfrage.
Lokalisierung
Der Parameter user_location
ermöglicht es Ihnen, Suchergebnisse basierend auf dem Standort eines Benutzers zu lokalisieren.
type
: Der Typ des Standorts (mussapproximate
sein)city
: Der Stadtnameregion
: Die Region oder der Bundesstaatcountry
: Das Landtimezone
: Die IANA-Zeitzonen-ID.
Antwort
Hier ist ein Beispiel für eine Antwortstruktur:
Suchergebnisse
Suchergebnisse beinhalten:
url
: Die URL der Quellseitetitle
: Der Titel der Quellseitepage_age
: Wann die Seite zuletzt aktualisiert wurdeencrypted_content
: Verschlüsselter Inhalt, der für Zitate in Gesprächen mit mehreren Runden zurückgegeben werden muss
Zitate
Zitate sind für die Web-Suche immer aktiviert, und jedes web_search_result_location
enthält:
url
: Die URL der zitierten Quelletitle
: Der Titel der zitierten Quelleencrypted_index
: Eine Referenz, die für Gespräche mit mehreren Runden zurückgegeben werden muss.cited_text
: Bis zu 150 Zeichen des zitierten Inhalts
Die Web-Suchzitationsfelder cited_text
, title
und url
werden nicht auf die Nutzung von Eingabe- oder Ausgabe-Token angerechnet.
Bei der Anzeige von Webergebnissen oder Informationen aus Webergebnissen für Endbenutzer müssen Inline-Zitate in Ihrer Benutzeroberfläche deutlich sichtbar und anklickbar sein.
Fehler
Wenn während der Web-Suche ein Fehler auftritt, erhalten Sie eine Antwort in folgender Form:
Dies sind die möglichen Fehlercodes:
too_many_requests
: Ratengrenze überschritteninvalid_input
: Ungültiger Suchanfrageparametermax_uses_exceeded
: Maximale Verwendung des Web-Suchwerkzeugs überschrittenquery_too_long
: Anfrage überschreitet maximale Längeunavailable
: Ein interner Fehler ist aufgetreten
pause_turn
Stoppgrund
Die Antwort kann einen pause_turn
Stoppgrund enthalten, der anzeigt, dass die API einen lang laufenden Zug pausiert hat. Sie können die Antwort unverändert in einer nachfolgenden Anfrage zurückgeben, um Claude seinen Zug fortsetzen zu lassen, oder den Inhalt modifizieren, wenn Sie das Gespräch unterbrechen möchten.
Prompt-Caching
Die Web-Suche funktioniert mit Prompt-Caching. Um Prompt-Caching zu aktivieren, fügen Sie mindestens einen cache_control
-Haltepunkt in Ihrer Anfrage hinzu. Das System wird automatisch bis zum letzten web_search_tool_result
-Block beim Ausführen des Tools zwischenspeichern.
Für Gespräche mit mehreren Runden setzen Sie einen cache_control
-Haltepunkt auf oder nach dem letzten web_search_tool_result
-Block, um zwischengespeicherte Inhalte wiederzuverwenden.
Hier ist ein Beispiel für die Verwendung von Prompt-Caching mit Web-Suche für ein Gespräch mit mehreren Runden:
Streaming
Bei aktiviertem Streaming erhalten Sie Suchereignisse als Teil des Streams. Es gibt eine Pause, während die Suche ausgeführt wird:
Batch-Anfragen
Sie können das Web-Suchwerkzeug in die Messages Batches API einbeziehen. Web-Suchwerkzeugaufrufe über die Messages Batches API werden genauso berechnet wie in regulären Messages API-Anfragen.
Nutzung und Preisgestaltung
Die Nutzung der Web-Suche wird zusätzlich zur Token-Nutzung berechnet:
Die Web-Suche ist in der Anthropic API für 10 $ pro 1.000 Suchen verfügbar, zuzüglich der Standardkosten für Token für suchgenerierte Inhalte. Web-Suchergebnisse, die während eines Gesprächs abgerufen werden, werden als Eingabe-Token gezählt, sowohl in Suchiterationen, die während eines einzelnen Zuges ausgeführt werden, als auch in nachfolgenden Gesprächsrunden.
Jede Web-Suche zählt als eine Verwendung, unabhängig von der Anzahl der zurückgegebenen Ergebnisse. Wenn während der Web-Suche ein Fehler auftritt, wird die Web-Suche nicht in Rechnung gestellt.