Websuche mit Anthropic Claude-Modellen

Die Websuche ist eine Funktion, mit der ein Claude-Modell sein Wissen mit Echtzeitdaten aus dem Web erweitern kann. Die Claude-Modelle verwenden einen Drittanbieter für die Websuche. Die Websuchfunktion ist besonders leistungsstark für RAG-Anwendungen (Retrieval-Augmented Generation), bei denen Sie Quellen genau angeben müssen.

Die Websuche eignet sich gut für die folgenden Anwendungsfälle:

  • Aktuelle technische Dokumentation abrufen: Softwareentwickler können Claude nach der neuesten API-Dokumentation oder technischen Spezifikationen fragen. Claude kann Informationen direkt aus der Quelldokumentation abrufen und zusammenfassen.
  • Geschäfts- und Marktdaten erheben: Business Analysts können aktuelle Marktdaten, Unternehmensinformationen oder Branchennachrichten erheben, um ihre Entscheidungsprozesse zu unterstützen.
  • Bei der Recherche helfen: Wissensarbeiter können Claude als Recherche-Assistenten verwenden, der Informationen aus mehreren Webquellen finden, zusammenfassen und erklären kann, wobei genaue Quellenangaben beibehalten werden.
  • Kunden unterstützen: Kundenserviceanwendungen können auf aktuelle Produktinformationen, Preise oder Supportdokumentation von Unternehmenswebsites zugreifen.

Unterstützte Modelle

Die Gemini Enterprise Agent Platform unterstützt die Websuche für die folgenden Anthropic Claude-Modelle:

Zugriff auf die Websuche steuern

Für die Websuche ist ein öffentlicher Internetzugang erforderlich. Standardmäßig ist die Websuche durch die Einschränkung constraints/vertexai.allowedPartnerModelFeatures der Organisationsrichtlinie deaktiviert. Damit die Websuche aktiviert werden kann, müssen Sie diese Einschränkung so konfigurieren, dass sie explizit zugelassen wird.

Außerdem können Sie die Einschränkung für die Organisationsrichtlinie constraints/vertexai.allowedModels konfigurieren, um den Zugriff auf Claude-Modelle einzuschränken.

Damit Sie nach Juni 2026 weiterhin Zugriff auf die Websuche für diese spezifischen Modellversionen haben, müssen Sie die Organisationsrichtlinie constraints/vertexai.allowedPartnerModelFeatures bis Ende Juni 2026 so konfigurieren, dass die Websuche zulässig ist.

Eine detaillierte Anleitung zum Konfigurieren von Einschränkungen für Organisationsrichtlinien finden Sie unter Zugriff auf Model Garden-Modelle steuern.

Aktivieren Sie die Websuche, indem Sie in der API-Anfrage eine neue Anthropic-Tool-Definition (web_search) angeben.

Im folgenden Code-Snippet wird beispielsweise die Websuche verwendet, um Wetterinformationen in Echtzeit abzurufen:

response = await client.messages.create(
    model="claude-4-sonnet-latest",
    max_tokens=1024,
    messages=[{
        "role": "user",
        "content": "What is the weather in San Francisco?"
    }],
    tools=[{
        "type": "web_search",
        "name": "web_search",
        "max_uses": 5
    }]
)

Sie können auch optionale Felder verwenden, um zulässige und blockierte Domains anzugeben. Beispiel:

tools=[{
  ...
  # Only one of allowed_domains and blocked_domains can be provided.
  # allowed_domains excludes everything except the specified domains
    "allowed_domains": ["example.com", "example.org"],

  # blocked_domains includes everything except the specified domains
  # Use the `NOT site:` search operator
    "blocked_domains": ["example.net"],
}]

Weitere Informationen zu optionalen Feldern finden Sie in der Dokumentation zum Claude-Websuchtool.

Wenn das Modell feststellt, dass eine Websuche erforderlich ist, ruft die API das Websuchtool auf, bis keine weiteren Tool-Aufrufe mehr erforderlich sind. Die Antwort enthält Details zu den Zwischensuchen, wobei die Ergebnisse verschlüsselt sind.

Das folgende Code-Snippet zeigt ein Beispiel für eine Antwort mit Websuche:

