עיגון בנתונים באמצעות חיפוש מקביל באינטרנט

‫Parallel Web Systems מציעה API לחיפוש שמאפשר גישה לנתונים באינטרנט שזמינים לציבור ועברו אופטימיזציה לשימוש על ידי מודלים גדולים של שפה (LLM) לצורך ביסוס. בדף הזה מוסבר איך להשתמש ב-Parallel כדי להקפיד על תשובות של Gemini.

‫Grounding with Parallel ב-Gemini Enterprise Agent Platform הוא מוצר נפרד (כפי שמוגדר ב Google Cloud הסכם) שמקשר בין מודלים של Gemini לבין נתונים ציבוריים באינטרנט שמסופקים על ידי Parallel Web Systems' search API. השירות הזה מאפשר ל-Gemini לגשת למידע עדכני ממיליארדי דפי אינטרנט, כדי לתת תשובות עדכניות ועובדתיות יותר.

תרחישים לדוגמה

ההארקה באמצעות Parallel מתאימה לתרחישי שימוש כמו:

  • שימוש בנתוני אתר למטרות השלמה או העשרה של מידע.
  • סוכנים מרובי-שלבים שנדרשים לחיפושים מעמיקים באינטרנט כדי לענות על שאלות מורכבות יותר.
  • פיתוח API שמשלב נתונים מחיפוש באינטרנט.
  • עוזרים וירטואליים שפונים לעובדים ומאפשרים למשתמשי קצה לשאול שאלות וליצור דוחות מורכבים באמצעות המידע העדכני ביותר באינטרנט.
  • אפליקציות שפונות לצרכנים, כמו אפליקציות קמעונאיות ואפליקציות בתחום התיירות, שמאפשרות למשתמש לקבל החלטות רכישה מושכלות.
  • סוכנים אוטומטיים שפועלים באופן אוטונומי כדי לבצע משימות אוטומטיות, כמו ניתוח חדשות ובדיקות הכרת הלקוח (KYC).
  • סוכנים אנכיים (סוכני מכירות, סוכני תכנות, סוכנים פיננסיים) שמקבלים את ההקשר העדכני ביותר מהאינטרנט.

דוגמה

מי ניצח במירוץ הגרנד פרי פורמולה 1 בלאס וגאס בשנת 2025?

ללא נקודת התייחסות עם הארקה
מרוץ הגראן פרי בלאס וגאס בשנת 2025 עדיין לא התקיים. המירוץ מתוכנן להתקיים בסוף השבוע של 20-22 בנובמבר 2025. לכן, לא ידוע מי המנצח. הזוכה במירוץ הגרנד פרי פורמולה 1 בלאס וגאס בשנת 2025 היה מקס ורסטאפן מקבוצת רד בול רייסינג. המירוץ התקיים ב-22 בנובמבר 2025. מקורות: domain1.com, domain2.com, ...

מודלים נתמכים

המודלים הבאים תומכים בהארקה באמצעות חיפוש מקביל באינטרנט:

  • ‫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)

לפני שמתחילים

כדי להשתמש ב-Grounding עם חיפוש מקביל באינטרנט, צריך להגדיר את הגישה. יש לכם שתי אפשרויות:

  • כדי לשלב את התכונה בצורה חלקה בסביבת הענן הקיימת שלכם, אתם יכולים להירשם ישירות ל-Grounding with Parallel Web Search ב-Google Cloud Marketplace. יש גם אפשרות של אפס שמירת נתונים לעומסי עבודה רגישים. כדי להשתמש ב-ZDR, צריך להירשם למינוי של ZDR וגם להגדיר את הדגל המתאים enable_zero_data_retention בבקשות ה-API.

  • שימוש במפתח API קיים של Parallel.

הרשמה ב-Google Cloud Marketplace (מומלץ)

