ניהול הגדרות של יכולת התבוננות

במאמר הזה מוסבר איך להגדיר את הגדרות הניטור של אפליקציית Gemini Enterprise או של סוכנים ספציפיים באמצעות מסוף Google Cloud או API בארכיטקטורת REST.

הלוגיקה של ההפעלה תלויה בסוג הסוכן:

• סוכן Assistant הראשי: משתמשים במתג ברמת האפליקציה (ברמת המנוע) בהגדרות.
• סוכנים אחרים: (בשלב הזה, רק סוכנים שנוצרו על ידי עובדים ב-Workflow Builder וסוכני Deep Research): משתמשים במתג ברמת הסוכן בהגדרות של הסוכן הספציפי.

אחרי שתפעילו את ההגדרות, תוכלו לראות את הנתונים הבאים מהאינטראקציות שלכם עם העוזר הדיגיטלי או עם הסוכנים באתר Gemini Enterprise:

• צפייה במדדים ב-Metrics Explorer.
• צפייה בעקבות ובטווחים ב-Trace Explorer.

מושגים מרכזיים

בקטע הזה נסביר על מושגי מפתח שקשורים לניטור ב-Gemini Enterprise.

קונספט	תיאור
מעקב	trace הוא אוסף של span שמייצג בקשה או טרנזקציה יחידה, בזמן שהיא עוברת דרך שירותים ורכיבים שונים. לדוגמה, מעקב מייצג את כל מחזור החיים של בקשה. זה כולל משתמש ששואל שאלה את Gemini Enterprise Assistant, את התשובה של Gemini Enterprise Assistant וכל פעולה שמתבצעת בעקבות התשובה, כמו שליחת אימייל.
Span	טווח הוא יחידת עבודה אחת עם תזמון בתוך מעקב. הוא מייצג פעולה ספציפית, כמו בקשה להפעלת פונקציה, בקשת API או שאילתת מסד נתונים. כל span כולל פרטים כמו זמני ההתחלה והסיום, מזהה ייחודי והקשר שלו ל-spans אחרים. הקשרים האלה יוצרים ביחד עקבות.
יומני Span	יומני Span הם הודעות או אירועים בפריסה גמישה עם חותמת זמן שמשויכים ל-span ספציפי. הם מספקים מידע מפורט לפי הקשר על הביצוע של span, שעוזר למשתמשים לנפות באגים בבעיות ולהבין את תהליך הבקשה.
מדדים	מדדים הם מדידות מספריות שהמערכות אוספות לאורך זמן. המדידות האלה מייצגות את הביצועים, את ניצול המשאבים או את ההתנהגות של המערכת. מהנדסים משתמשים במדדים כדי לעקוב אחרי תקינות המערכת, לזהות מגמות ולהפעיל התראות.
יומני ביקורת	יומני ביקורת הם רשומות של פעילויות ניהול וגישה במשאבי Google Cloud . הם מספקים מידע מפורט על המשתמש שביצע את הפעולה, מתי היא בוצעה ומאיפה. היומנים האלה חיוניים לביקורת אבטחה, לתאימות ולהבנת אופן השימוש במשאבים.
יומני שגיאות של מחברי Gemini Enterprise	ב-Gemini Enterprise connector error logs מתועדות שגיאות וכשלים שמתרחשים כשמשלבים את Gemini Enterprise עם מקורות נתונים של צד שלישי, כמו Jira ו-Microsoft OneDrive. היומנים האלה כוללים בעיות בחיבור, בעיות בהמרת נתונים ושגיאות API.

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

חשוב לוודא שיש לכם את הפריטים הבאים:

• התפקיד אדמין ב-Gemini Enterprise.

• אפליקציית אינטרנט קיימת של Gemini Enterprise. למידע על יצירת אפליקציה חדשה, ראו יצירת אפליקציה.

הפעלה של הגדרות ה-Observability

כדי להפעיל את התכונה 'ניראות (observability)' באפליקציית Gemini Enterprise או בסוכנים ספציפיים, אפשר להשתמש במסוף Google Cloud או ב-API בארכיטקטורת REST.

המסוף

כדי להפעיל את הגדרות יכולת הצפייה באמצעות מסוף Google Cloud :

1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise.

   ‫Gemini Enterprise

2. לוחצים על שם האפליקציה שרוצים להגדיר.

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

   • סוכן Core Assistant: לוחצים על Configurations ואז על הכרטיסייה Observability.
   • סוכנים אחרים (סוכנים שנוצרו על ידי עובדים ב-Workflow Builder וסוכני Deep Research): לוחצים על סוכנים, לוחצים על שם הסוכן שרוצים להגדיר ואז לוחצים על הכרטיסייה הגדרה.

