Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 faktenbasierte 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 F1-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. Für sensible Arbeitslasten ist auch ein Zero Data Retention-Angebot verfügbar. Wenn Sie ZDR verwenden möchten, müssen Sie das ZDR-Angebot 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 Google Cloud Marketplace können Sie Ihr Grounding mit dem Dienst „Parallel Web Search“ direkt in Google Cloudverwalten. Abonnieren Sie dazu den Dienst „Grounding with Parallel Web Search“ auf dem 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

Sie können fundierte Antworten von Gemini anfordern, indem Sie Agent Studio in der Google Cloud Console, das Google Gen AI SDK oder die REST API verwenden. 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.

Bevor Sie die Beispiele ausführen, müssen Sie die Voraussetzungen erfüllen, einschließlich Abonnement im Google Cloud Marketplace oder Bereitstellung eines Parallel API-Schlüssels.

Jedes SDK-Beispiel liest Ihr Projekt und Ihren Standort aus den Umgebungsvariablen, die auf dem jeweiligen Tab angezeigt werden. Ersetzen Sie im Beispielcode MODEL_ID durch die ID eines unterstützten Modells, z. B. gemini-2.5-flash.

Console

So fundieren Sie Gemini-Antworten mit der parallelen Websuche über Agent Studio auf der Gemini Enterprise Agent Platform:

Rufen Sie in der Google Cloud Console die Seite Agent Studio auf.

Zu Agent Studio
Aktivieren Sie in der Seitenleiste unter Modelleinstellungen im Bereich Fundierung den Ein/Aus-Button Partner (Suchergebnisse von Fundierungspartnern).
Wählen Sie Parallel Web Search als Grounding-Partner aus und klicken Sie dann auf Übernehmen. Wenn Sie die parallele Websuche verwenden möchten, müssen Sie sie zuerst im Google Cloud Marketplace abonnieren.
Geben Sie Ihren Prompt in das Textfeld ein und senden Sie ihn ab.

Ihre Prompt-Antworten werden jetzt mit der Fundierung mit Parallel Web Search erstellt.

Python

Installieren

pip install --upgrade google-genai

Weitere Informationen finden Sie in der SDK-Referenzdokumentation.

Umgebungsvariablen für die Verwendung des Google Gen AI SDK mit Vertex AI festlegen:

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="MODEL_ID",
    contents="Who won the 2025 Las Vegas F1 Grand Prix?",
    config=types.GenerateContentConfig(
        tools=[
            types.Tool(
                parallel_ai_search=types.ToolParallelAiSearch(
                    # Optional. Omit api_key if you subscribed to Grounding with
                    # Parallel Web Search on Google Cloud Marketplace. Otherwise,
                    # provide your Parallel API key.
                    # api_key="API_KEY",
                    # Optional. Customize the search. See the REST tab for the
                    # full list of supported parameters. Keys inside custom_configs
                    # are Parallel.ai Search API params (snake_case).
                    custom_configs={
                        "mode": "basic",
                        "max_results": 10,
                        "source_policy": {"include_domains": ["wikipedia.org"]},
                    },
                )
            )
        ],
    ),
)

print(response.text)
# Example response:
# Max Verstappen won the 2025 Las Vegas F1 Grand Prix ...

# The grounding metadata contains the web sources used to ground the response.
print(response.candidates[0].grounding_metadata.grounding_chunks)

Um die Suche anzupassen, legen Sie das Feld custom_configs von ToolParallelAiSearch fest. In diesem Feld werden dieselben optionalen Parameter akzeptiert, die auf dem Tab REST beschrieben sind, z. B. source_policy, excerpts, max_results und mode.

Java

Informationen zum Installieren oder Aktualisieren von Java

Weitere Informationen finden Sie in der SDK-Referenzdokumentation.

Umgebungsvariablen für die Verwendung des Google Gen AI SDK mit Vertex AI festlegen:

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

import com.google.genai.Client;
import com.google.genai.types.GenerateContentConfig;
import com.google.genai.types.GenerateContentResponse;
import com.google.genai.types.Tool;
import com.google.genai.types.ToolParallelAiSearch;
import java.util.List;
import java.util.Map;