שילוב דרך Google Cloud Marketplace מאפשר לכם לנהל את ההארקה באמצעות שירות החיפוש המקביל באינטרנט ישירות בתוך Google Cloud. כדי להתחיל, צריך להירשם לשירות Grounding with Parallel Web Search ב-Google Cloud Marketplace, לאשר את התנאים וההגבלות ולעיין בתמחור.

שימוש במפתח API משלכם

אם אתם מעדיפים לנהל בנפרד את החיוב ב-Parallel ואת הגישה ל-API, אתם יכולים לספק מפתח API משלכם. כדי להשתמש ב-method הזו, צריך לקבל מפתח API מפלטפורמת המפתחים של Parallel. מפתח ה-API הזה משמש ישירות בבקשות שלכם ל-API בארכיטקטורת REST אל Gemini.

הצגת תשובות מבוססות-מידע מ-Gemini באמצעות Parallel

אפשר לבקש מ-Gemini תשובות מעוגנות בנתונים באמצעות Agent Studio במסוף Google Cloud , Google Gen AI SDK או API בארכיטקטורת REST. כדי להשיג את הביצועים הטובים ביותר, מומלץ להשתמש בהגדרות ברירת המחדל לפרמטרים אופציונליים, אלא אם אתם צריכים ערכים שאינם ברירת המחדל.

אם נרשמתם ל-Grounding with Parallel Web Search ב-Google Cloud Marketplace, צריך לוודא שהחשבון לחיוב שבו השתמשתם להרשמה פעיל בGoogle Cloud פרויקט.

לפני שמריצים את הדוגמאות, צריך להשלים את הדרישות המוקדמות, כולל הרשמה ב-Google Cloud Marketplace או הזנת מפתח Parallel API.

המסוף

כדי להשתמש בחיפוש מקביל באינטרנט כדי להוסיף מידע לתשובות של Gemini באמצעות Agent Studio ב-Gemini Enterprise Agent Platform, פועלים לפי השלבים הבאים:

  1. נכנסים לדף Agent Studio במסוף Google Cloud .

    מעבר ל-Agent Studio

  2. בחלונית הצדדית, בקטע Grounding שמתחת לModel settings, מפעילים את המתג Partners (Search results from grounding partners).

  3. בוחרים באפשרות חיפוש מקביל באינטרנט כשותף להארקה ולוחצים על אישור. כדי להשתמש בחיפוש מקביל באינטרנט, קודם צריך להירשם אליו ב-Google Cloud Marketplace.

  4. מזינים את ההנחיה בתיבת הטקסט ושולחים אותה.

התשובות להנחיות שלכם כוללות עכשיו תוצאות מחיפוש מקביל באינטרנט.

Python

התקנה

pip install --upgrade google-genai

מידע נוסף מופיע ב מאמרי העזרה בנושא SDK.

מגדירים משתני סביבה כדי להשתמש ב-Google Gen AI SDK עם Vertex AI: 

# 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

