Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Fundierung mit Parallel Web Search

Parallel Web Systems bietet eine Such-API, die Zugriff auf öffentlich verfügbare Webdaten bietet, die für die Verwendung durch Large Language Models zur Fundierung optimiert sind. Auf dieser Seite wird erläutert, wie Sie Gemini-Antworten mit Parallel fundieren.

Grounding mit Parallel auf der Gemini Enterprise Agent Platform ist ein separates Angebot (wie in Ihrem Google Cloud Vertrag definiert), das Gemini-Modelle mit öffentlichen Webdaten verbindet, die von der Such-API von Parallel Web Systems bereitgestellt werden. Dieser Dienst ermöglicht Gemini den Zugriff auf aktuelle Informationen von Milliarden von Webseiten, um aktuellere und faktenbasiertere Antworten zu liefern.

Anwendungsfälle

Die Fundierung mit Parallel eignet sich für Anwendungsfälle wie die folgenden:

Webdaten zum Vervollständigen oder Anreichern von Informationen verwenden.
Multi-Hop-Agents, die für komplexere Fragen ausführlichere Websuchen erfordern.
Entwicklung einer API, in die Websuchdaten eingebunden werden.
Assistenten für Mitarbeiter, mit denen Endnutzer Fragen stellen und komplexe Berichte mit den neuesten Webinformationen erstellen können.
Anwendungen für Nutzer wie Einzelhandel und Reisen, die es dem Nutzer ermöglichen, fundierte Kaufentscheidungen zu treffen.
Automatisierte Agents, die autonom ausgeführt werden, um automatisierte Aufgaben wie Nachrichtenanalyse und KYC-Prüfungen durchzuführen.
Vertikale Agents (Vertriebs-, Coding- und Finanz-Agents), die den neuesten Kontext aus dem Web erhalten.

Beispiel

Wer hat den Formel 1-Grand Prix von Las Vegas 2025 gewonnen?

Ohne Fundierung	Mit Erdung
Der Las Vegas Grand Prix 2025 hat noch nicht stattgefunden. Das Rennen findet planmäßig am Wochenende vom 20. bis 22. November 2025 statt. Daher ist der Gewinner unbekannt.	Der Gewinner des Formel-1-Grand-Prix von Las Vegas 2025 war Max Verstappen von Red Bull Racing. Das Rennen fand am 22. November 2025 statt. Quellen: domain1.com, domain2.com, ...

Unterstützte Modelle

Die Fundierung mit Parallel Web Search 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 Parallel Web Search verwenden möchten, müssen Sie den Zugriff einrichten. Sie haben zwei Möglichkeiten:

Abonnieren Sie Grounding mit paralleler Websuche direkt im Google Cloud Marketplace (Vorabversion), um eine optimierte Integration in Ihre bestehende Cloud-Umgebung zu ermöglichen.
Verwenden Sie einen vorhandenen Parallel API-Schlüssel.

Wenn Sie die Integration über Google Cloud Marketplace vornehmen, können Sie Ihren Grounding with Parallel Web Search-Dienst direkt in Google Cloudverwalten. Abonnieren Sie dazu den Grounding with Parallel Web Search-Dienst auf Google Cloud Marketplace, akzeptieren Sie die Nutzungsbedingungen und sehen Sie sich die Preise an.

Eigenen API-Schlüssel verwenden

Wenn Sie die parallele Abrechnung und den API-Zugriff lieber separat verwalten möchten, können Sie Ihren eigenen API-Schlüssel angeben. Um diese Methode zu verwenden, benötigen Sie einen API-Schlüssel von der Parallel-Entwicklerplattform. Dieser API-Schlüssel wird direkt in Ihren REST API-Anfragen an Gemini verwendet.

Gemini-Antworten mit Parallel 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.

