ליצור סוכני נתונים ולנהל צ'אט עם הנתונים

מפתחים יכולים להשתמש ב-Conversational Analytics API, שאפשר לגשת אליו דרך geminidataanalytics.googleapis.com או נקודות קצה אזוריות, כדי ליצור ממשק צ'אט מבוסס בינה מלאכותית (AI) או סוכן נתונים. ה-API משתמש בשפה טבעית כדי לענות על שאלות לגבי נתונים מובנים ב-BigQuery, ב-Looker וב-Data Studio, וגם תומך בשליחת שאילתות לנתונים מ-AlloyDB, מ-GoogleSQL for Spanner, מ-Cloud SQL ומ-Cloud SQL ל-PostgreSQL באמצעות השיטה QueryData.

באמצעות Conversational Analytics API, אתם מספקים לסוכן הנתונים שלכם פרטי עסק ונתונים (הקשר), וגם גישה לכלים כמו SQL,‏ Python וספריות להמחשה חזותית. התשובות של הנציג מוצגות למשתמש, ואפליקציית הלקוח יכולה לרשום אותן ביומן. כך נוצרת חוויית צ'אט חלקה עם נתונים שניתן לבדוק.

איך Gemini for Google Cloud ‎ משתמש בנתונים שלכם, ובאילו מקרים.

תחילת העבודה עם Conversational Analytics API

כדי להתחיל להשתמש ב-Conversational Analytics API, כדאי לעיין במסמכים הבאים כדי להבין את הגישות הזמינות לשילוב ואת המושגים המרכזיים:

  • ארכיטקטורה ומושגים מרכזיים: הסבר על האופן שבו סוכני נתונים מעבדים בקשות, זרימות עבודה ליוצרי סוכנים ולמשתמשים, מצבי שיחה ותפקידים נדרשים של ניהול זהויות והרשאות גישה (IAM).
  • דפוסי שילוב של סוכני נתונים: השוואה בין גישות ארכיטקטוניות כדי לקבוע מהי שיטת החיבור הטובה ביותר לאפליקציה שלכם.
  • ניהול מצב: מידע על מצבי שיחה עם שמירת מצב ושיחות בלי שמירת מצב, על האופן שבו ה-API מנהל את היסטוריית השיחות ועל היקפי מצב הסשן של ADK.
  • אבטחה, פרטיות, סיכון ותאימות: הסבר על אפשרויות האבטחה והתאימות של Conversational Analytics API.
  • מיקומי Conversational Analytics API: סקירה כללית של נקודות הקצה האזוריות או הרב-אזוריות של ה-API שמאפשרות לכם לשלוט במיקום הגיאוגרפי של המשאבים, ההגדרות והנתונים של הסוכן.

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

הגדרה ותנאים מוקדמים

לפני שמשתמשים ב-API או בדוגמאות, צריך לבצע את השלבים הבאים:

  • הפעלת Conversational Analytics API: מאמר שמתאר את הדרישות המוקדמות להפעלת Conversational Analytics API.
  • בקרת גישה באמצעות IAM: במאמר הזה מוסבר איך משתמשים בניהול זהויות והרשאות גישה כדי לשתף ולנהל את הגישה לסוכני נתונים.
  • אימות וחיבור למקור נתונים: במאמר הזה מוסבר איך לבצע אימות ל-API ואיך להגדיר חיבורים לנתונים שלכם ב-BigQuery, ב-Lakehouse, ב-Looker, ב-Data Studio ובמסדי נתונים בענן (AlloyDB,‏ GoogleSQL for Spanner,‏ Cloud SQL ו-Cloud SQL ל-PostgreSQL).
  • מפתחות הצפנה בניהול הלקוח (CMEK): במאמר הזה מוסבר איך להשתמש במפתחות הצפנה משלכם ב-Cloud Key Management Service כדי להגן על סוכני נתונים ועל שיחות שמשתמשים במקורות נתונים של Looker.
  • אילוצים על מדיניות הארגון: במאמר הזה מוסבר איך להשתמש באילוצים מוגדרים מראש על מדיניות הארגון כדי לשלוט במשאבים ברמת הארגון, התיקייה או הפרויקט.