לפני שמריצים את הדוגמה, צריך להחליף את הערכים הבאים:

  • ‫MODEL_ID: המזהה של מודל נתמך לשימוש, כמו gemini-2.5-flash.
  • TEXT: פרומפט טקסטואלי לשליחה למודל.
  • ‫API_KEY: מפתח ה-API שלכם לחיפוש מקביל באינטרנט. אם אתם מנויים ב-Google Cloud Marketplace, אל תציינו את הפרמטר הזה. אם מציינים את שני הפרמטרים, מפתח ה-API מקבל עדיפות.
  • ‫EXCLUDE_DOMAINS: אופציונלי: רשימה של דומיינים שצריך להחריג ממקורות ההארקה. אם מציינים דומיינים, המערכת לא כוללת מקורות מהדומיינים האלה. הערכים הקבילים הם דומיינים (www.example.com) או סיומות של דומיינים שמתחילות בנקודה ( ‎.gov,‏ ‎.edu,‏ ‎.co.uk). אפשר לציין עד 200 דומיינים.
  • ‫INCLUDE_DOMAINS: אופציונלי: רשימה של דומיינים שרוצים לכלול במקורות המידע. אם מציינים דומיינים, המקורות מהדומיינים האלה נכללים. הערכים הקבילים הם דומיינים (www.example.com) או סיומות של דומיינים שמתחילות בנקודה ( ‎.gov,‏ ‎.edu,‏ ‎.co.uk). אפשר לציין עד 200 דומיינים.
  • ‫MAX_CHARS_PER_RESULT: אופציונלי: מספר התווים המקסימלי שייכלל בכל קטע מתוצאת החיפוש. אם לא מציינים ערך, ברירת המחדל היא 30000. הטווח המותר הוא [1000, 100000].
  • ‫MAX_CHARS_TOTAL: אופציונלי: המספר המקסימלי של התווים מכל קטעי המידע מתוצאות החיפוש. אם לא מציינים ערך, ברירת המחדל היא 100000. הטווח המותר הוא [1000, 1000000].
  • ‫MAX_RESULTS: אופציונלי: מספר תוצאות החיפוש המקסימלי שישמשו להארקה. אם לא מציינים ערך, ברירת המחדל היא 10. הטווח המותר הוא [1, 20].
  • ‫MODE: אופציונלי: מצב לשימוש בבקשה, basic או advanced. ערך ברירת המחדל הוא basic. כדאי להשתמש במצב advanced אם רוצים לקבל תוצאות חיפוש מקיפות יותר, אבל זמן הטעינה יהיה ארוך יותר.
  • ‫SEARCH_LOCATION: אופציונלי: קוד מדינה בתקן ISO 3166-1 alpha-2 לתוצאות חיפוש שמטורגטות לפי מיקום גיאוגרפי. לדוגמה: "us".

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="MODEL_ID",
    contents="TEXT",
    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.
                    api_key="API_KEY",
                    # Optional. Set to True to use Zero Data Retention (ZDR) for
                    # sensitive workloads. Requires a separate ZDR Marketplace
                    # subscription; defaults to the standard subscription.
                    enable_zero_data_retention=True,
                    # Optional. Customize the search. Click a placeholder to
                    # enter a value, or remove the line to accept the default.
                    custom_configs={
                        "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,
                        },
                    },
                )
            )
        ],
    ),
)

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)

Java

כך מתקינים או מעדכנים את Java.

מידע נוסף מופיע ב מאמרי העזרה בנושא SDK.

מגדירים משתני סביבה כדי להשתמש ב-Google Gen AI SDK עם Vertex AI: 

# 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