Wenn Sie das Grounding mit paralleler Websuche im Google Cloud Marketplace abonniert haben (Vorabversion), prüfen Sie, ob das für Ihr Abo verwendete Rechnungskonto in IhremGoogle Cloud -Projekt aktiv ist.

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 parallele Websuche. Wenn Sie einen API-Schlüssel angeben und auch für Grounding mit paralleler Websuche auf Google Cloud Marketplace (Vorschau) registriert sind, hat der API-Schlüssel Vorrang.
EXCLUDE_DOMAINS: Optional: Liste der Domains, die von den Fundierungsquellen ausgeschlossen werden sollen. Wenn angegeben, werden Quellen aus diesen Domains ausgeschlossen. Zulässige Werte sind Domains (www.beispiel.de) oder Domain-Endungen, die mit einem Punkt beginnen (.gov, .edu, .co.uk). Sie können bis zu 10 Domains angeben.
INCLUDE_DOMAINS: Optional: Liste der Domains, die in die Fundierungsquellen aufgenommen werden sollen. Falls angegeben, werden Quellen aus diesen Domains berücksichtigt. Zulässige Werte sind Domains (www.beispiel.de) oder Domain-Endungen, die mit einem Punkt beginnen (.gov, .edu, .co.uk). Sie können bis zu 10 Domains angeben.
MAX_CHARS_PER_RESULT: Optional: Die maximale Anzahl von Zeichen, die in jedem Suchergebnis-Auszug enthalten sein sollen. Wenn nicht angegeben, wird standardmäßig 30000 verwendet. Der zulässige Bereich ist [1000, 100000].
MAX_CHARS_TOTAL: Optional: Die maximale Gesamtzahl der Zeichen aus allen Auszügen der Suchergebnisse. Enthält standardmäßig den Wert 100000, wenn nichts anderes angegeben ist. Der zulässige Bereich ist [1000, 1000000].
MAX_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. Der zulässige Bereich ist [1, 20].
MODE (optional): Der Modus, der für die Anfrage verwendet werden soll, entweder basic oder advanced. Der Standardwert ist basic. Der Modus advanced ist sinnvoll, wenn Sie gründlichere Suchergebnisse benötigen, dafür aber eine höhere Latenz in Kauf nehmen.
SEARCH_LOCATION: Optional: Ländercode gemäß ISO 3166-1 Alpha-2 für geografisch ausgerichtete Suchergebnisse. Beispiel: "us".

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": [{
    "parallelAiSearch": {
        "api_key": "API_KEY",
        "customConfigs": {
            "mode": "MODE",
            "location": "SEARCH_LOCATION",
            "max_results": MAX_RESULTS,
            "source_policy": {
                "exclude_domains": ["EXCLUDE_DOMAINS"],
                "include_domains": ["INCLUDE_DOMAINS"],
            },
            "excerpts": {
                "max_chars_per_result": MAX_CHARS_PER_RESULT,
                "max_chars_total": MAX_CHARS_TOTAL
            }
        }
    }
}],
  "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 most recent Super Bowl was Super Bowl LIX (59), which was played in 2025. The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "webSearchQueries": [
          "who won the last super bowl"
        ],
        "groundingChunks": [
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX",
              "domain": "domain.com"
            }
          },
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX Results",
              "domain": "domain.com"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 77,
              "text": "The most recent Super Bowl was Super Bowl LIX (59), which was played in 2025."
            },
            "groundingChunkIndices": [
              0,
              1
            ]
          },
          {
            "segment": {
              "startIndex": 78,
              "endIndex": 198,
              "text": "The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
            },
            "groundingChunkIndices": [
              0
            ]
          },
        ]
      }
    }
  ],
  "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 eine Erhöhung Ihrer Ratenlimits beantragen möchten, geben Sie den entsprechenden Kontakt Ihren Anwendungsfall und Ihre Anforderungen an:

Wenn Sie Grounding mit paralleler Websuche im Google Cloud Marketplace abonniert haben (Vorschau): Wenden Sie sich an Ihr Google-Account-Team.
Wenn Sie Ihren eigenen API-Schlüssel angeben:Wenden Sie sich an support@parallel.ai und an Ihr Google-Account-Team.

Abrechnung

Für die Verwendung der Fundierung mit Parallel Web Search fallen die folgenden Gebühren an:

Gemini-Token-Verbrauch:Sie können für Folgendes abgerechnet werden:
- Prompt-Tokens
- Thinking-Tokens
- Ausgabetokens
Weitere Informationen finden Sie unter Preise.
Fundierung von Gemini auf Ihren Daten:Weitere Informationen finden Sie unter Preise.
Preise für die Nutzung der Parallel Web Search API:
- Wenn Sie Grounding mit Parallel Web Search im Google Cloud Marketplace (Vorschau) abonniert haben, finden Sie weitere Informationen im Abschnitt Parallel pricing (Parallele Preisgestaltung) im Google Cloud Marketplace.
- Wenn Sie Ihren eigenen API-Schlüssel angeben, finden Sie weitere Informationen auf der parallelen Website.