‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

‫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 היה מקס ורסטאפן מקבוצת Red Bull Racing. המירוץ התקיים ב-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 (גרסת Preview) כדי לשלב את התכונה בצורה חלקה בסביבת הענן הקיימת.
שימוש במפתח API קיים של Parallel.

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

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

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

הצגת תשובות מבוססות-קרקע של Gemini באמצעות Parallel

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

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

REST

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

‫LOCATION: האזור שבו תתבצע הבקשה. כדי להשתמש בנקודת הקצה הגלובלית, צריך להשמיט את המיקום משם נקודת הקצה ולהגדיר את המיקום של המשאב ל-global.
‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫MODEL_ID: המזהה של המודל שרוצים להשתמש בו.
‫TEXT: הנחייה טקסטואלית לשליחה למודל.
‫API_KEY: מפתח ה-API שלכם לחיפוש מקביל באינטרנט. אם מציינים מפתח API וגם נרשמים ל-Grounding with Parallel Web Search ב-Google Cloud Marketplace (גרסת Preview), מפתח ה-API מקבל עדיפות.
‫EXCLUDE_DOMAINS: אופציונלי: רשימת דומיינים להחרגה ממקורות ההארקה. אם מציינים דומיינים, המקורות מהדומיינים האלה מוחרגים. הערכים הקבילים הם דומיינים (www.example.com) או סיומות של דומיינים שמתחילות בנקודה (‎.gov, ‏‎.edu, ‏‎.co.uk). אפשר לציין עד 10 דומיינים.
‫INCLUDE_DOMAINS: אופציונלי: רשימה של דומיינים שרוצים לכלול במקורות המידע. אם מציינים דומיינים, המקורות מהדומיינים האלה נכללים. הערכים הקבילים הם דומיינים (www.example.com) או סיומות של דומיינים שמתחילות בנקודה ( ‎.gov, ‏‎.edu, ‏‎.co.uk). אפשר לציין עד 10 דומיינים.
‫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",
        "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"
}

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

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

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)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$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

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

תשובה

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

מכסה

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

אם נרשמתם ל-Grounding with Parallel Web Search ב-Google Cloud Marketplace ‏(Preview): צריך לפנות לצוות של חשבון Google.
אם סיפקתם מפתח API משלכם: פנו אל support@parallel.ai ואל צוות חשבון Google שלכם.

חיוב

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

צריכת טוקנים של Gemini: יכול להיות שתחויבו על:
- טוקנים של הנחיות
- טוקנים של חשיבה
- טוקנים של פלט
מידע נוסף מפורט בקטע תמחור.
הארקה של Gemini עם הנתונים שלכם: מידע נוסף זמין במאמר בנושא תמחור.
תמחור לשימוש ב-Parallel Web Search API:
- אם נרשמתם ל-Grounding with Parallel Web Search ב-Google Cloud Marketplace (גרסת Preview), תוכלו לקרוא מידע נוסף בקטע תמחור מקביל ב-Google Cloud Marketplace.
- אם אתם מספקים מפתח API משלכם, תוכלו לקרוא מידע נוסף במאמר בנושא אתר מקביל.