עיגון בנתונים מהאינטרנט ל-Enterprise

בדף הזה מוסבר על אמצעי הבקרה לתאימות של Web Grounding for Enterprise, ואיך להשתמש ב-Web Grounding for Enterprise API כדי ליצור תשובות שמבוססות על האינטרנט. התוכן שנוסף לאינדקס הוא קבוצת משנה של מה שזמין בחיפוש Google, והוא מתאים ללקוחות בתעשיות עם רגולציה מחמירה, כמו פיננסים, בריאות והמגזר הציבורי.

אם אתם לא צריכים את אמצעי הבקרה הנוספים, השתמשו בעיגון באמצעות חיפוש Google, כי הוא מאפשר גישה לאינדקס אינטרנט רחב ועדכני יותר.

סקירה כללית

התכונה 'עיגון בנתונים מהאינטרנט' ל-Enterprise משתמשת באינדקס מהאינטרנט כדי ליצור תשובות מעוגנות. השירות לא מתעד נתוני לקוחות ותומך ב-VPC Service Controls. מידע נוסף זמין במאמר אמצעי בקרה לאבטחה של AI גנרטיבי. מכיוון שנתוני הלקוחות לא נשמרים, אי אפשר להשתמש במפתחות הצפנה בניהול הלקוח (CMEK) וב-Access Transparency‏ (AxT).

עדכניות האינדקס ואיסוף התוכן

אינדקס האינטרנט של Web Grounding for Enterprise נבחר באופן אוטומטי כדי לענות על הצרכים הצפויים של לקוחות בתחום הבריאות, הפיננסים והמגזר הציבורי. לוחות הזמנים הספציפיים של העדכונים יכולים להשתנות, אבל תוכן שמשתנה במהירות מתעדכן כל 6 שעות, וכל האינדקס מתעדכן כל 24 שעות.

בחר מוצר

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

  • עיגון באמצעות חיפוש Google: זו האפשרות המומלצת ללקוחות שרוצים שהתשובות המעוגנות יהיו באיכות הגבוהה ביותר ועדכניות ככל האפשר. עדכניות מתייחסת למידת העדכניות של המידע מהאינטרנט שמשמש ליצירת התשובה. הוא חיוני לתרחישי שימוש שבהם חשוב לגשת למידע העדכני והמקיף ביותר מהאינטרנט. במסגרת התכונה "עיגון באמצעות חיפוש Google", נשמרים יומני אמינות למשך עד 3 ימים בהתאם לתנאים הספציפיים לשירות. ‫Google לא מאמן את המודלים על נתוני לקוחות שעובדו באמצעות התכונה "עיגון באמצעות חיפוש Google".

  • עיגון ב-Web לארגונים: הפתרון הזה מיועד במיוחד ללקוחות ארגוניים שיש להם דרישות תאימות מחמירות, כולל "ללא רישום ביומן של נתוני לקוחות". התכונה "ביסוס ב-Web לארגונים" מתאימה במיוחד לארגונים בתחומים עם רגולציה מחמירה, שצריכים אמצעי בקרה נוספים כדי לעמוד בדרישות. הכלי Web Grounding for Enterprise לא שומר נתוני לקוחות.

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

כאן מפורטים המודלים שתומכים ב-Web Grounding for Enterprise.

לחצו כדי להרחיב את רשימת המודלים הנתמכים

‫Gemini 3 Pro ו-Gemini 3 Pro Image מוגבלים ל-5,000 שאילתות חיפוש ביום.

שימוש ב-API

בקטע הזה יש בקשות לדוגמה לשימוש ב-Generative AI API Gemini 2 ב-Gemini Enterprise Agent Platform כדי ליצור תשובות מבוססות-קרקע באמצעות Gemini. כדי להשתמש ב-API, צריך להגדיר את השדות הבאים:

  • ‫Contents.parts.text: שאילתת הטקסט שהמשתמשים רוצים לשלוח ל-API.
  • ‫tools.enterpriseWebSearch: כשהכלי הזה זמין, Gemini יכול להשתמש ב-Web Grounding for Enterprise.

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.types import (
    EnterpriseWebSearch,
    GenerateContentConfig,
    HttpOptions,
    Tool,
)

client = genai.Client(http_options=HttpOptions(api_version="v1"))

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="When is the next total solar eclipse in the United States?",
    config=GenerateContentConfig(
        tools=[
            # Use Enterprise Web Search Tool
            Tool(enterprise_web_search=EnterpriseWebSearch())
        ],
    ),
)