4. אתם יכולים להפעיל או להשבית את ההגדרות הבאות:

   הגדרת הניראות (observability)	תיאור
   הפעלת שדרוג של מעקבים ויומנים של OpenTelemetry	כשמפעילים את האפשרות הזו, אפשר לראות ב-Cloud Logging את העקבות, המרווחים, יומני המרווחים והמדדים שמשויכים ליומנים.
   הפעלת הרישום ביומן של קלט ההנחיות ופלט התשובות	כשהאפשרות הזו מופעלת, Cloud Logging מתעד את התוכן המלא של הפרומפטים של המשתמשים והתשובות. זה כולל מידע אישי רגיש או פרטים אישיים מזהים (PII). כדי להפעיל את ההגדרה הזו, צריך קודם להפעיל את ההגדרה הפעלת אינסטרומנטציה של מעקבים ויומנים של OpenTelemetry. שימו לב: הפעלת ההגדרה הזו גורמת לרישום ביומן של נתונים רגישים, כולל פרטים אישיים מזהים (PII). הגבילו את הגישה ליומנים רק לעובדים מורשים.

REST

כדי להגדיר הגדרות של ניראות (observability) באמצעות API בארכיטקטורת REST, אפשר לעיין בקטעים הבאים:

• קביעת הגדרות התצפיתיות של Core Assistant (ברמת האפליקציה)
• קביעת הגדרות ניראות של נתונים לסוכן ספציפי

הגדרת ניראות (observability) ל-Core Assistant (ברמת האפליקציה)

כדי להגדיר את הגדרות יכולת הצפייה באמצעות ה-API בארכיטקטורת REST ברמת האפליקציה (שחלות על סוכן Core Assistant), אפשר לעיין בקטעים הבאים:

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

הפעלת יכולת התצפית כשיוצרים אפליקציה

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

מונח חשוב: ב-Gemini Enterprise, המונח אפליקציה יכול לשמש גם בתור המונח מנוע בהקשר של ממשקי API. מנוע Gemini Enterprise הוא מנוע חיפוש כללי שבו השדה app_type מוגדר לערך APP_TYPE_INTRANET.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines?engineId=APP_ID" \
-d '{
  "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID",
  "displayName": "APP_DISPLAY_NAME",
  "solutionType": "SOLUTION_TYPE_SEARCH",
  "searchEngineConfig": {
    "searchTier": "SEARCH_TIER_ENTERPRISE",
    "searchAddOns": ["SEARCH_ADD_ON_LLM"],
    "requiredSubscriptionTier": "SUBSCRIPTION_TIER_SEARCH_AND_ASSISTANT"
  },
  "industryVertical": "GENERIC",
  "appType": "APP_TYPE_INTRANET",
  "observabilityConfig": {
    "observabilityEnabled": true,
    "sensitiveLoggingEnabled": true
  }
}'

מחליפים את מה שכתוב בשדות הבאים:

• ‫ENDPOINT_LOCATION: האזור הגיאוגרפי של בקשת ה-API. מציינים אחד מהערכים הבאים:
  • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
  • ‫eu למספר אזורים באיחוד האירופי
  • ‫global למיקום הגלובלי
  מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.
• ‫PROJECT_ID: מזהה הפרויקט.
• ‫LOCATION: האזור הגיאוגרפי של מאגר הנתונים: global,‏ us או eu
• ‫APP_ID: המזהה של האפליקציה שרוצים ליצור.
• ‫APP_DISPLAY_NAME: השם המוצג של האפליקציה שרוצים ליצור.

הפעלת יכולת הצפייה באפליקציה קיימת

כדי להפעיל את יכולת הצפייה באפליקציה קיימת, מריצים את הפקודה הבאה:

מונח חשוב: ב-Gemini Enterprise, המונח אפליקציה יכול לשמש גם בתור המונח מנוע בהקשר של ממשקי API. מנוע Gemini Enterprise הוא מנוע חיפוש כללי שבו השדה app_type מוגדר לערך APP_TYPE_INTRANET.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID?updateMask=observabilityConfig" \
-d '{
  "observabilityConfig": {
    "observabilityEnabled": true,
    "sensitiveLoggingEnabled": true
  }
}'

מחליפים את מה שכתוב בשדות הבאים:

• ‫ENDPOINT_LOCATION: האזור הגיאוגרפי של בקשת ה-API. מציינים אחד מהערכים הבאים:
  • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
  • ‫eu למספר אזורים באיחוד האירופי
  • ‫global למיקום הגלובלי
  מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.
• ‫PROJECT_ID: מזהה הפרויקט.
• ‫LOCATION: האזור הגיאוגרפי של מאגר הנתונים: global,‏ us או eu
• ‫APP_ID: מזהה האפליקציה.

קביעת הגדרות הניראות (observability) של נציג ספציפי

כדי להפעיל את הניטור של סוכן ספציפי (כמו סוכן של Workflow Builder או סוכן Deep Research) באמצעות ה-API בארכיטקטורת REST, מריצים את הפקודה הבאה כדי לעדכן את ה-observabilityConfig של הסוכן:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents/AGENT_ID?updateMask=observabilityConfig" \
-d '{
  "observabilityConfig": {
    "observabilityEnabled": true,
    "sensitiveLoggingEnabled": true
  }
}'

מחליפים את מה שכתוב בשדות הבאים:

