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

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

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

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

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

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

  2. מפעילים את ממשקי ה-API הבאים, אם הם עדיין לא מופעלים: AlloyDB ל-PostgreSQL,‏ Data Analytics API עם Gemini ו-Gemini ל- Google Cloud .

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

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

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

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

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

תרחיש לדוגמה התפקידים הנדרשים
ליצור, לערוך, לפרסם, לשתף ולמחוק סוכנים
  • כדי ליצור סוכנים לאינטראקציה עם נתונים בפרויקט: התפקיד 'Data Agent Creator' (roles/geminidataanalytics.dataAgentCreator) בפרויקט. התפקיד הזה מעניק לכם באופן אוטומטי את התפקיד Data Agent Owner ב-Gemini Data Analytics בסוכנים לאינטראקציה עם נתונים שאתם יוצרים.
  • כדי לערוך, לשתף או למחוק סוכן לאינטראקציה עם נתונים: התפקיד "בעלים של סוכן לאינטראקציה עם נתונים ב-Gemini Data Analytics" (roles/geminidataanalytics.dataAgentOwner) בסוכן או בפרויקט.
  • כדי לערוך סוכן לאינטראקציה עם נתונים בפרויקט: התפקיד "Data Agent Editor" (roles/geminidataanalytics.dataAgentEditor) בפרויקט.
  • כדי לראות את הסוכנים לאינטראקציה עם נתונים בפרויקט: התפקיד "צפייה בסוכנים לאינטראקציה עם נתונים ב-Gemini Data Analytics" (roles/geminidataanalytics.dataAgentViewer) בפרויקט.
  • בנוסף, כדי ליצור או לערוך סוכן לאינטראקציה עם נתונים, אתם צריכים את התפקידים הבאים:
    • חשבון משתמש או חשבון שירות ב-IAM שנוסף לאשכול ברמת מסד הנתונים. מידע נוסף זמין במאמר ניהול משתמשים במסד נתונים.
    • התפקיד alloydb.databaseUser וההרשאה serviceusage.serviceUsageConsumer שניתנו למשתמש ה-IAM ברמת הפרויקט. מידע נוסף זמין במאמר הוספת קישור למדיניות IAM בפרויקט.
    • אופציונלי: אם אתם משתמשים בקבוצות הקשר (גרסת טרום-השקה (Preview)) עם הסוכן לאינטראקציה עם נתונים של מסד הנתונים, כדי ליצור, להעלות ולנהל קבוצות הקשר: התפקיד "עריכה של Dataplex Catalog"‏ (roles/dataplex.catalogEditor) או "אדמין של Dataplex Catalog"‏ (roles/dataplex.catalogAdmin) שמוקצה למשתמש ה-IAM ברמת הפרויקט. מידע נוסף זמין במאמר הרשאות לקבוצות הקשר.
הקצאת סוכנים ב-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).

כדי לעבוד עם משאבי AlloyDB, כמו הצגת טבלאות או הרצת שאילתות, קראו את המאמר תפקידים והרשאות ב-IAM ל-AlloyDB.

יצירת שיחות

אתם יכולים ליצור שיחות קבועות עם סוכן או עם מקור נתונים במסוף Google Cloud ל-AlloyDB, בכרטיסייה Agent Catalog שבדף Conversations.

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

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

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

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

    כניסה ל-AlloyDB

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

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

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

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

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

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

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

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

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

ניהול השיחות

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

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

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

    כניסה ל-AlloyDB

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

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

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

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

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

    כניסה ל-AlloyDB

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

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

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

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

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

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

למחוק שיחה

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

    כניסה ל-AlloyDB

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

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

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

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

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

מיקומים

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

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