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 von Large Language Models optimiert sind. Auf dieser Seite wird erläutert, wie Sie Gemini-Antworten mithilfe von Exa kontextualisieren.

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

Hinweis :Bei Web-Publishern werden bei der Fundierung mit Exa auf der Gemini Enterprise Agent Platform Opt-out-Signale wie „noindex“-Tags berücksichtigt. Webpublisher können ihre Einstellungen für den Opt-out verwalten, indem sie der Anleitung in der Exa-Dokumentation folgen.

Anwendungsfälle

Durch die Fundierung mit Exa wird die Genauigkeit verbessert und Halluzinationen werden reduziert, da Modelle Zugriff auf aktuelle, relevante Webdaten erhalten. Zu den häufigsten Anwendungsfällen gehören:

• Allgemeine Agents und Chatbots: Aktuelle Informationen abrufen, um zuverlässigere Antworten zu generieren.
• Research-Agents: Führen Sie umfassende Deep Web-Recherchen in mehreren Quellen durch.
• Coding-Agents: Rufen Sie die neuesten Code-Snippets, Dokumente und technischen Referenzen ab.
• Sprachagenten: Webabruf zur Unterstützung von Sprachinteraktionen in Echtzeit mit niedriger Latenz.
• Branchenspezifische Agenten: Rufen Sie aktuelle, domänenspezifische Informationen ab, die auf eine bestimmte Branche oder Wissensvertikale zugeschnitten sind.
• Datenanreicherung: Interne Datasets mit aktuellem Webkontext und Metadaten anreichern.
• Automatisierte Workflows: Sammeln Sie regelmäßig Nachrichten, Informationen zu Personen, Unternehmen oder andere häufig aktualisierte Daten für interne oder Produktions-Workflows.

Beispiel

Wer hat den Super Bowl 2026 gewonnen?

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

Unterstützte Modelle

In diesem Abschnitt sind die Modelle aufgeführt, die die Fundierung mit der Exa-Websuche unterstützen.

Hinweis

Wenn Sie Grounding 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

So fordern Sie fundierte Antworten von Gemini über die REST API an: Für eine optimale Leistung empfehlen wir, die Standardeinstellungen für optionale Parameter zu verwenden, sofern Sie nicht unbedingt andere Werte benötigen.

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, schließen Sie den Standort aus dem Endpunktnamen aus 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.
• EXCLUDE_DOMAINS: Optional: Liste der Domains, die aus den Suchergebnissen ausgeschlossen werden sollen. Wenn angegeben, werden keine Ergebnisse von 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 die 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 10, 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": {
            "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"
}

Kontingent

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 an Ihr Google-Account-Team.

Abrechnung

Für die Verwendung von Grounding mit Exa fallen die folgenden Gebühren an:

• Gemini-Tokenverbrauch: Prompt-Tokens, Thinking-Tokens, Ausgabe-Tokens. Weitere Informationen finden Sie unter Preise.
• Fundierung von Gemini auf 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.