ניתוח נתונים באמצעות שיחות

במאמר הזה מוסבר איך ליצור, לערוך ולמחוק שיחות ב-Cloud SQL ל-MySQL. שיחות הן צ'אטים שנשמרים עם סוכן נתונים.

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

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

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

  1. מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud .

  2. מפעילים את Cloud SQL, את Data Analytics API עם Gemini ואת Gemini for Google Cloud , אם הם עדיין לא מופעלים.

    התפקידים שנדרשים כדי להפעיל ממשקי API

    כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

    הפעלת ממשקי ה-API

התפקידים הנדרשים

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

תרחיש לדוגמה התפקידים הנדרשים
ליצור, לערוך, לפרסם, לשתף ולמחוק סוכנים
  • כדי ליצור סוכני נתונים בפרויקט: התפקיד "Data Agent Creator" ב-Gemini Data Analytics (roles/geminidataanalytics.dataAgentCreator) בפרויקט. התפקיד הזה נותן לכם באופן אוטומטי את התפקיד "בעלים של סוכן נתונים" ב-Gemini Data Analytics בסוכני הנתונים שאתם יוצרים.
  • כדי לערוך, לשתף או למחוק סוכן נתונים: בעלים של סוכן נתונים ב-Gemini Data Analytics‏ (roles/geminidataanalytics.dataAgentOwner) בסוכן או בפרויקט.
  • כדי לערוך סוכן נתונים בפרויקט: התפקיד "Data Agent Editor" (roles/geminidataanalytics.dataAgentEditor) בפרויקט.
  • כדי לראות סוכני נתונים בפרויקט: התפקיד "Data Agent Viewer" (roles/geminidataanalytics.dataAgentViewer) בפרויקט.
  • בנוסף, כדי ליצור או לערוך סוכן נתונים, אתם צריכים את התפקידים הבאים:
הקצאת סוכנים ב-Gemini Enterprise

כדי שסוכן שפורסם יהיה זמין למשתמשים ב-Gemini Enterprise, אתם צריכים הרשאות לרשום ולנהל סוכני A2A במסוף הניהול של Gemini Enterprise.
איך מוצאים סוכנים ומשתמשים בהם
  • כדי להתכתב בצ'אט עם סוכני נתונים: Gemini Data Analytics Data Agent User (roles/geminidataanalytics.dataAgentUser).
  • כדי לראות את כל סוכני הנתונים בפרויקט: Gemini Data Analytics Data Agent Viewer‏ (roles/geminidataanalytics.dataAgentViewer).

כשאתם מנהלים את הגישה למשאבים של מסד הנתונים 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 שבדף Conversations.

איך מתחילים שיחה עם סוכן נתונים

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

כדי ליצור שיחה עם סוכן נתונים במסוף Google Cloud , פועלים לפי השלבים הבאים:

  1. במסוף Google Cloud , נכנסים לדף Cloud SQL ל-MySQL.

    כניסה ל-Cloud SQL

  2. בוחרים מכונה מהרשימה.

  3. בתפריט הניווט, לוחצים על שיחות.

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

  5. לוחצים על התחלת שיחה. חלונית צ'אט חדשה נפתחת.

  6. בשדה יש לך שאלה?, כותבים שאלה לסוכן הנתונים. לדוגמה, "מה היה סך המכירות שלנו ברבעון האחרון?" או "הצג את 5 המשתמשים המובילים לפי משך הסשן". אתם יכולים גם ללחוץ על אחת מהשאלות ש-Gemini מציע כדי להתחיל.

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

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

    כדי לראות מידע על אופן החישוב של התוצאות, לוחצים על איך הגענו לתשובה הזו? בקטע Summary מופיעה עכשיו שאילתה שנוצרה, ואחריה תוצאת השאילתה. אתם יכולים להעתיק את הקוד ואז ללחוץ על Studio כדי להדביק את הקוד בעורך השאילתות.

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

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

ניהול השיחות

בדף שיחות אתם יכולים לפתוח שיחה, לשנות את השם שלה או למחוק אותה.

פותחים שיחה קיימת.

  1. במסוף Google Cloud , נכנסים לדף Cloud SQL ל-MySQL.

    כניסה ל-Cloud SQL

  2. בוחרים מכונה מהרשימה.

  3. בתפריט הניווט, לוחצים על שיחות.

  4. בכרטיסייה Conversations, לוחצים על השיחה שרוצים לפתוח.

שינוי שם של שיחה

  1. במסוף Google Cloud , נכנסים לדף Cloud SQL ל-MySQL.

    כניסה ל-Cloud SQL

  2. בוחרים מכונה מהרשימה.

  3. בתפריט הניווט, לוחצים על שיחות.

  4. בכרטיסייה Conversations, ברשימת השיחות, לוחצים על השיחה שרוצים לשנות את השם שלה.

  5. לוחצים על הצגת הפעולות > שינוי שם.

  6. בתיבת הדו-שיח Rename conversation, מזינים שם חדש לשיחה בשדה Conversation name.

  7. לוחצים על שינוי שם.

למחוק שיחה

  1. במסוף Google Cloud , נכנסים לדף Cloud SQL ל-MySQL.

    כניסה ל-Cloud SQL

  2. בוחרים מכונה מהרשימה.

  3. בתפריט הניווט, לוחצים על שיחות.

  4. בכרטיסייה Conversations, ברשימת השיחות, לוחצים על השיחה שרוצים למחוק.

  5. לוחצים על הצגת פעולות > מחיקה.

  6. בתיבת הדו-שיח למחוק את השיחה?, לוחצים על מחיקה.

מיקומים

הניתוח של השיחות פועל באופן גלובלי, ואי אפשר לבחור באיזה אזור להשתמש.

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