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 große Sprach modelle zur Fundierung optimiert sind. Auf dieser Seite wird erläutert, wie Sie Gemini-Antworten mit Parallel fundieren.

Die Fundierung mit Parallel auf der Gemini Enterprise Agent Platform ist ein separates Angebot (wie definiert in Ihrer Google Cloud Vereinbarung), das Gemini-Modelle mit öffentlichen Webdaten verbindet, die von Parallel Web Systems' Such-API bereitgestellt werden. Dieser Dienst ermöglicht Gemini den Zugriff auf Live-Informationen von Milliarden von Webseiten, um aktuellere und faktenbasierte Antworten zu geben.

Anwendungsfälle

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

Webdaten zur Vervollständigung oder Anreicherung von Informationen verwenden.
Multi-Hop-Agents, die für komplexere Fragen umfassendere Websuchen erfordern.
Eine API erstellen, die Websuchdaten integriert.
Mitarbeiterorientierte Assistenten, mit denen Endnutzer Fragen stellen und komplexe Berichte mit den neuesten Webinformationen erstellen können.
Anwendungen für Nutzer wie Einzelhandel und Reisen, mit denen Nutzer fundierte Kaufentscheidungen treffen können.
Automatisierte Agents, die autonom ausgeführt werden, um automatisierte Aufgaben wie Nachrichtenanalysen und KYC-Prüfungen durchzuführen.
Vertikale Agents (Vertriebs-, Programmier- und Finanz-Agents), die die neuesten aktuellen Kontextinformationen aus dem Web abrufen.

Beispiel

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

Ohne Fundierung	Mit Fundierung
Der Grand Prix von Las Vegas 2025 hat noch nicht stattgefunden. Das Rennen ist für das Wochenende vom 20. bis 22. November 2025 geplant. 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 der Parallel-Websuche 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 der Parallel-Websuche verwenden möchten, müssen Sie den Zugriff einrichten. Dazu haben Sie zwei Möglichkeiten:

Abonnieren Sie die Fundierung mit der Parallel-Websuche direkt im Google Cloud Marketplace (Vorschau), um sie nahtlos in Ihre bestehende Cloud-Umgebung zu integrieren. Für vertrauliche Arbeitslasten ist auch ein Angebot ohne Datenaufbewahrung verfügbar. Wenn Sie dieses Angebot nutzen möchten, müssen Sie es abonnieren und das entsprechende enable_zero_data_retention-Flag in Ihren API-Anfragen festlegen.
Verwenden Sie einen vorhandenen Parallel-API-Schlüssel.

Durch die Integration über den Google Cloud Marketplace können Sie den Dienst „Fundierung mit der Parallel-Websuche“ direkt in Google Cloudverwalten. Abonnieren Sie dazu den Dienst „Fundierung mit der Parallel-Websuche“ im Google Cloud Marketplace, akzeptieren Sie die Nutzungsbedingungen und sehen Sie sich die Preise an.

Eigenen API-Schlüssel verwenden

Wenn Sie die Abrechnung und den API-Zugriff für Parallel separat verwalten möchten, können Sie Ihren eigenen API-Schlüssel angeben. Dazu müssen Sie einen API-Schlüssel von der Parallel-Entwicklerplattform abrufen. Dieser API-Schlüssel wird direkt in Ihren REST API-Anfragen an Gemini verwendet.

Gemini-Antworten mit Parallel fundieren

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

Wenn Sie die Fundierung mit der Parallel-Websuche im Google Cloud Marketplace (Vorschau) abonniert haben, prüfen Sie ob das für Ihr Abo verwendete Rechnungskonto in Ihrem Google 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, 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 Parallel-Websuche Wenn Sie einen API-Schlüssel angeben und auch die Fundierung mit der Parallel-Websuche im Google Cloud Marketplace (Vorschau) abonniert haben, hat der API-Schlüssel Vorrang.
ENABLE_ZERO_DATA_RETENTION: Optional: Wechseln Sie zur Version der Parallel-Websuche ohne Datenaufbewahrung, um die Datenaufbewahrung für vertrauliche Arbeitslasten zu deaktivieren. Setzen Sie den Wert auf true, um das Angebot ohne Datenaufbewahrung für Ihre Anfrage zu verwenden. Sie müssen das Angebot ohne Datenaufbewahrung abonniert haben, damit diese Anfragen erfolgreich sind. Wenn nichts angegeben ist, wird standardmäßig die Standardversion verwendet. Die Version ohne Datenaufbewahrung ist nur über den Google Cloud Marketplace verfügbar.
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-Erweiterungen, die mit einem Punkt beginnen ( .gov, .edu, .co.uk). Sie können bis zu 200 Domains angeben.
INCLUDE_DOMAINS: Optional: Liste der Domains, die in die Fundierungsquellen aufgenommen werden sollen. Wenn angegeben, werden Quellen aus diesen Domains eingeschlossen. Zulässige Werte sind Domains (www.beispiel.de) oder Domain-Erweiterungen, die mit einem Punkt beginnen ( .gov, .edu, .co.uk). Sie können bis zu 200 Domains angeben.
MAX_CHARS_PER_RESULT: Optional: Die maximale Anzahl von Zeichen, die in jeden Auszug aus den Suchergebnissen aufgenommen werden sollen. Wenn nichts angegeben ist, wird standardmäßig auf 30000 gesetzt. Der zulässige Bereich ist [1000, 100000].
MAX_CHARS_TOTAL: Optional: Die maximale Gesamtzahl der Zeichen aus allen Auszügen aus den Suchergebnissen. Wenn nichts angegeben ist, wird standardmäßig 100000 verwendet. Der zulässige Bereich ist [1000, 1000000].
MAX_RESULTS: Optional: Die maximale Anzahl der Suchergebnisse, die für die Fundierung verwendet werden sollen. Wenn nichts angegeben ist, wird standardmäßig 10 verwendet. 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. Verwenden Sie den Modus advanced, wenn Sie umfassendere Suchergebnisse wünschen, 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 der Anfrage:

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "TEXT"
    }]
  }],
  "tools": [{
    "parallelAiSearch": {
        "api_key": "API_KEY",
        "enable_zero_data_retention": ENABLE_ZERO_DATA_RETENTION,
        "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"
}

Quota

Das Standardkontingent beträgt 200 Prompts pro Minute. Wenn Sie eine Erhöhung Ihrer Ratenlimits beantragen möchten, geben Sie den Anwendungsfall und die Anforderungen an den entsprechenden Ansprechpartner an:

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

Abrechnung

Für die Nutzung der Fundierung mit der Parallel-Websuche fallen die folgenden Gebühren an:

Gemini-Tokenverbrauch:Es können Gebühren für Folgendes anfallen:
- Prompt-Tokens
- Thinking-Tokens
- Ausgabetokens
Weitere Informationen finden Sie unter Preise.
Fundierung von Gemini mit Ihren Daten: Weitere Informationen finden Sie unter Preise.
Preise für die Nutzung der Parallel-Websuche-API :
- Wenn Sie die Fundierung mit der Parallel-Websuche im Google Cloud Marketplace (Vorschau) abonniert haben, finden Sie weitere Informationen im Abschnitt zu den Parallel-Preisen im Google Cloud Marketplace.
- Wenn Sie Ihren eigenen API-Schlüssel angeben, finden Sie weitere Informationen auf der Parallel-Website.