במאמר הזה נסביר איך ליצור, לערוך ולמחוק שיחות ב-Cloud SQL for PostgreSQL. שיחות הן צ'אטים שנשמרים עם סוכן נתונים.
אתם יכולים לשאול את סוכני הנתונים שאלות מורכבות שכוללות מונחים נפוצים – לדוגמה, 'מכירות' או 'הכי פופולרי' – בלי לציין שמות של שדות בטבלה או להגדיר תנאים לסינון הנתונים. התשובה בצ'אט מספקת את התשובה לשאלה שלכם כטקסט וקוד, ויוצרת תרשימים כשצריך. התגובה כוללת את ההסבר לתוצאות.
אתם יכולים ליצור שיחה עם סוכן נתונים. כשיוצרים שיחה ישירה, Conversational Analytics API מפרש את השאלה בלי ההקשר והוראות העיבוד שסוכן הנתונים מספק.
לפני שמתחילים
-
מפעילים את Cloud SQL, את Data Analytics API עם Gemini ואת Gemini for Google Cloud APIs.
תפקידים שנדרשים להפעלת ממשקי API
כדי להפעיל ממשקי API, צריך את תפקיד ה-IAM 'אדמין של שימוש בשירות' (
roles/serviceusage.serviceUsageAdmin), שכולל את ההרשאהserviceusage.services.enable. איך מקצים תפקידים
התפקידים הנדרשים
כדי לעבוד עם סוכני נתונים, צריכות להיות לכם הרשאות 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 בדף Agents.
יצירת שיחה עם סוכן נתונים
כדי ליצור שיחה עם סוכן נתונים, קודם צריך ליצור סוכן נתונים ולפרסם אותו. אתם יכולים גם להתחיל שיחה עם סוכנים שאחרים שיתפו איתכם.
כדי ליצור שיחה עם סוכן נתונים במסוף Google Cloud , פועלים לפי השלבים הבאים:
נכנסים לדף Cloud SQL for PostgreSQL במסוף Google Cloud .
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Agents (סוכנים).
בקטע הסוכנים שלי או סוכנים שאנשים אחרים בארגון שיתפו, לוחצים על כרטיס הסוכן שרוצים לשוחח איתו.
לוחצים על התחלת שיחה. תיפתח חלונית צ'אט חדשה.
בשדה יש לך שאלה?, מזינים שאלה לסוכן הנתונים. לדוגמה, "מה היה סך המכירות שלנו ברבעון האחרון?" או "אני רוצה לראות את 5 המשתמשים המובילים לפי משך הסשן". אפשר גם ללחוץ על אחת מהשאלות ש-Gemini מציע כדי להתחיל.
סוכן הנתונים מגיב ומציין את הפעולה שהוא מבצע כדי לטפל בשאלה, ואז הוא מחזיר את התוצאות.
כדי לראות כל שלב שסוכן הנתונים מבצע כדי לספק את התשובה לשאלה שלכם, לוחצים על הצגת ההסבר כדי לראות כל הודעה בתהליך ההסבר של הסוכן.
כדי לראות מידע על אופן החישוב של התוצאות, לוחצים על איך הגענו לתשובה הזו? בקטע סיכום מופיעה עכשיו שאילתה שנוצרה ואחריה תוצאת השאילתה. אפשר להעתיק את הקוד ואז ללחוץ על Studio כדי להדביק את הקוד בעורך השאילתות.
כשמתאים לנתונים, סוכן הנתונים מספק תרשימים, טבלאות ותצוגות חזותיות אחרות. כדי לראות את היסטוריית הצ'אטים, עוברים לרשימה ניהול שיחות.
כדי לראות את פרטי הנציג, עוברים לחלונית פרטים. בחלונית הזו מופיע תיאור של הסוכן ומקורות הידע שלו.
ניהול השיחות
אתם יכולים לפתוח, לשנות את השם או למחוק שיחה בדף סוכנים.
פתיחת שיחה קיימת
נכנסים לדף Cloud SQL for PostgreSQL במסוף Google Cloud .
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Agents (סוכנים).
בכרטיסייה שיחות, ברשימת השיחות, לוחצים על השיחה שרוצים לפתוח.
שינוי שם של שיחה
נכנסים לדף Cloud SQL for PostgreSQL במסוף Google Cloud .
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Agents (סוכנים).
בכרטיסייה שיחות, ברשימת השיחות, לוחצים על השיחה שרוצים לשנות את השם שלה.
לוחצים על הצגת פעולות > שינוי השם.
בתיבת הדו-שיח שינוי שם השיחה, מזינים שם חדש לשיחה בשדה שם השיחה.
לוחצים על שינוי שם.
למחוק שיחה
נכנסים לדף Cloud SQL for PostgreSQL במסוף Google Cloud .
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Agents (סוכנים).
בכרטיסייה שיחות, ברשימת השיחות, לוחצים על השיחה שרוצים למחוק.
לוחצים על הצגת פעולות > מחיקה.
בתיבת הדו-שיח למחוק את השיחה?, לוחצים על מחיקה.
מיקומים
ניתוח שיחות פועל באופן גלובלי, ואי אפשר לבחור את האזור שבו הוא יפעל.
המאמרים הבאים
- מידע נוסף על ניתוח שיחות ב-Cloud SQL ל-PostgreSQL
- מידע נוסף על Conversational Analytics API
- יצירת סוכן נתונים ב-Cloud SQL ל-PostgreSQL.