לפני שמריצים את הדוגמה, צריך להחליף את הערכים הבאים:

  • ‫MODEL_ID: המזהה של מודל נתמך לשימוש, כמו gemini-2.5-flash.
  • TEXT: פרומפט טקסטואלי לשליחה למודל.
  • ‫API_KEY: מפתח ה-API שלכם לחיפוש מקביל באינטרנט. אם אתם מנויים ב-Google Cloud Marketplace, אל תציינו את הפרמטר הזה. אם מציינים את שני הפרמטרים, מפתח ה-API מקבל עדיפות.
  • ‫EXCLUDE_DOMAINS: אופציונלי: רשימה של דומיינים שצריך להחריג ממקורות ההארקה. אם מציינים דומיינים, המערכת לא כוללת מקורות מהדומיינים האלה. הערכים הקבילים הם דומיינים (www.example.com) או סיומות של דומיינים שמתחילות בנקודה ( ‎.gov,‏ ‎.edu,‏ ‎.co.uk). אפשר לציין עד 200 דומיינים.
  • ‫INCLUDE_DOMAINS: אופציונלי: רשימה של דומיינים שרוצים לכלול במקורות המידע. אם מציינים דומיינים, המקורות מהדומיינים האלה נכללים. הערכים הקבילים הם דומיינים (www.example.com) או סיומות של דומיינים שמתחילות בנקודה ( ‎.gov,‏ ‎.edu,‏ ‎.co.uk). אפשר לציין עד 200 דומיינים.
  • ‫MAX_CHARS_PER_RESULT: אופציונלי: מספר התווים המקסימלי שייכלל בכל קטע מתוצאת החיפוש. אם לא מציינים ערך, ברירת המחדל היא 30000. הטווח המותר הוא [1000, 100000].
  • ‫MAX_CHARS_TOTAL: אופציונלי: המספר המקסימלי של התווים מכל קטעי המידע מתוצאות החיפוש. אם לא מציינים ערך, ברירת המחדל היא 100000. הטווח המותר הוא [1000, 1000000].
  • ‫MAX_RESULTS: אופציונלי: מספר תוצאות החיפוש המקסימלי שישמשו להארקה. אם לא מציינים ערך, ברירת המחדל היא 10. הטווח המותר הוא [1, 20].
  • ‫MODE: אופציונלי: מצב לשימוש בבקשה, basic או advanced. ערך ברירת המחדל הוא basic. כדאי להשתמש במצב advanced אם רוצים לקבל תוצאות חיפוש מקיפות יותר, אבל זמן הטעינה יהיה ארוך יותר.
  • ‫SEARCH_LOCATION: אופציונלי: קוד מדינה בתקן ISO 3166-1 alpha-2 לתוצאות חיפוש שמטורגטות לפי מיקום גיאוגרפי. לדוגמה: "us".

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(
                  Tool.builder()
                      .parallelAiSearch(
                          ToolParallelAiSearch.builder()
                              // Optional. Omit apiKey if you subscribed to
                              // Grounding with Parallel Web Search on Google
                              // Cloud Marketplace.
                              .apiKey("API_KEY")
                              // Optional. Set to true to use Zero Data
                              // Retention (ZDR) for sensitive workloads.
                              // Requires a separate ZDR Marketplace
                              // subscription; defaults to the standard
                              // subscription.
                              .enableZeroDataRetention(true)
                              // Optional. Customize the search. Click a
                              // placeholder to enter a value, or remove the
                              // entry to accept the default.
                              .customConfigs(
                                  Map.of(
                                      "mode", "MODE",
                                      "location", "SEARCH_LOCATION",
                                      "max_results", MAX_RESULTS,
                                      "source_policy",
                                      Map.of(
                                          "exclude_domains",
                                          List.of("EXCLUDE_DOMAINS"),
                                          "include_domains",
                                          List.of("INCLUDE_DOMAINS")),
                                      "excerpts",
                                      Map.of(
                                          "max_chars_per_result",
                                          MAX_CHARS_PER_RESULT,
                                          "max_chars_total",
                                          MAX_CHARS_TOTAL)))
                              .build())
                      .build())
              .build();

      GenerateContentResponse response =
          client.models.generateContent(
              "MODEL_ID", "TEXT", config);

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

Node.js

התקנה

npm install @google/genai

מידע נוסף מופיע ב מאמרי העזרה בנושא SDK.

מגדירים משתני סביבה כדי להשתמש ב-Google Gen AI SDK עם Vertex AI: 

# 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

