במאמר הזה מוסבר איך ליצור, לערוך ולמחוק שיחות ב-Cloud SQL ל-MySQL. שיחות הן צ'אטים שנשמרים עם סוכן נתונים.
אתם יכולים לשאול את סוכני הנתונים שאלות מורכבות שכוללות מונחים נפוצים – לדוגמה, 'מכירות' או 'הכי פופולרי' – בלי לציין שמות של שדות בטבלה או להגדיר תנאים לסינון הנתונים. התשובה בצ'אט מספקת את התשובה לשאלה שלכם כטקסט וקוד, ויוצרת תרשימים כשצריך. התגובה כוללת את ההסבר לתוצאות.
אתם יכולים ליצור שיחה עם סוכן נתונים. כשיוצרים שיחה ישירה, Conversational Analytics API מפרש את השאלה בלי ההקשר והוראות העיבוד שסוכן הנתונים מספק.
לפני שמתחילים
-
מפעילים את Cloud SQL, את Data Analytics API עם Gemini ואת Gemini for Google Cloud APIs.
תפקידים שנדרשים להפעלת ממשקי API
כדי להפעיל ממשקי API, צריך את תפקיד ה-IAM 'אדמין של Service Usage' (
roles/serviceusage.serviceUsageAdmin), שכולל את ההרשאהserviceusage.services.enable. איך מקצים תפקידים
התפקידים הנדרשים
כדי לעבוד עם סוכני נתונים, אתם צריכים את אחד התפקידים הבאים ב-IAM של Conversational Analytics API:
- אפשר להריץ שאילתות על נתונים ממקורות נתונים נתמכים של מסדי נתונים באמצעות השיטה
QueryData: משתמש בשאילתת נתונים ב-Gemini Data Analytics (roles/geminidataanalytics.queryDataUser) ברמת הפרויקט. - יצירה, עריכה, שיתוף ומחיקה של כל סוכני הנתונים בפרויקט: Gemini
בעלים של סוכן נתונים של ניתוח נתונים
(
roles/geminidataanalytics.dataAgentOwner) ברמת הפרויקט. - יצירת סוכני נתונים משלכם בפרויקט:
Gemini Data Analytics Data Agent Creator
(
roles/geminidataanalytics.dataAgentCreator) ברמת הפרויקט. התפקיד הזה מקנה לכם באופן אוטומטי את התפקיד 'בעלים של סוכן נתונים' בסוכן נתונים של Gemini לניתוח נתונים, בסוכני הנתונים שאתם יוצרים. - צפייה בכל סוכני הנתונים בפרויקט ועריכה שלהם: Gemini Data Analytics Data Agent Editor (
roles/geminidataanalytics.dataAgentEditor) ברמת הפרויקט. - הצגת כל סוכני הנתונים בפרויקט: Gemini Data Analytics Data Agent
Viewer (
roles/geminidataanalytics.dataAgentViewer) ברמת הפרויקט.
בנוסף, כדי ליצור או לערוך סוכן נתונים, אתם צריכים את התפקידים הבאים:
- משתמש IAM או חשבון שירות שנוספו ברמת המופע. מידע נוסף זמין במאמר בנושא הוספת הרשאת IAM למשתמש, לחשבון שירות או לקבוצה.
- התפקידים
cloudsql.studioUserו-cloudsql.instanceUserשניתנו למשתמש IAM ברמת הפרויקט. מידע נוסף זמין במאמר הוספת קשירת מדיניות IAM לפרויקט. הרשאות למסד נתונים שניתנו למשתמש IAM או לחשבון שירות על ידי כניסה בתור משתמש של מסד הנתונים שמבוססת על סיסמה.
GRANT ALL PRIVILEGES ON *.* TO 'your-iam-user@example.com';מידע נוסף זמין במאמר הענקת הרשאות למסד נתונים למשתמש IAM או לחשבון שירות ספציפיים.
כשמנהלים את הגישה למשאבי מסד נתונים של Cloud SQL ל-MySQL, צריך לקחת בחשבון את רמות ההרשאות הבאות:
- Google Cloud IAM: שולט בגישה למופע של מסד הנתונים כמשאב בענן. זה כולל הרשאות לחיבור, לניהול המכונה ולביצוע שאילתות SQL, למשל באמצעות ההרשאה
executeSql. - הרשאות למסד הנתונים: שליטה בגישה לאובייקטים במסד הנתונים – כמו טבלאות, תצוגות וסכימות. הניהול מתבצע באמצעות פקודות SQL כמו
GRANTומערכות משתמשים ותפקידים ספציפיות למסד הנתונים.
ב-Cloud SQL ל-MySQL, אתם צריכים תפקידי IAM מתאימים ב-Cloud SQL כדי להתחבר למכונה ולקבל הרשאה לשליחת שאילתות. כדי ליצור אינטראקציה עם אובייקטים כמו טבלאות ותצוגות, למשתמש מסד הנתונים שמחובר צריך להיות הרשאות מתאימות שניתנו באמצעות מערכת GRANT Cloud SQL ל-MySQL. מידע נוסף זמין במאמר מידע על משתמשי Cloud SQL ל-MySQL.
אם הסוכן משתמש בחשבון שירות, אפשר להקצות לו תפקיד במסד הנתונים. לדוגמה, אפשר לעיין במאמר ניהול משתמשים באמצעות אימות מסד נתונים של IAM.
יצירת שיחות
אתם יכולים ליצור שיחות מתמשכות עם סוכן או עם מקור נתונים במסוף Google Cloud Cloud SQL ל-MySQL בכרטיסייה Agent Catalog בדף Agents.
יצירת שיחה עם סוכן נתונים
כדי ליצור שיחה עם סוכן נתונים, קודם צריך ליצור סוכן נתונים ולפרסם אותו. אתם יכולים גם להתחיל שיחה עם סוכנים שאחרים שיתפו איתכם.
כדי ליצור שיחה עם סוכן נתונים במסוף Google Cloud , פועלים לפי השלבים הבאים:
במסוף Google Cloud , נכנסים לדף Cloud SQL ל-MySQL.
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Agents (סוכנים).
בקטע הסוכנים שלי או סוכנים שאנשים אחרים בארגון שיתפו, לוחצים על כרטיס הסוכן שרוצים לשוחח איתו.
לוחצים על התחלת שיחה. תיפתח חלונית צ'אט חדשה.
בשדה יש לך שאלה?, מזינים שאלה לסוכן הנתונים. לדוגמה, "מה היה סך המכירות שלנו ברבעון האחרון?" או "הצג לי את 5 המשתמשים המובילים לפי משך הסשן". אפשר גם ללחוץ על אחת מהשאלות ש-Gemini מציע כדי להתחיל.
סוכן הנתונים מגיב ומציין את הפעולה שהוא מבצע כדי לטפל בשאלה, ואז הוא מחזיר את התוצאות.
כדי לראות כל שלב שסוכן הנתונים מבצע כדי לספק את התשובה לשאלה שלכם, לוחצים על הצגת ההסבר כדי לראות כל הודעה בתהליך ההסבר של הסוכן.
כדי לראות מידע על אופן החישוב של התוצאות, לוחצים על איך הגענו לתשובה הזו? בקטע סיכום מופיעה עכשיו שאילתה שנוצרה ואחריה תוצאת השאילתה. אפשר להעתיק את הקוד ואז ללחוץ על Studio כדי להדביק את הקוד בעורך השאילתות.
כשמתאים לנתונים, סוכן הנתונים מספק תרשימים, טבלאות ותצוגות חזותיות אחרות. כדי לראות את היסטוריית הצ'אטים, עוברים לרשימה ניהול שיחות.
כדי לראות את פרטי הנציג, עוברים לחלונית פרטים. בחלונית הזו מופיע תיאור של הסוכן ומקורות הידע שלו.
ניהול השיחות
בדף סוכנים אפשר לפתוח שיחה, לשנות את השם שלה או למחוק אותה.
פתיחת שיחה קיימת
במסוף Google Cloud , נכנסים לדף Cloud SQL ל-MySQL.
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Agents (סוכנים).
בכרטיסייה שיחות, ברשימת השיחות, לוחצים על השיחה שרוצים לפתוח.
שינוי שם של שיחה
במסוף Google Cloud , נכנסים לדף Cloud SQL ל-MySQL.
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Agents (סוכנים).
בכרטיסייה שיחות, ברשימת השיחות, לוחצים על השיחה שרוצים לשנות את השם שלה.
לוחצים על הצגת פעולות > שינוי השם.
בתיבת הדו-שיח שינוי שם השיחה, מזינים שם חדש לשיחה בשדה שם השיחה.
לוחצים על שינוי שם.
איך מוחקים שיחות
במסוף Google Cloud , נכנסים לדף Cloud SQL ל-MySQL.
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Agents (סוכנים).
בכרטיסייה שיחות, ברשימת השיחות, לוחצים על השיחה שרוצים למחוק.
לוחצים על הצגת פעולות > מחיקה.
בתיבת הדו-שיח למחוק את השיחה?, לוחצים על מחיקה.
מיקומים
ניתוח שיחות פועל באופן גלובלי, ואי אפשר לבחור את האזור שבו הוא יפעל.
המאמרים הבאים
- מידע נוסף על ניתוח נתונים בשיחה ב-Cloud SQL ל-MySQL
- מידע נוסף על Conversational Analytics API
- יצירת סוכן נתונים ב-Cloud SQL ל-MySQL