Fundierung mit der Exa-Websuche

Vorschau

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Exa bietet eine Such-API, die Zugriff auf öffentlich verfügbare Webdaten bietet, die für die Fundierung von Antworten großer Sprachmodelle optimiert sind. Auf dieser Seite wird erläutert, wie Sie Gemini-Antworten mit Exa fundieren.

Die Fundierung mit der Exa-Websuche auf der Gemini Enterprise Agent Platform ist ein separates Angebot (wie in Ihrer Google Cloud Vereinbarung definiert), das Gemini-Modelle mit öffentlichen Webdaten verbindet, die von der Such-API von Exa bereitgestellt werden.

Hinweis: Für Webpublisher werden bei der Fundierung mit Exa auf der Gemini Enterprise Agent Platform Deaktivierungssignale wie „noindex“-Tags berücksichtigt. Web Publisher können ihre Deaktivierungseinstellungen verwalten, indem sie der Anleitung in der Exa-Dokumentation folgen.

Anwendungsfälle

Die Fundierung mit Exa verbessert die Genauigkeit und reduziert Halluzinationen, indem sie Modellen Zugriff auf aktuelle, relevante Webdaten ermöglicht. Zu den häufigsten Anwendungsfällen gehören:

• Allgemeine Agents und Chatbots: Aktuelle Informationen abrufen, um zuverlässigere Antworten zu generieren.
• Research-Agents: Umfassende Deep Web-Recherche in mehreren Quellen durchführen.
• Coding-Agents: Aktuelle Code-Snippets, Dokumente und technische Referenzen abrufen.
• Sprach-Agents: Webabruf zur Unterstützung von Sprachinteraktionen in Echtzeit mit geringer Latenz.
• Branchenspezifische Agents: Aktuelle, domänenspezifische Informationen abrufen, die auf eine bestimmte Branche oder einen bestimmten Wissensbereich zugeschnitten sind.
• Datenanreicherung: Interne Datensätze mit aktuellem Webkontext und Metadaten ergänzen.
• Automatisierte Workflows: Regelmäßig Nachrichten, Personen-, Unternehmens- oder andere häufig aktualisierte Daten für interne oder Produktions-Workflows erfassen.

Beispiel

Wer hat den Super Bowl 2026 gewonnen?

Ohne Fundierung	Mit Fundierung
Ich kann Ihnen nicht sagen, wer den Super Bowl 2026 gewonnen hat, da dieses Ereignis noch nicht stattgefunden hat.	Die Seattle Seahawks haben am 8. Februar 2026 den Super Bowl LX gewonnen und die New England Patriots mit einem Endergebnis von 29:13 besiegt. Quellen:domain1.com, domain2.com, ...

Unterstützte Modelle

Die Fundierung mit Exa wird von den folgenden Modellen unterstützt:

• Gemini 2.5 Flash (gemini-2.5-flash)
• Gemini 2.5 Flash-Lite (gemini-2.5-flash-lite)
• Gemini 2.5 Pro (gemini-2.5-pro)
• Gemini 3.1 Pro (gemini-3.1-pro-preview)
• Gemini 3.1 Flash Lite (gemini-3.1-flash-lite)
• Gemini 3.5 Flash (gemini-3.5-flash)

Hinweis

Wenn Sie die Fundierung mit Exa verwenden möchten, müssen Sie einen API-Schlüssel von der Exa-Website abrufen. Dieser API-Schlüssel wird in Ihrer Anfrage an Gemini verwendet.

Gemini-Antworten mit Exa fundieren