לפני שמריצים את הדוגמה, צריך להחליף את הערכים הבאים:

  • ‫MODEL_ID: המזהה של מודל נתמך לשימוש, כמו gemini-2.5-flash.
  • TEXT: פרומפט טקסטואלי לשליחה למודל.
  • ‫API_KEY: מפתח ה-API שלכם לחיפוש מקביל באינטרנט. אם אתם מנויים ב-Google Cloud Marketplace, אל תציינו את הפרמטר הזה. אם מציינים את שני הפרמטרים, מפתח ה-API מקבל עדיפות.
  • ‫EXCLUDE_DOMAINS: אופציונלי: רשימה של דומיינים שצריך להחריג ממקורות ההארקה. אם מציינים דומיינים, המערכת לא כוללת מקורות מהדומיינים האלה. הערכים הקבילים הם דומיינים (www.example.com) או סיומות של דומיינים שמתחילות בנקודה ( ‎.gov,‏ ‎.edu,‏ ‎.co.uk). אפשר לציין עד 200 דומיינים.
  • ‫INCLUDE_DOMAINS: אופציונלי: רשימה של דומיינים שרוצים לכלול במקורות המידע. אם מציינים דומיינים, המקורות מהדומיינים האלה נכללים. הערכים הקבילים הם דומיינים (www.example.com) או סיומות של דומיינים שמתחילות בנקודה ( ‎.gov,‏ ‎.edu,‏ ‎.co.uk). אפשר לציין עד 200 דומיינים.
  • ‫MAX_CHARS_PER_RESULT: אופציונלי: מספר התווים המקסימלי שייכלל בכל קטע מתוצאת החיפוש. אם לא מציינים ערך, ברירת המחדל היא 30000. הטווח המותר הוא [1000, 100000].
  • ‫MAX_CHARS_TOTAL: אופציונלי: המספר המקסימלי של התווים מכל קטעי המידע מתוצאות החיפוש. אם לא מציינים ערך, ברירת המחדל היא 100000. הטווח המותר הוא [1000, 1000000].
  • ‫MAX_RESULTS: אופציונלי: מספר תוצאות החיפוש המקסימלי שישמשו להארקה. אם לא מציינים ערך, ברירת המחדל היא 10. הטווח המותר הוא [1, 20].
  • ‫MODE: אופציונלי: מצב לשימוש בבקשה, basic או advanced. ערך ברירת המחדל הוא basic. כדאי להשתמש במצב advanced אם רוצים לקבל תוצאות חיפוש מקיפות יותר, אבל זמן הטעינה יהיה ארוך יותר.
  • ‫SEARCH_LOCATION: אופציונלי: קוד מדינה בתקן ISO 3166-1 alpha-2 לתוצאות חיפוש שמטורגטות לפי מיקום גיאוגרפי. לדוגמה: "us".

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

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: 'MODEL_ID',
  contents: 'TEXT',
  config: {
    tools: [
      {
        parallelAiSearch: {
          // Optional. Omit apiKey if you subscribed to Grounding with Parallel
          // Web Search on Google Cloud Marketplace.
          apiKey: 'API_KEY',
          // Optional. Set to true to use Zero Data Retention (ZDR) for
          // sensitive workloads. Requires a separate ZDR Marketplace
          // subscription; defaults to the standard subscription.
          enableZeroDataRetention: true,
          // Optional. Customize the search. Click a placeholder to enter a
          // value, or remove the line to accept the default.
          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,
            },
          },
        },
      },
    ],
  },
});