איך יוצרים סוכן נתונים ואיך מתקשרים איתו

אחרי שמבצעים את השלבים הקודמים, משתמשים ב-Conversational Analytics API כדי ליצור סוכן נתונים ולקיים איתו אינטראקציה. לשם כך, פועלים לפי השלבים הבאים:

שיטות מומלצות

כדי ללמוד על שיטות מומלצות לשימוש ב-Conversational Analytics API, מומלץ לעיין במדריכים הבאים:

הפניית API וספריות לקוח

פעולות מרכזיות ב-API

ה-API מספק את נקודות הקצה הבאות לניהול סוכני נתונים ושיחות. כשיוצרים את הנתיבים האלה (או את שמות המשאבים התואמים ב-SDK), מחליפים את התווים הכלליים (*) במזהה הפרויקט, במזהה המיקום (למשל global או us) ובמזהה המשאב (למשל מזהה הסוכן או מזהה השיחה), לפי הצורך.

פעולה שיטת HTTP נקודת קצה (endpoint) תיאור
יצירת סוכן POST /v1/projects/*/locations/*/dataAgents יצירת סוכן נתונים חדש.
יצירת סוכן באופן סינכרוני POST /v1/projects/*/locations/*/dataAgents:createSync יצירה סינכרונית של סוכן נתונים חדש.
קבלת נציג GET /v1/projects/*/locations/*/dataAgents/* הסוכן מאחזר את הפרטים של סוכן נתונים ספציפי.
קבלת מדיניות ניהול זהויות והרשאות גישה POST /v1/projects/*/locations/*/dataAgents/*:getIamPolicy מקבל את ההרשאות לניהול הזהויות והרשאות הגישה שמוקצות לכל משתמש עבור סוכן נתונים ספציפי. משתמשים עם תפקיד בעלים של סוכן נתונים יכולים להתקשר לנקודת הקצה הזו כדי להציג את מדיניות ניהול הזהויות והגישה של סוכן הנתונים לפני השימוש בנקודת הקצה setIAMpolicy כדי לשתף סוכן נתונים עם משתמשים אחרים.
הגדרת מדיניות לניהול זהויות והרשאות גישה POST /v1/projects/*/locations/*/dataAgents/*:setIamPolicy הגדרת מדיניות ניהול הזהויות והרשאות הגישה (IAM) לסוכן נתונים ספציפי. משתמשים עם הרשאת בעלים של סוכן נתונים צריכים להתקשר לנקודת הקצה הזו כדי לשתף סוכן נתונים עם משתמשים אחרים, וכך לעדכן את הרשאות ניהול הזהויות והגישה של המשתמשים האלה.
עדכון סוכן PATCH /v1/projects/*/locations/*/dataAgents/* שינוי של סוכן נתונים קיים.
עדכון סוכן באופן סינכרוני PATCH /v1/projects/*/locations/*/dataAgents/*:updateSync שינוי של סוכן נתונים קיים באופן סינכרוני.
הצגת רשימה של סוכנים GET /v1/projects/*/locations/*/dataAgents הצגת רשימה של סוכני נתונים שזמינים בפרויקט.
הצגת רשימה של נציגי תמיכה שאפשר לגשת אליהם GET /v1/projects/*/locations/*/dataAgents:listaccessible הצגת רשימה של סוכני נתונים שאפשר לגשת אליהם בפרויקט. סוכן נתונים נחשב לנגיש אם למשתמש שמפעיל את ה-API הזה יש את ההרשאה get בסוכן. אפשר להשתמש בשדה creator_filter כדי לנהל את הסוכנים שהשיטה הזו מחזירה:
  • ‫NONE (ברירת מחדל): מחזירה את כל סוכני הנתונים שהמשתמש יכול לגשת אליהם, בלי קשר למי שיצר את הסוכנים.
  • ‫CREATOR_ONLY: מחזירה רק את סוכני הנתונים שהמשתמש יכול לגשת אליהם ושנוצרו על ידי המשתמש.
  • ‫NOT_CREATOR_ONLY: מחזירה רק את סוכני הנתונים שהמשתמש יכול לגשת אליהם ושנוצרו על ידי אחרים.
מחיקת סוכן DELETE /v1/projects/*/locations/*/dataAgents/* הסרת סוכן נתונים.
מחיקה סינכרונית של סוכן DELETE /v1/projects/*/locations/*/dataAgents/*:deleteSync הסרה של סוכן נתונים באופן סינכרוני.
יצירת שיחה POST /v1/projects/*/locations/*/conversations מתחילים שיחה חדשה ומתמשכת.
שיחה באמצעות חומרי עזר POST /v1/projects/*/locations/*:chat המשך שיחה עם שמירת מצב על ידי שליחת הודעה בצ'אט שמפנה לשיחה קיימת ולהקשר של הנציג שמשויך אליה. בשיחות רב-שלביות, Google Cloud מאחסן ומנהל את היסטוריית השיחות.
צ'אט באמצעות הפניה לסוכן נתונים POST /v1/projects/*/locations/*:chat שליחת הודעה בצ'אט ללא שמירת מצב, עם הפניה לסוכן נתונים שנשמר כדי לספק הקשר. בשיחות רב-שלביות, האפליקציה צריכה לנהל את היסטוריית השיחות ולספק אותה בכל בקשה.
שיחה באמצעות הקשר מוטבע POST /v1/projects/*/locations/*:chat שליחת הודעת צ'אט בלי שמירת מצב על ידי ציון כל ההקשר ישירות בבקשה, בלי להשתמש בסוכן נתונים שמור. בשיחות רב-שלביות, האפליקציה צריכה לנהל את היסטוריית השיחות ולספק אותה בכל בקשה.
קבלת שיחה GET /v1/projects/*/locations/*/conversations/* מאחזר את הפרטים של שיחה ספציפית.
רשימת השיחות GET /v1/projects/*/locations/*/conversations הצגת רשימת השיחות בפרויקט ספציפי.
איך רואים את רשימת ההודעות בשיחה GET /v1/projects/*/locations/*/conversations/*/messages רשימת ההודעות בשיחה ספציפית.
למחוק שיחה DELETE /v1/projects/*/locations/*/conversations/* מחיקת שיחה ספציפית. כדי להתקשר לנקודת הקצה הזו, צריך להיות לכם תפקיד של אדמין בנושא בממשק לניהול זהויות והרשאות גישה (IAM), או לפחות הרשאת cloudaicompanion.topics.delete בממשק לניהול זהויות והרשאות גישה (IAM).
שאילתת נתונים POST /v1beta/projects/*/locations/*/conversations:queryData שליפת נתונים ממסדי נתונים של AlloyDB,‏ GoogleSQL ל-Spanner,‏ Cloud SQL ו-Cloud SQL ל-PostgreSQL באמצעות שפה טבעית.

תמיכה ומשוב

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

  • כדי לקבל תמיכה ב-Conversational Analytics API עם BigQuery, ברשימה Select a product (בחירת מוצר), בוחרים באפשרות BigQuery, ובשדה Feature (תכונה), בוחרים באפשרות AI and Machine Learning::Conversational Analytics API in BigQuery (AI ולמידת מכונה::Conversational Analytics API ב-BigQuery).
  • כדי לקבל תמיכה ב-Conversational Analytics API עם Looker, ברשימה Select a product (בחירת מוצר), בוחרים באפשרות Looker (original) (Looker (מקורי)), ובשדה Feature (תכונה), בוחרים באפשרות Gemini in Looker::Conversational Analytics API (Gemini ב-Looker::Conversational Analytics API).

אם יש לכם משוב כללי או שאלות לגבי Conversational Analytics API, אתם יכולים לשלוח אימייל לכתובת conversational-analytics-api-feedback@google.com. אנחנו לא מתחייבים להשיב לאימיילים, אבל אנחנו קוראים אותם ומתייחסים למשוב הזה בתכנון של תוכניות הפיתוח.

אפשר גם להגיש בקשה להוספת תכונה לפונקציונליות החדשה של Conversational Analytics API.