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

‫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.

כל דוגמה ל-SDK קוראת את הפרויקט והמיקום שלכם ממשתני הסביבה שמוצגים בכרטיסייה שלה. בקוד לדוגמה, מחליפים את MODEL_ID במזהה של מודל נתמך, כמו gemini-2.5-flash.

המסוף

כדי להשתמש בחיפוש מקביל באינטרנט כדי להוסיף מידע לתשובות של 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
 

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)

כדי להתאים אישית את החיפוש, מגדירים את השדה custom_configs של ToolParallelAiSearch. בשדה הזה אפשר להזין את אותם פרמטרים אופציונליים שמתוארים בכרטיסייה REST, כמו source_policy,‏ excerpts,‏ max_results ו-mode.

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
 

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());
    }
  }
}

כדי להתאים אישית את החיפוש, מגדירים את השדה customConfigs של ToolParallelAiSearch. בשדה הזה אפשר להזין את אותם פרמטרים אופציונליים שמתוארים בכרטיסייה REST, כמו source_policy,‏ excerpts,‏ max_results ו-mode.

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
 

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);

כדי להתאים אישית את החיפוש, מגדירים את השדה customConfigs של הכלי parallelAiSearch. בשדה הזה אפשר להזין את אותם פרמטרים אופציונליים שמתוארים בכרטיסייה REST, כמו source_policy,‏ excerpts,‏ max_results ו-mode.

REST

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

  • ‫LOCATION: האזור שבו הבקשה תעובד. כדי להשתמש בנקודת הקצה הגלובלית, צריך להחריג את המיקום משם נקודת הקצה ולהגדיר את מיקום המשאב כ-`global`.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫MODEL_ID: המזהה של המודל שרוצים להשתמש בו.
  • TEXT: פרומפט טקסטואלי לשליחה למודל.
  • ‫API_KEY: מפתח ה-API שלכם לחיפוש מקביל באינטרנט. אם מציינים מפתח API וגם נרשמים ל-Grounding with Parallel Web Search ב-Google Cloud Marketplace, מפתח ה-API מקבל עדיפות.
  • ‫ENABLE_ZERO_DATA_RETENTION: אופציונלי: עוברים לגרסת ZDR של חיפוש מקביל באינטרנט כדי להפעיל שמירת נתונים למשך אפס ימים בעומסי עבודה רגישים. מגדירים את הערך true כדי להשתמש בהצעה של ZDR לבקשה. כדי שהבקשות האלה יאושרו, חובה להיות מנויים למהדורת ZDR. אם לא מציינים גרסה, ברירת המחדל היא הגרסה הרגילה. גרסת ה-ZDR זמינה רק דרך Google Cloud Marketplace.
  • ‫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".

ה-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 משלכם, תוכלו לקרוא מידע נוסף במאמר בנושא אתר מקביל.