public class ParallelGroundingSample {
  public static void main(String[] args) {
    try (Client client = Client.builder().build()) {

      GenerateContentConfig config =
          GenerateContentConfig.builder()
              .tools(
                  // Omit apiKey if you subscribed to Grounding with Parallel Web
                  // Search on Google Cloud Marketplace. Otherwise, set apiKey to
                  // your Parallel API key.
                  Tool.builder()
                      .parallelAiSearch(
                          ToolParallelAiSearch.builder()
                              // Optional. Customize the search. See the REST tab
                              // for the full list of supported parameters. Keys
                              // inside customConfigs are Parallel.ai Search API
                              // params (snake_case).
                              .customConfigs(
                                  Map.of(
                                      "mode", "basic",
                                      "max_results", 10,
                                      "source_policy",
                                      Map.of(
                                          "include_domains",
                                          List.of("wikipedia.org"))))
                              .build())
                      .build())
              .build();

      GenerateContentResponse response =
          client.models.generateContent(
              "MODEL_ID", "Who won the 2025 Las Vegas F1 Grand Prix?", config);

      System.out.println(response.text());
    }
  }
}

Um die Suche anzupassen, legen Sie das Feld customConfigs von ToolParallelAiSearch fest. In diesem Feld werden dieselben optionalen Parameter akzeptiert, die auf dem Tab REST beschrieben sind, z. B. source_policy, excerpts, max_results und mode.

Node.js

Installieren

npm install @google/genai

Weitere Informationen finden Sie in der SDK-Referenzdokumentation.

Umgebungsvariablen für die Verwendung des Google Gen AI SDK mit Vertex AI festlegen:

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

import {GoogleGenAI} from '@google/genai';

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: 'MODEL_ID',
  contents: 'Who won the 2025 Las Vegas F1 Grand Prix?',
  config: {
    tools: [
      // Omit apiKey if you subscribed to Grounding with Parallel Web Search on
      // Google Cloud Marketplace. Otherwise, set apiKey to your Parallel API key.
      {
        parallelAiSearch: {
          // Optional. Customize the search. See the REST tab for the full
          // list of supported parameters. Keys inside customConfigs are
          // Parallel.ai Search API params (snake_case).
          customConfigs: {
            mode: 'basic',
            max_results: 10,
            source_policy: {include_domains: ['wikipedia.org']},
          },
        },
      },
    ],
  },
});

console.log(response.text);

Wenn Sie die Suche anpassen möchten, legen Sie das Feld customConfigs des Tools parallelAiSearch fest. In diesem Feld werden dieselben optionalen Parameter akzeptiert, die auf dem Tab REST beschrieben sind, z. B. source_policy, excerpts, max_results und mode.

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.
ENABLE_ZERO_DATA_RETENTION: Optional: Wechseln Sie zur ZDR-Version der parallelen Websuche, um die Zero Data Retention für sensible Arbeitslasten zu aktivieren. Legen Sie true fest, um das ZDR-Angebot für Ihre Anfrage zu verwenden. Sie müssen das ZDR-spezifische Angebot abonniert haben, damit diese Anfragen erfolgreich sind. Wenn nichts angegeben ist, wird standardmäßig die Standardversion verwendet. Die ZDR-Version ist nur über 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-Endungen, 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. 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 200 Domains angeben.
MAX_CHARS_PER_RESULT: Optional: Die maximale Anzahl von Zeichen, die in jedem Auszug aus den Suchergebnissen enthalten sein sollen. Wenn nichts angegeben ist, 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",
        "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"
}

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.

Fundierung mit Parallel Web Search Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Anwendungsfälle

Unterstützte Modelle

Hinweis

Über Google Cloud Marketplace abonnieren (empfohlen)

Eigenen API-Schlüssel verwenden

Gemini-Antworten mit Parallel fundieren

Console

Python

Installieren

Java

Node.js

Installieren

REST

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Antwort

Kontingent

Abrechnung

Fundierung mit Parallel Web Search