סוכני נתונים בממשק שיחה מאפשרים לכם לקיים אינטראקציה עם נתוני מסד הנתונים באמצעות ממשק שפה טבעית. כשאתם יוצרים את הנציגים האלה, אתם עוזרים למשתמשים "לדבר עם הנתונים שלהם", ומאפשרים להם לקבל תובנות ממסדי נתונים תפעוליים בלי לכתוב שאילתות SQL מורכבות.
באופן כללי, סוכן נתונים הוא שילוב של פרסונה, קבוצה של מקורות נתונים וגישה לקבוצה של ידע עסקי שחיוני למטרות שלו.
למפתחי אפליקציות, הסוכנים האלה מספקים את היתרונות הבאים:
- רמת דיוק גבוהה: שימוש בהקשר שנוצר על ידי משתמשים מאפשר להגיע לרמת דיוק גבוהה בשאלות ספציפיות שקשורות לעסק. ההקשר שנוצר הוא הגורם העיקרי שיוצרי הסוכנים יכולים להשתמש בו כדי לשפר את הדיוק. הוא כולל תיאורי סכימה, הוראות מערכת והקשר מובנה שמספק מידע נוסף על שאילתות צפויות במסד הנתונים.
- פחות מורכבות: הנציגים מתרגמים שפה טבעית לשאילתות SQL, להרצה ואפילו לסיכום או להצגה חזותית של נתונים.
- גמישות: אתם יכולים ליצור סוכנים לטובת בדיקות אישיות, או לפרסם אותם כדי שיהיו זמינים למשתמשים אחרים בפרויקט או באופן פרוגרמטי באמצעות ה-API.
לפני שמתחילים
-
מפעילים את ממשקי ה-API הבאים, אם הם עדיין לא מופעלים: AlloyDB ל-PostgreSQL, Data Analytics API עם Gemini ו-Gemini for Google Cloud .
התפקידים שנדרשים כדי להפעיל ממשקי API
כדי להפעיל ממשקי API, צריך את ההרשאה
serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים
התפקידים הנדרשים
כדי לעבוד עם סוכני נתונים, אתם צריכים הרשאות IAM שמתאימות לתרחיש לדוגמה שלכם. בטבלה הבאה מפורטים התפקידים הנדרשים בהתאם לפעולה שאתם מבצעים: יצירה ופרסום של סוכנים, הקצאת סוכנים ב-Gemini Enterprise או חיפוש סוכנים ושימוש בהם. מידע נוסף זמין במאמר תפקידי IAM ב-Conversational Analytics API.
| תרחיש שימוש | התפקידים הנדרשים |
|---|---|
| ליצור, לערוך, לפרסם, לשתף ולמחוק סוכנים |
|
| הקצאת סוכנים ב-Gemini Enterprise |
כדי שסוכן שפורסם יהיה זמין למשתמשים ב-Gemini Enterprise, אתם צריכים הרשאות לרשום ולנהל סוכני A2A במסוף הניהול של Gemini Enterprise. |
| איך מוצאים סוכנים ומשתמשים בהם |
|
כדי לעבוד עם משאבי AlloyDB, כמו הצגת טבלאות או הרצת שאילתות, קראו את המאמר תפקידים והרשאות ב-IAM ל-AlloyDB.
יצירת סוכן נתונים
בקטעים הבאים מוסבר איך ליצור סוכן נתונים. אחרי שיוצרים נציג, אפשר לערוך את ההגדרות שלו.
הגדרת פרטים בסיסיים
נכנסים לדף AlloyDB במסוף Google Cloud .
בוחרים אשכול מהרשימה.
בתפריט הניווט, לוחצים על נציגים.
לוחצים על הכרטיסייה סוכנים.
בוחרים מסד נתונים ונכנסים באמצעות חשבון IAM.
לוחצים על סוכן חדש. ייפתח הדף סוכן חדש.
בקטע עורך, בשדה שם הסוכן, מזינים שם תיאורי לסוכן הנתונים – לדוגמה,
Q4 sales dataאוUser activity logs.בשדה Agent description (תיאור הסוכן) מזינים תיאור של סוכן הנתונים. תיאור טוב מסביר מה סוכן הנתונים עושה, באילו נתונים הוא משתמש ועוזר לכם להחליט אם זה סוכן הנתונים הנכון לשיחה. לדוגמה:
What are the top 10 selling products in Q2?בקטע מקורות מידע, לוחצים על הוספת מקור. הדף Add data נפתח.
בוחרים את הטבלאות שהסוכן יעזר בהן כשהוא יענה על שאלות. כדי לראות מקורות ידע נוספים, לוחצים על הצגת מקורות נוספים.
לוחצים על הוספה. דף הנציג החדש נפתח מחדש.
התאמה אישית של תיאורי טבלאות ושדות
כדי לשפר את הדיוק של סוכן הנתונים בשיחה, אתם יכולים לספק מטא-נתונים נוספים של הטבלה. רק סוכן הנתונים משתמש במטא-נתונים האלה, והם לא משפיעים על טבלת המקור. אפשר להוסיף את המטא-נתונים הבאים:
- תיאורי סכימה: הוסיפו תיאורים לטבלאות ולעמודות כדי לעזור לסוכן להבין את הנתונים. אם לא מוסיפים תיאורים, הסוכן משתמש בתיאורי הסכימה מהגדרות הנתונים.
כדאי לפעול לפי השיטות המומלצות הבאות כשמוסיפים תיאורים לטבלאות ולשדות:
- הוסיפו תיאורים להגדרת הנתונים, ולא רק להגדרת סוכן הנתונים. ככה גם סוכנים אחרים יוכלו להשתמש בתיאורים.
- כדי ליצור אב טיפוס של התיאור המתאים שיעזור לסוכני נתונים להבין את הנתונים שלכם, מוסיפים תיאורים לסוכן הספציפי. אחרי שמוודאים שהתיאור משפיע כמו שרוצים, אפשר להחליט אם להוסיף את התיאור להגדרת הנתונים.
כדי להתאים אישית את התיאורים של הטבלאות והשדות של הנציג:
- בכרטיסייה Agent Catalog, פותחים את הסוכן שרוצים להתאים אישית.
- לוחצים על עריכת הנציג.
- בקטע מקורות ידע, מוצאים את הטבלה שרוצים להתאים אישית ולוחצים על התאמה אישית.
- מוסיפים תיאור בשדה תיאור הטבלה או מקבלים את ההצעה של Gemini.
- בקטע Fields, בודקים את התיאורים שהציע Gemini לעמודות בטבלה.
- מנהלים את התיאורים המוצעים לשדות:
- כדי לאשר את ההצעות, בוחרים את התיאורים הרצויים ולוחצים על אישור ההצעות.
- כדי לדחות הצעות, בוחרים את התיאורים הרצויים ולוחצים על דחיית ההצעות.
- כדי לערוך את התיאור של שדה, לוחצים על עריכה לצד השדה.
- בשדה Description (תיאור), מזינים תיאור של השדה.
- לוחצים על עדכון כדי לשמור את השינויים.
- לוחצים על עדכון כדי לשמור את ההתאמה האישית של הטבלה.
- חוזרים על השלבים האלה לכל טבלה שרוצים להתאים אישית.
יצירת שאילתות מאומתות
אתם יכולים לבחור שאילתות מאומתות מתוך רשימה שנוצרה על ידי המערכת, או ליצור שאילתות משלכם.
כדי ליצור שאילתה מאומתת עבור סוכן הנתונים:
- בכרטיסייה Agent Catalog, פותחים את הסוכן שרוצים להתאים אישית.
- לוחצים על עריכת הנציג.
בקטע Verified queries (שאילתות מאומתות), לוחצים על View Gemini-generated suggestions (צפייה בהצעות שנוצרו על ידי Gemini).
- בקטע בדיקת ההצעות לשאילתה מאומתת, בודקים את ההצעות לשאילתות מאומתות.
- בוחרים את השאילתות שרלוונטיות לתרחיש השימוש.
- לוחצים על הוספה כדי להוסיף את השאילתות להקשר.
זה שינוי אופציונלי. כדי ליצור שאילתה מאומתת משלכם, לוחצים על הוספת שאילתה בשאילתות מאומתות.
- בשדה Question, מזינים את השאלה שאפשר לענות עליה באמצעות השאילתה המאומתת.
- לוחצים על יצירת SQL כדי ש-Gemini ייצור שאילתה מאומתת שתואמת לשאלה שהוספתם.
- לוחצים על Run ומוודאים שהשאילתה מחזירה את התוצאות שציפיתם להן.
- בודקים את התשובה ומשנים את השאילתה המאומתת, אם צריך.
- לוחצים על הוספה.
חוזרים על השלבים האלה כדי ליצור עוד שאילתות מאומתות.
הוספת תוויות לסוכני נתונים
בקטע Agent Settings אפשר ליצור תוויות כדי לארגן את המשאבים של Google Cloud . תוויות הן צמדי מפתח/ערך שמאפשרים לקשר בין אובייקטים או ביניהם לבין משאבים אחרים של Google Cloud.
- בכרטיסייה קטלוג הסוכנים, פותחים את הסוכן שרוצים להוסיף לו תווית.
- לוחצים על עריכת סוכן.
- בקטע Agent Settings, לוחצים על Add label. חלונית ניהול תוויות נפתחת.
- לוחצים על הוספת תווית.
- בשדות key ו-value, מזינים את צמד המפתח/ערך של התווית.
- אם רוצים להוסיף עוד תוויות, לוחצים שוב על הוספת תווית.
- כדי למחוק תווית, לוחצים על מחיקה.
- כשמסיימים, לוחצים על הוספה. דף הסוכן החדש ייפתח מחדש.
בקטע הבא מוסבר איך להעביר את הסוכן למצב טיוטה או לפרסם את הסוכן.
תצוגה מקדימה ופרסום של הנציג
בקטע תצוגה מקדימה, מזינים שאלה לדוגמה בשדה שאלת שאלה ומקישים על Enter.
כדי לוודא שסוכן הנתונים מחזיר את הנתונים שציפיתם לקבל, בודקים את התשובה של הסוכן. אם התשובה לא תואמת לציפיות, משנים את ההגדרות בקטע Editor כדי לשפר את ההגדרות של סוכן הנתונים עד שמקבלים תשובות מספקות. אתם יכולים להמשיך לבדוק ולשנות את הנציג כדי לשפר את התוצאות שלו.
לוחצים על Save.
כדי להעביר את סוכן הנתונים למצב טיוטה, שבו אפשר לערוך אותו מחדש מאוחר יותר, לוחצים על Go back כדי לחזור לדף Agent Catalog. הסוכן נמצא עכשיו במצב טיוטה, ולכן הוא מופיע בקטע My draft agents בכרטיסייה Agent Catalog.
כדי לפרסם את הסוכן, נשארים בדף ליצירת סוכן וממשיכים לשלב הבא.
כדי לפרסם את סוכן הנתונים ולהפוך אותו לזמין לשימוש בפרויקט, לוחצים על Publish. כשמפרסמים את הנציג, משתמשים אחרים שיש להם גישה לאותן טבלאות במסד הנתונים יכולים לראות את הנציג ולשוחח איתו, ולהיעזר בהוראות ובהקשר שיצרתם.
אפשר ליצור שיחות עם סוכן הנתונים באמצעות הדף Agents במסוף Google Cloud . אפשר גם ליצור ממשק משתמש משלכם כדי לשוחח עם סוכן הנתונים באמצעות Conversational Analytics API.
אופציונלי: בתיבת הדו-שיח Your agent has been published, לוחצים על Share כדי לשתף את סוכן הנתונים עם משתמשים אחרים.
- בחלונית Share permissions, לוחצים על Add principal.
- בשדה New principals, מזינים חשבון משתמש אחד או יותר.
- לוחצים על הרשימה Select a role.
- ברשימה Role, בוחרים אחד מהתפקידים הבאים:
- Gemini Data Analytics Data Agent User (
roles/geminidataanalytics.dataAgentUser): מאפשרת לשוחח עם סוכן הנתונים. - Gemini Data Analytics Data Agent Editor (
roles/geminidataanalytics.dataAgentEditor): הרשאת עריכה של סוכן הנתונים. - Gemini Data Analytics Data Agent Viewer (
roles/geminidataanalytics.dataAgentViewer): הרשאה לצפות בסוכן הנתונים.
- Gemini Data Analytics Data Agent User (
- לוחצים על Save.
אופציונלי: אפשר לפרסם את סוכן הנתונים ב-Gemini Enterprise. מידע נוסף זמין במאמר בנושא פרסום סוכן נתונים ב-Gemini Enterprise.
כדי לחזור לדף של הנציג החדש, לוחצים על סגירה. אחרי ששומרים או מפרסמים את הנציג, הוא מופיע בקטלוג הנציגים.
ניהול סוכני נתונים
אפשר למצוא סוכנים קיימים בכרטיסייה קטלוג הסוכנים, שמחולקת לשלושה חלקים:
- הסוכנים שלי: רשימה של כל הסוכנים שיצרתם ופרסמתם. אתם יכולים לשנות סוכנים שפורסמו ולשתף אותם עם אחרים.
- הסוכנים שלי שבמצב טיוטה: סוכנים שעדיין לא פרסמתם. אי אפשר לשתף סוכנים במצב טיוטה.
- סוכנים שאנשים אחרים בארגון שיתפו: סוכנים שאנשים אחרים יוצרים ומשתפים איתכם. אם אנשים אחרים נותנים לכם הרשאות, אתם יכולים לערוך את הנציגים המשותפים האלה.
עריכה של סוכן נתונים
כדי לערוך סוכן נתונים, פועלים לפי השלבים הבאים:
נכנסים לדף AlloyDB במסוף Google Cloud .
בוחרים אשכול מהרשימה.
בתפריט הניווט, לוחצים על נציגים.
נכנסים אל סוכנים באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).
לוחצים על הכרטיסייה קטלוג הסוכנים.
מאתרים את כרטיס הסוכן של סוכן הנתונים שרוצים לשנות.
כדי לפתוח את סוכן הנתונים בעורך הסוכנים, לוחצים על Open actions (פתיחת פעולות) ואז על Edit (עריכה) בכרטיס הסוכן.
עורכים את ההגדרות של סוכן הנתונים לפי הצורך.
כדי לשמור את השינויים בלי לפרסם אותם, לוחצים על שמירה.
כדי לפרסם את השינויים, לוחצים על פרסום. בתיבת הדו-שיח Share, אתם יכולים לשתף את הנציג עם אחרים או ללחוץ על Cancel.
כדי לחזור לחלונית Agents, לוחצים על Go back.
שיתוף סוכן נתונים
כדי לשתף סוכן נתונים שפורסם: אי אפשר לשתף סוכנים בטיוטה.
נכנסים לדף AlloyDB במסוף Google Cloud .
בוחרים אשכול מהרשימה.
בתפריט הניווט, לוחצים על נציגים.
נכנסים אל סוכנים באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).
לוחצים על הכרטיסייה קטלוג הסוכנים.
מאתרים את כרטיס הסוכן של סוכן הנתונים שרוצים לשנות.
כדי לפתוח את סוכן הנתונים בעורך הסוכנים, לוחצים על Open actions > Edit בכרטיס הסוכן.
כדי לשתף את סוכן הנתונים עם משתמשים אחרים, לוחצים על שיתוף.
בחלונית Share permissions, לוחצים על Add principal.
בשדה Add principals, מזינים חשבון משתמש אחד או יותר.
לוחצים על בחירת תפקיד.
ברשימה Role, בוחרים באחד מהתפקידים הבאים:
- Gemini Data Analytics Data Agent User (
roles/geminidataanalytics.dataAgentUser): הרשאה להתכתב בצ'אט עם סוכן הנתונים. - Gemini Data Analytics Data Agent Editor (
roles/geminidataanalytics.dataAgentEditor): הרשאת עריכה של סוכן הנתונים. - Gemini Data Analytics Data Agent Viewer (
roles/geminidataanalytics.dataAgentViewer): הרשאה לצפות בסוכן הנתונים.
- Gemini Data Analytics Data Agent User (
לוחצים על Save.
כדי לחזור לדף העריכה של הסוכן, לוחצים על סגירה.
כדי לחזור לחלונית סוכנים, לוחצים על חזרה.
מחיקת סוכן נתונים
נכנסים לדף AlloyDB במסוף Google Cloud .
בוחרים אשכול מהרשימה.
בתפריט הניווט, לוחצים על נציגים.
נכנסים אל סוכנים באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).
לוחצים על הכרטיסייה קטלוג הסוכנים.
בקטע Agents בכרטיסייה Agent Catalog, מאתרים את כרטיס הסוכן של סוכן הנתונים שרוצים למחוק.
לוחצים על פתיחת הפעולות > מחיקה.
בתיבת הדו-שיח Delete agent? לוחצים על Delete. מחיקת הנציג מסירה אותו מהפרויקט באופן סופי.
אחרי שמוחקים סוכן, השיחות הקיימות איתו יהיו במצב קריאה בלבד. אי אפשר לשאול את הסוכן שנמחק שאלות חדשות.
פרסום סוכן נתונים ב-Gemini Enterprise
כדי לפרסם סוכן נתונים, צריך שיתוף פעולה בין מנתחי נתונים, אדמינים ב-Gemini Enterprise ומשתמשים עסקיים. בקטע התפקידים הנדרשים מוסבר אילו תפקידים נדרשים למשתמשים האלה.
יצירה ופרסום של סוכן
כדי ליצור, לערוך ולפרסם נציג, פועלים לפי השלבים הבאים:
- יוצרים או עורכים את סוכן הנתונים ב-AlloyDB.
- מפרסמים את הסוכן. כשמפרסמים את הסוכן, בוחרים באפשרות הפרסום Gemini Enterprise.
- כדי להעתיק את קובץ ה-JSON של נקודת הקצה של A2A, לוחצים על העתקת קובץ ה-JSON.
- משתפים את ה-JSON של נקודת הקצה של A2A ואת רשימת המשתמשים עם האדמין ב-Gemini Enterprise, כדי שהוא יוכל לרשום את הסוכן בהתאמה אישית במסוף Google Cloud ולהגדיר את הרשאות הגישה. מידע נוסף זמין במאמר הקצאת הרשאות לסוכן.
- משתפים את הסוכן עם המשתמשים והקבוצות שצריכים גישה.
הקצאת סוכן
כדי להפוך נציג שפורסם לזמין למשתמשים במסוף Google Cloud , פועלים לפי השלבים הבאים:
במסוף Google Cloud , עוברים אל Gemini Enterprise.
לוחצים על שם האפליקציה שבה רוצים לרשום את הסוכן.
לוחצים על סוכנים > הוספת סוכנים.
בקטע Choose an agent type, לוחצים על Add באפשרות Custom agent via A2A.
בשדה Agent card JSON, מזינים את פרטי כרטיס הסוכן שקיבלתם קודם ממנתח הנתונים בפורמט JSON.
לוחצים על תצוגה מקדימה של פרטי הנציג > הבא.
כדי לאפשר לנציג לגשת למשאבים של Google Cloud בשמכם, צריך לבצע את הפעולות הבאות:
מזינים את מזהה הלקוח ואת סוד הלקוח שיצרתם בקטע הגדרת פרטי ההרשאה.
בשדה Authorization URI, מזינים את הערך הבא:
https://accounts.google.com/o/oauth2/v2/auth?client_id=client_id&redirect_uri=https%3A%2F%2Fvertexaisearch.cloud.google.com%2Fstatic%2Foauth%2Foauth.html&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud-platform&include_granted_scopes=true&response_type=code&access_type=offline&prompt=consent
מחליפים את client_id במזהה הלקוח שיצרתם בקטע הגדרת פרטי ההרשאה.
בשדה Token URI, מזינים את הערך הבא:
https://oauth2.googleapis.com/token
בשדה Scopes, מזינים את הערך הבא:
https://www.googleapis.com/auth/cloud-platform
לוחצים על סיום.
משתפים את הנציג עם המשתמשים או הקבוצות.
מידע נוסף זמין במאמר רישום וניהול של סוכני A2A.
איך מוצאים סוכן ומשתמשים בו
אתם יכולים למצוא סוכן נתונים ולהשתמש בו ב-Gemini Enterprise בכל אחת מהדרכים הבאות:
- מוצאים את הסוכן בגלריית הסוכנים ומתחילים צ'אט ייעודי.
- משתמשים בכתובת ה-URL הייעודית של הסוכן כדי לפתוח את Gemini Enterprise ישירות בסשן עם סוכן הנתונים הספציפי הזה ב-AlloyDB.
- מפעילים את הסוכן על ידי כתיבת
@mention– למשל@sales_pipeline_agent– בצ'אט הליבה של Gemini Enterprise. - אתם יכולים לשאול שאלה כללית שקשורה לניתוח נתונים, כמו "מה המגמה בצנרת המכירות שלנו ב-3 החודשים האחרונים?", ו-Gemini Enterprise ינתב את השאילתה באופן אוטומטי לסוכן הנתונים הרלוונטי.
אחרי שמוצאים את הנציג, אפשר להשתמש בו באחת מהדרכים הבאות:
- משלימים את הכניסה החד-פעמית באמצעות OAuth כדי לאמת באופן מאובטח את AlloyDB.
- לשאול שאלות בשפה טבעית. הסוכן לניתוח נתונים בשיחה מעבד את הבקשות שלכם ומעביר את התשובה בחזרה ל-Gemini Enterprise כטקסט, Markdown, תרשימים או טבלאות.
- היסטוריית השיחות נשמרת באופן אוטומטי, ואפשר לראות אותה בחלונית ההיסטוריה.
מיקומים
ניתוח שיחות פועל באופן גלובלי, ואי אפשר לבחור את האזור שבו הוא יפעל.
המאמרים הבאים
- מידע נוסף על ניתוח נתונים בשיחה ב-AlloyDB
- מידע נוסף על Conversational Analytics API
- ניתוח נתונים באמצעות שיחות.
- איך התפקיד Gemini Data Analytics Data Agent Viewer (
roles/geminidataanalytics.dataAgentViewer) נותן הרשאה לצפות בסוכן הנתונים.