print(response.text)
# Example response:
# 'The next total solar eclipse in the United States will occur on ...'

REST

מחליפים את המשתנים הבאים בערכים:

  • ‫PROJECT_NUMBER: מספר הפרויקט.
  • ‫LOCATION: האזור שבו הבקשה תעובד. כדי להשתמש בנקודת הקצה (endpoint) global, צריך להחריג את המיקום משם נקודת הקצה ולהגדיר את מיקום המשאב ל-global.
  • ‫PROMPT: ההנחיה שלכם.
  curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -H "x-server-timeout: 60" https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/publishers/google/models/gemini-2.5-flash:generateContent -d '
  {
    "contents": [{
      "role": "user",
      "parts": [{
        "text": PROMPT
      }]
    }],
    "tools": [{
      "enterpriseWebSearch": {
      }
    }]
  }
  '

שימוש בהצעות לחיפוש ב-Google

כשאתם משתמשים ב-Web Grounding for Enterprise ומקבלים הצעות לחיפוש בתשובה, אתם צריכים להציג את ההצעות לחיפוש בסביבת הייצור ובאפליקציות שלכם.

באופן ספציפי, אתם צריכים להציג את שאילתות החיפוש שכלולות במטא-נתונים של התשובה המבוססת. התשובה כוללת:

  • ‫"content": התשובה שנוצרה על ידי ה-LLM.
  • ‫"webSearchQueries": השאילתות שישמשו להצעות חיפוש.

לדוגמה, בקטע הקוד הבא, Gemini מגיב להנחיה שמבוססת על חיפוש Google, ששואלת על סוג של צמח טרופי.

"predictions": [
  {
    "content": "Monstera is a type of vine that thrives in bright indirect light…",
    "groundingMetadata": {
      "webSearchQueries": ["What's a monstera?"],
    }
  }
]

אתם יכולים להשתמש בפלט הזה ולהציג אותו באמצעות הצעות לחיפוש.

הדרישות לגבי הצעות לחיפוש

אלה הדרישות להצגת הצעות:

דרישה תיאור
מה מומלץ לעשות
  • בהתאם לדרישות התצוגה, ההצעה לחיפוש מוצגת בדיוק כפי שהיא, ללא שינויים.
  • כשאתם לוחצים על ההצעה לחיפוש, אתם מועברים ישירות לדף תוצאות החיפוש (SRP).
מה לא מומלץ לעשות
  • צריך לכלול את כל המסכים או השלבים הנוספים בין הלחיצה של המשתמש לבין הצגת דף תוצאות החיפוש.
  • להציג תוצאות חיפוש או הצעות אחרות לצד ההצעה לחיפוש או התשובה המשויכת של ה-LLM המבוסס על מקורות מידע.

דרישות להצגה

אלה הדרישות לגבי התצוגה:

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

  • בכל פעם שמוצגת תשובה מעוגנת, הצעת החיפוש המתאימה צריכה להישאר גלויה.
  • בנוגע למיתוג, אתם צריכים לפעול בהתאם להנחיות של Google לשימוש של צד שלישי בתכונות המותג של Google, שמפורטות במרכז המשאבים של המותג.
  • כשמשתמשים ב-Web Grounding for Enterprise, מוצגים צ'יפים של הצעות לחיפוש. השדה שמכיל את ההצעות הקשורות צריך להיות באותו רוחב כמו התשובה המעוגנת בנתונים מה-LLM.

התנהגות בלחיצה

כשמשתמש לוחץ על הצ'יפ, הוא מועבר ישירות לדף תוצאות חיפוש (SRP) של מונח החיפוש שמוצג בצ'יפ. דף תוצאות החיפוש יכול להיפתח בדפדפן בתוך האפליקציה או באפליקציית דפדפן נפרדת. חשוב לא למזער, להסיר או להסתיר את התצוגה של דף תוצאות החיפוש בשום צורה. הדגם המונפש הבא ממחיש את האינטראקציה של לחיצה כדי לעבור לדף תוצאות החיפוש.

דוגמה באפליקציה או במחשב

קוד להטמעת הצעה לחיפוש

כשמשתמשים ב-API כדי לבסס תשובה על חיפוש, התשובה של המודל מספקת עיצוב HTML ו-CSS תואם בשדה renderedContent, שאתם מטמיעים כדי להציג הצעות לחיפוש באפליקציה.

המאמרים הבאים