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

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

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

סקירה כללית

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

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

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

בחר מוצר

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

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

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

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

בקטע הזה מפורטים המודלים שתומכים ב-Web Grounding ל-Enterprise.

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

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

שימוש ב-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: האזור שבו הבקשה תעובד. כדי להשתמש בנקודת הקצה 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 מגיב להנחיה שמבוססת על חיפוש, שבה נשאלת שאלה על סוג של צמח טרופי.

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

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

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

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

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

דרישות להצגה

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

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

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

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

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

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

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

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

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