במאמר הזה מוסבר איך ליצור, לערוך ולמחוק שיחות ב-Cloud SQL ל-PostgreSQL. שיחות הן צ'אטים שנשמרים עם סוכן לאינטראקציה עם נתונים.
אתם יכולים לשאול את הסוכנים לאינטראקציה עם נתונים שאלות מרובות חלקים שכוללות מונחים נפוצים, כמו "מכירות" או "הכי פופולרי", בלי לציין שמות של שדות בטבלה או להגדיר תנאים לסינון הנתונים. התשובה בצ'אט כוללת טקסט וקוד, וגם תרשימים במקרים הרלוונטיים. התגובה כוללת את הסיבה לתוצאות.
אתם יכולים להתחיל שיחה עם סוכן לאינטראקציה עם נתונים. כשיוצרים שיחה ישירה, Conversational Analytics API מפרש את השאלה בלי ההקשר והוראות העיבוד שסוכן לאינטראקציה עם נתונים מספק.
לפני שמתחילים
-
מפעילים את Cloud SQL, את Data Analytics API עם Gemini ואת Gemini for Google Cloud APIs, אם הם עדיין לא מופעלים.
התפקידים שנדרשים כדי להפעיל ממשקי API
כדי להפעיל ממשקי API, צריך את ההרשאה
serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, אתם יכולים לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים?
התפקידים הנדרשים
כדי לעבוד עם סוכנים לאינטראקציה עם נתונים, אתם צריכים הרשאות IAM שמתאימות לתרחיש לדוגמה שלכם. בטבלה הבאה מפורטים התפקידים הנדרשים בהתאם לפעולה שאתם מבצעים: יצירה ופרסום של סוכנים, הקצאת סוכנים ב-Gemini Enterprise או חיפוש סוכנים ושימוש בהם. מידע נוסף זמין במאמר תפקידי IAM ב-Conversational Analytics API.
| תרחיש לדוגמה | התפקידים הנדרשים |
|---|---|
| ליצור, לערוך, לפרסם, לשתף ולמחוק סוכנים |
|
| הקצאת סוכנים ב-Gemini Enterprise |
כדי שסוכן שפורסם יהיה זמין למשתמשים ב-Gemini Enterprise, אתם צריכים הרשאות לרשום ולנהל סוכני A2A במסוף הניהול של Gemini Enterprise. |
| איך מוצאים סוכנים ומשתמשים בהם |
|
כשמנהלים את הגישה למשאבים של מסד נתונים ב-Cloud SQL ל-PostgreSQL, צריך להביא בחשבון את שכבות ההרשאות הבאות:
- Google Cloud IAM: שליטה בגישה למכונה של מסד הנתונים כמשאב בענן. זה כולל הרשאות להתחבר, לנהל את המכונה ולהריץ שאילתות SQL, למשל באמצעות ההרשאה
executeSql. - הרשאות למסד הנתונים: שליטה בגישה לאובייקטים במסד הנתונים, כמו טבלאות, תצוגות וסכימות. הניהול שלהם מתבצע באמצעות פקודות SQL כמו
GRANTומערכות של משתמשים ותפקידים שספציפיות למסד הנתונים.
ב-Cloud SQL ל-PostgreSQL, צריך תפקידי IAM מתאימים ב-Cloud SQL כדי להתחבר למכונה ולקבל הרשאה לשלוח שאילתות. כדי לבצע פעולות באובייקטים כמו טבלאות ותצוגות, למשתמש שמקושר למסד הנתונים צריכות להיות ההרשאות הנדרשות שניתנו באמצעות מערכת GRANT של Cloud SQL ל-PostgreSQL.
מידע נוסף זמין במאמר מידע על משתמשים ותפקידים ב-PostgreSQL.
אם הנציג משתמש בחשבון שירות, אתם יכולים להקצות לו תפקיד במסד הנתונים. לדוגמה, ראו ניהול משתמשים באמצעות אימות מסד נתונים של IAM.
יצירת שיחות
אפשר ליצור שיחות מתמשכות עם נציג או עם מקור נתונים במסוף Google Cloud של Cloud SQL ל-PostgreSQL, בכרטיסייה Agent Catalog שבדף Conversations.
איך מתחילים שיחה עם סוכן נתונים
כדי ליצור שיחה עם סוכן לאינטראקציה עם נתונים, קודם צריך ליצור סוכן לאינטראקציה עם נתונים ולפרסם אותו. אתם יכולים גם להתחיל שיחה עם סוכנים שאנשים אחרים שיתפו איתכם.
כדי ליצור שיחה עם סוכן לאינטראקציה עם נתונים במסוף Google Cloud :
במסוף Google Cloud , נכנסים לדף Cloud SQL ל-PostgreSQL.
בוחרים מכונה מהרשימה.
בתפריט הניווט, לוחצים על שיחות.
בקטע הסוכנים שלי או סוכנים שאנשים אחרים בארגון שיתפו, לוחצים על הכרטיס של הסוכן שרוצים לדבר איתו. חלונית צ'אט חדשה נפתחת.
בשדה יש לך שאלה?, כותבים שאלה לסוכן לאינטראקציה עם נתונים. לדוגמה, "מה היה סך המכירות שלנו ברבעון האחרון?" או "הצג את 5 המשתמשים המובילים לפי משך הסשן". אתם יכולים גם ללחוץ על אחת מהשאלות ש-Gemini מציע כדי להתחיל.
הסוכן לאינטראקציה עם נתונים מגיב ומציין את הפעולה שהוא מבצע כדי לטפל בשאלה, ואז מחזיר את התוצאות.
כדי לראות כל שלב שהסוכן לאינטראקציה עם נתונים מבצע כדי לענות על השאלה, לוחצים על הצגת תהליך החשיבה ורואים כל הודעה בתהליך החשיבה של הסוכן.
כדי לראות מידע על אופן החישוב של התוצאות, לוחצים על איך הגענו לתשובה הזו? בקטע Summary מופיעה עכשיו שאילתה שנוצרה, ואחריה תוצאת השאילתה. אתם יכולים להעתיק את הקוד ואז ללחוץ על Studio כדי להדביק את הקוד בעורך השאילתות.
אם זה מתאים לנתונים, הסוכן לאינטראקציה עם נתונים מספק תרשימים, טבלאות ורכיבים חזותיים אחרים. כדי לראות את היסטוריית הצ'אטים, עוברים לרשימה ניהול שיחות.
כדי לראות את פרטי הסוכן, עוברים לחלונית Details. החלונית הזו כוללת תיאור של הסוכן ומקורות הידע שלו.
ניהול השיחות
בדף Conversations אפשר לפתוח, לשנות את השם או למחוק שיחה.
פותחים שיחה קיימת.
במסוף Google Cloud , נכנסים לדף Cloud SQL ל-PostgreSQL.
בוחרים מכונה מהרשימה.
בתפריט הניווט, לוחצים על שיחות.
בכרטיסייה Conversations, לוחצים על השיחה שרוצים לפתוח ברשימת השיחות.
שינוי שם של שיחה
במסוף Google Cloud , נכנסים לדף Cloud SQL ל-PostgreSQL.
בוחרים מכונה מהרשימה.
בתפריט הניווט, לוחצים על שיחות.
בכרטיסייה Conversations, ברשימת השיחות, לוחצים על השיחה שרוצים לשנות את השם שלה.
לוחצים על הצגת הפעולות > שינוי שם.
בתיבת הדו-שיח שינוי שם השיחה, מזינים שם חדש לשיחה בשדה שם השיחה.
לוחצים על שינוי שם.
למחוק שיחה
במסוף Google Cloud , נכנסים לדף Cloud SQL ל-PostgreSQL.
בוחרים מכונה מהרשימה.
בתפריט הניווט, לוחצים על שיחות.
בכרטיסייה Conversations, ברשימת השיחות, לוחצים על השיחה שרוצים למחוק.
לוחצים על הצגת פעולות > מחיקה.
בתיבת הדו-שיח למחוק את השיחה?, לוחצים על מחיקה.
מיקומים
הניתוח של השיחות פועל באופן גלובלי, ואי אפשר לבחור באיזה אזור להשתמש.
המאמרים הבאים
- מידע נוסף על ניתוח נתונים של שיחות ב-Cloud SQL ל-PostgreSQL
- מידע נוסף על Conversational Analytics API
- יצירת סוכן לאינטראקציה עם נתונים ב-Cloud SQL ל-PostgreSQL