{
  ...
  "role": "assistant",
  "content": [
    // Initial output from the model
    {
      "type": "text",
      "text": "I need to search the web to answer this question about the weather in San Francisco."
    },
    {
      "type": "server_tool_use",
      "id": "srvtoolu_9a90a390a",
      "name": "web_search",
      "input": {
        "query": "What is the weather in San Francisco?",
      }
    },
    // API sees an `</antml:function_calls>` stop sequence here, sees that
    // the tool use is for a server-side tool, and then runs that
    // tool. If there is a mix of client and server-side, the API would
    // need to return to the client and let it pass back client tool results
    // before continuing with server tools.
    {
      "type": "web_search_tool_result",
      // "name": "web_search", use this to determine what types of blocks are inside `content`
      "tool_use_id": "srvtoolu_9a90a390a",
      "content": [
        {
          "type": "web_search_result",
          "uri": "https://weather.com",
          "title": "National and Local Weather",
          "encrypted_content": "eyJlbmNyeXB0ZWRfa2V5Ijoic2VjcmV0LW...", // encrypted list of snippets from the web search provider
        },
        {
          "type": "web_search_result",
          "uri": "https://accuweather.com",
          "title": "San Francisco, CA Hourly Weather",
          "encrypted_content": "yaJlbmNyeXB0ZWRfa2V5Ijoic2VjcmV0LW...", // encrypted list of snippets from the web search provider
        },
      ],
    },
    // Server starts a new sampling run with the above content appended (unencrypted)
    // to the original request. Everything below is completion content from the
    // second sampling run.
    {
      "type": "text",
      "text": "The current weather in San Francisco, CA is 65 degrees Fahrenheit and partly cloudy."
    }
  ],
  // Server output is no longer 1-to-1 with a single sampling run. From the
  // user's perspective, there is just one "Message" with a single id
  "id": "msg_a930390d3",
  "usage": {
    "input_tokens": 3029,
    "output_tokens": 6039,
    "server_tool_use": {
      "web_search_requests": 2
    }
  },
  "stop_reason": "end_turn"
}

Streaming mit Websuche

Wenn das Streaming aktiviert ist, gibt das Modell Suchereignisse als Teil des Streams zurück. Beispiel:

// Claude's decision to search

event: content_block_start
data: {"type": "content_block_start", "index": 1, "content_block": {"type": "server_tool_use", "id": "srvtoolu_xyz789", "name": "web_search"}}

// Search query streamed
event: content_block_delta
data: {"type": "content_block_delta", "index": 1, "delta": {"type": "input_json_delta", "partial_json": "{\"query\":\"latest quantum computing breakthroughs 2025\"}"}}

// Pause while search executes

// Search results streamed
event: content_block_start
data: {"type": "content_block_start", "index": 2, "content_block": {"type": "web_search_tool_result", "tool_use_id": "srvtoolu_xyz789", "content": [{"type": "web_search_result", "title": "Quantum Computing Breakthroughs in 2025", "url": "https://example.com"}]}}

Die Nutzung wird gemessen und in message_delta-Nachrichten angegeben, die eine kumulative Anzahl von web_search-Elementen enthalten. Beispiel:

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"input_tokens":10682,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":510,"server_tool_use":{"web_search_requests":1}}}

Die Websuchfunktion für Claude 4.0 und neuere Modelle ist eine optionale Funktion der Claude-Modelle von Anthropic. Sie können die Funktion aktivieren, indem Sie das Websuche-Tool in den Anfragen angeben. Wenn Sie diese Funktion aktivieren, weisen Sie die Gemini Enterprise Agent Platform an, die Claude-Modelle so zu konfigurieren, dass Suchanfragen, die aus Ihrer Anfrage abgeleitet werden, an einen von Anthropic ausgewählten Drittanbieter für Suchdienste gesendet werden. Google ist nicht für die Datenverarbeitungspraktiken dieses Drittanbieters verantwortlich. Sobald die Suchanfragen übertragen wurden, unterliegt die Verarbeitung dieser Daten den Nutzungsbedingungen und der Datenschutzerklärung des Drittanbieters und nicht denen von Google.

Die Aktivierung der Websuchfunktion hat direkte Auswirkungen auf Ihre Data Governance und Ihren Sicherheitsstatus. Zusätzliche Verpflichtungen der Gemini Enterprise Agent Platform, z. B. kundenverwaltete Verschlüsselungsschlüssel (Customer-Managed Encryption Keys, CMEK) und Data Residency, gelten nicht für die Daten, während sie vom Drittanbieter-Suchanbieter verarbeitet werden. Wenn sich Ihr Consumer-Projekt in einem VPC-SC-Perimeter befindet, lehnt Vertex AI die Anfragen mit der folgenden Fehlermeldung ab:

{
  "error": {
    "code": 400,
    "message": "The requested model does not serve requests restricted by VPCSC",
    "status": "FAILED_PRECONDITION"
  }
}

Diese Funktion ist ausschließlich für Claude 4.0 und nachfolgende Modelle verfügbar. Sie ist nicht für ältere Claude-Modelle auf der Gemini Enterprise Agent Platform verfügbar. Liste der Drittanbieter-Suchdienste, die von der Anthropic Web Search-Funktion aufgerufen werden können, wenn die Websuchfunktion verwendet wird:

Preise

Die Websuche wird als Add-on zur Standardnutzung der Messages API abgerechnet. Der Preis richtet sich nach dem Volumen der Webanfragen. Aufgrund der zusätzlichen Sampling-Aufrufe werden den Nutzern auch die zusätzlichen Eingabetokens in Rechnung gestellt.

Weitere Informationen finden Sie unter Preise.