console.log(response.text);

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫LOCATION: האזור שבו הבקשה תעובד. כדי להשתמש בנקודת הקצה הגלובלית, צריך להחריג את המיקום משם נקודת הקצה ולהגדיר את מיקום המשאב כ-`global`.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫MODEL_ID: המזהה של מודל נתמך לשימוש, כמו gemini-2.5-flash.
  • TEXT: פרומפט טקסטואלי לשליחה למודל.
  • ‫API_KEY: מפתח ה-API שלכם לחיפוש מקביל באינטרנט. אם אתם מנויים ב-Google Cloud Marketplace, אל תציינו את הפרמטר הזה. אם מציינים את שני הפרמטרים, מפתח ה-API מקבל עדיפות.
  • ‫EXCLUDE_DOMAINS: אופציונלי: רשימה של דומיינים שצריך להחריג ממקורות ההארקה. אם מציינים דומיינים, המערכת לא כוללת מקורות מהדומיינים האלה. הערכים הקבילים הם דומיינים (www.example.com) או סיומות של דומיינים שמתחילות בנקודה ( ‎.gov,‏ ‎.edu,‏ ‎.co.uk). אפשר לציין עד 200 דומיינים.
  • ‫INCLUDE_DOMAINS: אופציונלי: רשימה של דומיינים שרוצים לכלול במקורות המידע. אם מציינים דומיינים, המקורות מהדומיינים האלה נכללים. הערכים הקבילים הם דומיינים (www.example.com) או סיומות של דומיינים שמתחילות בנקודה ( ‎.gov,‏ ‎.edu,‏ ‎.co.uk). אפשר לציין עד 200 דומיינים.
  • ‫MAX_CHARS_PER_RESULT: אופציונלי: מספר התווים המקסימלי שייכלל בכל קטע מתוצאת החיפוש. אם לא מציינים ערך, ברירת המחדל היא 30000. הטווח המותר הוא [1000, 100000].
  • ‫MAX_CHARS_TOTAL: אופציונלי: המספר המקסימלי של התווים מכל קטעי המידע מתוצאות החיפוש. אם לא מציינים ערך, ברירת המחדל היא 100000. הטווח המותר הוא [1000, 1000000].
  • ‫MAX_RESULTS: אופציונלי: מספר תוצאות החיפוש המקסימלי שישמשו להארקה. אם לא מציינים ערך, ברירת המחדל היא 10. הטווח המותר הוא [1, 20].
  • ‫MODE: אופציונלי: מצב לשימוש בבקשה, basic או advanced. ערך ברירת המחדל הוא basic. כדאי להשתמש במצב advanced אם רוצים לקבל תוצאות חיפוש מקיפות יותר, אבל זמן הטעינה יהיה ארוך יותר.
  • ‫SEARCH_LOCATION: אופציונלי: קוד מדינה בתקן ISO 3166-1 alpha-2 לתוצאות חיפוש שמטורגטות לפי מיקום גיאוגרפי. לדוגמה: "us".
  • ‫ENABLE_ZERO_DATA_RETENTION: אופציונלי: אפשר לעבור לגרסת ZDR של חיפוש מקביל באינטרנט כדי להפעיל שמירת נתונים למשך אפס ימים בעומסי עבודה רגישים. מגדירים את הערך true כדי להשתמש בהצעה של ZDR לבקשה. חובה להירשם למינוי שכולל את התכונות הספציפיות של ZDR כדי שהבקשות האלה יאושרו. אם לא מציינים גרסה, ברירת המחדל היא הגרסה הרגילה. גרסת ה-ZDR זמינה רק דרך Google Cloud Marketplace.

ה-method של ה-HTTP וכתובת ה-URL: 

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

תוכן בקשת JSON: 

{
  "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"
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

מכסה

מכסת ברירת המחדל היא 200 הנחיות לדקה. כדי לבקש להגדיל את מגבלות התעריפים, צריך לספק את תרחיש השימוש והדרישות לאיש הקשר המתאים:

  • אם נרשמתם למינוי ל-Grounding with Parallel Web Search ב-Google Cloud Marketplace: פנו לצוות של חשבון Google שלכם.

  • אם אתם מספקים מפתח API משלכם: פנו אל support@parallel.ai ואל צוות חשבון Google שלכם.

חיוב

השימוש ב-Grounding עם חיפוש מקביל באינטרנט כרוך בחיובים הבאים:

  • צריכת טוקנים ב-Gemini: יכול להיות שתחויבו על:

    • טוקנים של פרומפטים
    • טוקנים של חשיבה
    • טוקנים של פלט

    מידע נוסף מפורט במאמר בנושא תמחור.

  • הארקה של Gemini עם הנתונים שלכם: מידע נוסף זמין במאמר בנושא תמחור.

  • תמחור לשימוש ב-Parallel Web Search API:

    • אם נרשמתם ל-Grounding with Parallel Web Search ב-Google Cloud Marketplace, תוכלו לקרוא מידע נוסף בקטע Parallel pricing (תמחור של Parallel) ב-Google Cloud Marketplace.

    • אם אתם מספקים מפתח API משלכם, תוכלו לקרוא מידע נוסף במאמר בנושא אתר מקביל.