• ‫ENDPOINT_LOCATION: האזור הגיאוגרפי של בקשת ה-API. מציינים אחד מהערכים הבאים:
  • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
  • ‫eu למספר אזורים באיחוד האירופי
  • ‫global למיקום הגלובלי
  מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.
• ‫PROJECT_ID: מזהה הפרויקט.
• ‫LOCATION: האזור הגיאוגרפי של מאגר הנתונים: global,‏ us או eu
• ‫APP_ID: מזהה האפליקציה.
• ‫AGENT_ID: המזהה של הנציג שרוצים להגדיר

השבתת הגדרות ה-Observability

כדי להשבית את הגדרות הניטור של אפליקציית Gemini Enterprise או של סוכנים ספציפיים, אתם יכולים להשתמש במסוף Google Cloud או ב-API בארכיטקטורת REST.

המסוף

כדי להשבית את הגדרות הניטור באמצעות מסוף Google Cloud :

1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

   Gemini Enterprise

2. לוחצים על שם האפליקציה שרוצים להשבית את הגדרות הניטור שלה.

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

   • סוכן Core Assistant: לוחצים על Configurations ואז על הכרטיסייה Observability.
   • סוכנים אחרים (כולל סוכנים שנוצרו על ידי עובדים באמצעות Workflow Builder ו-Deep Research): לוחצים על סוכנים, לוחצים על השם של הסוכן שרוצים להגדיר ואז לוחצים על הכרטיסייה הגדרה.

4. אתם יכולים להשבית את ההגדרות הבאות:

   הגדרת הניראות (observability)	תיאור
   הפעלת אינסטרומנטציה של מעקבים ויומנים ב-OpenTelemetry	כשההגדרה הזו מושבתת, המערכת מפסיקה לאסוף נתוני מעקב, נתוני span, יומני span ומדדים. היא גם משביתה את ההגדרה הפעלת רישום ביומן של קלט ההנחיות ופלט התשובות, כלומר לא נשלחים יומנים ל-Cloud Logging.
   הפעלת הרישום ביומן של קלט ההנחיות ופלט התשובות	כשהאפשרות מושבתת, Cloud Logging לא מתעד את הקלט של ההנחיות ואת הפלט של התשובות.

REST

כדי להשבית את הגדרות הניטור באמצעות ה-API ל-REST, עיינו בקטעים הבאים:

• השבתת הניראות ברמת האפליקציה (Core Assistant)
• השבתת יכולת הצפייה בסוכן ספציפי

השבתת יכולת הצפייה ברמת האפליקציה (העוזר הדיגיטלי Core)

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

מונח חשוב: ב-Gemini Enterprise, המונח אפליקציה יכול לשמש גם בתור המונח מנוע בהקשר של ממשקי API. מנוע Gemini Enterprise הוא מנוע חיפוש כללי שבו השדה app_type מוגדר לערך APP_TYPE_INTRANET.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID?updateMask=observabilityConfig" \
-d '{
  "observabilityConfig": {
    "observabilityEnabled": false,
    "sensitiveLoggingEnabled": false
  }
}'

מחליפים את מה שכתוב בשדות הבאים:

• ‫ENDPOINT_LOCATION: האזור הגיאוגרפי של בקשת ה-API. מציינים אחד מהערכים הבאים:
  • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
  • ‫eu למספר אזורים באיחוד האירופי
  • ‫global למיקום הגלובלי
  מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.
• ‫PROJECT_ID: מזהה הפרויקט.
• ‫LOCATION: האזור הגיאוגרפי של מאגר הנתונים: global,‏ us או eu
• ‫APP_ID: מזהה האפליקציה.

השבתת הניטור של סוכן ספציפי

כדי להשבית את הניטור של סוכן ספציפי (כמו סוכן של Workflow Builder או סוכן של Deep Research), מריצים את הפקודה הבאה:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents/AGENT_ID?updateMask=observabilityConfig" \
-d '{
  "observabilityConfig": {
    "observabilityEnabled": false,
    "sensitiveLoggingEnabled": false
  }
}'

מחליפים את מה שכתוב בשדות הבאים:

• ‫ENDPOINT_LOCATION: האזור הגיאוגרפי של בקשת ה-API. מציינים אחד מהערכים הבאים:
  • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
  • ‫eu למספר אזורים באיחוד האירופי
  • ‫global למיקום הגלובלי
  מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.
• ‫PROJECT_ID: מזהה הפרויקט.
• ‫LOCATION: האזור הגיאוגרפי של מאגר הנתונים: global,‏ us או eu
• ‫APP_ID: מזהה האפליקציה.
• ‫AGENT_ID: המזהה של הנציג שרוצים להגדיר

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

• כדי ללמוד עוד על איך לגשת ליומני ביקורת של Gemini Enterprise, ראו איך ניגשים ליומני ביקורת.
• מידע נוסף על גישה לנתוני מעקב וטווח של Gemini Enterprise זמין במאמר גישה למעקבים ולטווחים בכלי Trace Explorer.
• כדי ללמוד עוד על איך לגשת למדדים של Gemini Enterprise, ראו איך ניגשים למדדים ב-Metrics Explorer.