Fordern Sie fundierte Antworten von Gemini an, indem Sie die REST API wie folgt verwenden. Für eine optimale Leistung empfehlen wir, die Standardeinstellungen für optionale Parameter zu verwenden, es sei denn, Sie benötigen unbedingt andere Werte.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• LOCATION: Die Region, in der die Anfrage verarbeitet werden soll. Wenn Sie den globalen Endpunkt verwenden möchten, lassen Sie den Standort aus dem Endpunktnamen weg und konfigurieren Sie den Standort der Ressource auf `global`.
• PROJECT_ID: Ihre Google Cloud Projekt-ID
• MODEL_ID: Die ID des Modells, das verwendet werden soll
• TEXT: Der Text-Prompt, der an das Modell gesendet werden soll
• API_KEY: Ihr API-Schlüssel für die Exa-Websuche
• SEARCH_TYPE: Optional: Der Typ der Exa-Suche, die ausgeführt werden soll Gültige Werte sind auto (Standard) und fast. fast wird mit geringerer Latenz ausgeführt, aber die Suche ist weniger umfassend.
• EXCLUDE_DOMAINS: Optional: Liste der Domains, die aus den Suchergebnissen ausgeschlossen werden sollen Wenn angegeben, werden keine Ergebnisse aus diesen Domains zurückgegeben. Sie können bis zu 1.200 Domains angeben.
• INCLUDE_DOMAINS: Optional: Liste der Domains, die in die Suche einbezogen werden sollen Wenn angegeben, stammen die Ergebnisse nur aus diesen Domains. Sie können bis zu 1.200 Domains angeben.
• MAX_CHARACTERS: Optional: Maximale Anzahl der Zeichen die für Highlights zurückgegeben werden sollen Steuert die Gesamtlänge des Highlight-Texts, der pro URL zurückgegeben wird.
• NUM_RESULTS: Optional: Die maximale Anzahl der Suchergebnisse, die für die Fundierung verwendet werden sollen Enthält standardmäßig den Wert 5, wenn nichts anderes angegeben ist.

HTTP-Methode und URL:

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent

JSON-Text anfordern:

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "TEXT"
    }]
  }],
  "tools": [{
    "exaAiSearch": {
        "api_key": "API_KEY",
        "customConfigs": {
            "type": "SEARCH_TYPE",
            "excludeDomains": ["EXCLUDE_DOMAINS"],
            "includeDomains": ["INCLUDE_DOMAINS"],
            "contents": {
                "highlights": {
                    "maxCharacters": MAX_CHARACTERS
                }
            },
            "numResults": NUM_RESULTS
        }
    }
}],
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Antwort

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "The Seattle Seahawks won Super Bowl LX on February 8, 2026, defeating the New England Patriots with a final score of 29-13."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "webSearchQueries": [
          "who won the last super bowl"
        ],
        "groundingChunks": [
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LX",
              "domain": "domain.com"
            }
          },
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LX Results",
              "domain": "domain.com"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 125,
              "text": "The Seattle Seahawks won Super Bowl LX on February 8, 2026, defeating the New England Patriots with a final score of 29-13."
            },
            "groundingChunkIndices": [
              0,
              1
            ]
          }
        ]
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 33,
    "candidatesTokenCount": 106,
    "totalTokenCount": 284,
    "billablePromptUsage": {
      "textCount": 142
    },
    "trafficType": "ON_DEMAND",
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 33
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 106
      }
    ],
    "toolUsePromptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 39
      }
    ],
    "toolUsePromptTokenCount": 39,
    "thoughtsTokenCount": 106
  },
  "modelVersion": "MODEL_VERSION",
  "createTime": "CREATE_TIME",
  "responseId": "RESPONSE_ID"
}

Quota

Das Standardkontingent beträgt 200 Prompts pro Minute. Wenn Sie Ihre Ratenlimits erhöhen möchten, wenden Sie sich mit Ihrem Anwendungsfall und Ihren Anforderungen an [e-mail] und Ihr Google-Kontoteam.

Abrechnung

Für die Verwendung der Fundierung mit Exa fallen die folgenden Gebühren an:

• Gemini-Tokenverbrauch: Prompt-Tokens, Thinking-Tokens, Output-Tokens. Weitere Informationen finden Sie unter Preise.
• Gemini-Fundierung mit Ihren Daten: Weitere Informationen finden Sie unter Preise.
• Preise für die Verwendung der Such-API von Exa: Weitere Informationen finden Sie auf der Preisseite von Exa.