סוכנים לאינטראקציה עם נתונים בממשק שיחה מאפשרים לכם לבצע פעולות בנתונים של מסד הנתונים באמצעות ממשק בשפה טבעית. כשאתם יוצרים את הנציגים האלה, אתם עוזרים למשתמשים "לדבר עם הנתונים שלהם", ומאפשרים להם לקבל תובנות ממסדי נתונים תפעוליים בלי שהם יצטרכו לכתוב שאילתות SQL מורכבות.
ברמה גבוהה, סוכן לאינטראקציה עם נתונים הוא שילוב של פרסונה, קבוצה של מקורות נתונים, עם גישה לקבוצה של ידע עסקי שחיוני למטרות שלו.
למפתחי אפליקציות, הסוכנים האלה מספקים את היתרונות הבאים:
- רמת דיוק גבוהה: שימוש בהקשר שנוצר על ידי המשתמש מאפשר להשיג רמת דיוק גבוהה בשאלות ספציפיות שקשורות לעסק. הקשר מוגדר הוא הגורם העיקרי שיוצרי סוכנים יכולים להשתמש בו כדי לשפר את הדיוק. הוא כולל תיאורי סכימה, הוראות מערכת והקשר מובנה שמספק מידע נוסף על שאילתות צפויות במסד הנתונים.
- פחות מורכבות: הסוכנים מתרגמים שפה טבעית לשאילתות SQL, מריצים אותן ואפילו מסכמים את הנתונים או יוצרים מהם תצוגה חזותית.
- גמישות: אתם יכולים ליצור טיוטות של נציגים לבדיקה אישית, או לפרסם אותם כדי שיהיו זמינים למשתמשים אחרים בפרויקט או באופן פרוגרמטי באמצעות ה-API.
לפני שמתחילים
-
מפעילים את Bigtable, Bigtable Admin, 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. |
| איך מוצאים סוכנים ומשתמשים בהם |
|
כדי לעבוד עם משאבי Bigtable, קראו את המאמר תפקידים והרשאות ב-Bigtable.
יצירת סוכן נתונים
בקטעים הבאים מוסבר איך ליצור סוכן נתונים. אחרי שיוצרים סוכן, אפשר לערוך את ההגדרות שלו.
הגדרת היסודות
נכנסים לדף Bigtable במסוף Google Cloud .
בוחרים מכונה מהרשימה.
בתפריט הניווט, לוחצים על נציגים.
לוחצים על הכרטיסייה קטלוג הסוכנים.
לוחצים על Create agent. הדף Editor נפתח.
בקטע Editor, בשדה Agent name, מזינים שם תיאורי לסוכן לאינטראקציה עם נתונים, לדוגמה
Q4 sales dataאוUser activity logs.בשדה Agent description, כותבים תיאור של הסוכן לאינטראקציה עם נתונים. תיאור טוב מסביר מה סוכן לאינטראקציה עם נתונים עושה, באילו נתונים הוא משתמש ועוזר לכם לקבוע אם זה סוכן לאינטראקציה עם נתונים המתאים לשיחה. לדוגמה,
What are the top 10 selling products in Q2?בקטע מקורות ידע, לוחצים על הוספת מקור. הדף Add data נפתח.
צריך לבחור את הטבלאות שהסוכן יתמקד בהן כשהוא יענה על שאלות.
לוחצים על הוספת נתונים. דף הנציג החדש נפתח מחדש.
לוחצים על שמירת הטיוטה כדי לשמור את ההתקדמות.
יצירת שאילתות מאומתות
אתם יכולים לבחור שאילתות מאומתות מתוך רשימה שנוצרה על ידי המערכת, או ליצור שאילתות משלכם.
כדי ליצור שאילתה מאומתת לסוכן לאינטראקציה עם נתונים, בצע את הפעולות הבאות:
נכנסים לדף Bigtable במסוף Google Cloud .
בוחרים מכונה מהרשימה.
בתפריט הניווט, לוחצים על נציגים.
לוחצים על הכרטיסייה קטלוג הסוכנים.
מאתרים את כרטיס הסוכן של סוכן הנתונים שרוצים לשנות. אם סוכן לאינטראקציה עם נתונים הוא טיוטה שלא פורסמה, לוחצים על Agent drafts.
כדי לפתוח את הסוכן לאינטראקציה עם נתונים בכלי לעריכת סוכנים, לוחצים על Open actions ואז על Edit בכרטיס הסוכן.
בקטע שאילתות מאומתות, לוחצים על הוספת שאילתה.
- בשדה Question, כותבים את השאלה שאפשר לענות עליה באמצעות השאילתה המאומתת.
- לוחצים על Generate SQL כדי ש-Gemini ייצור שאילתה מאומתת שתואמת לשאלה שהוספתם.
- לוחצים על Run ומוודאים שהשאילתה מחזירה את התוצאות שציפיתם להן.
- בודקים את התשובה ומשנים את השאילתה המאומתת, אם צריך.
- לוחצים על הוספה.
- לוחצים על שמירת הטיוטה כדי לשמור את ההתקדמות.
חוזרים על השלבים האלה כדי ליצור עוד שאילתות מאומתות.
הוספת תוויות לסוכנים לאינטראקציה עם נתונים
בקטע Agent Settings אפשר ליצור תוויות כדי לארגן את המשאבים של Google Cloud . תוויות הן צמדי מפתח/ערך שמאפשרים לקשר בין אובייקטים או ביניהם לבין משאבים אחרים של Google Cloud.
נכנסים לדף Bigtable במסוף Google Cloud .
בוחרים מכונה מהרשימה.
בתפריט הניווט, לוחצים על נציגים.
לוחצים על הכרטיסייה קטלוג הסוכנים.
מאתרים את כרטיס הסוכן של סוכן הנתונים שרוצים לשנות. אם סוכן לאינטראקציה עם נתונים הוא טיוטה שלא פורסמה, לוחצים על Agent drafts.
כדי לפתוח את הסוכן לאינטראקציה עם נתונים בכלי לעריכת סוכנים, לוחצים על Open actions ואז על Edit בכרטיס הסוכן.
בקטע Agent Settings, לוחצים על Add label. החלונית Manage labels נפתחת.
לוחצים על הוספת תווית.
בשדות key ו-value, מזינים את צמד המפתח/ערך של התווית.
אם רוצים להוסיף עוד תוויות, לוחצים שוב על הוספת תווית.
כדי למחוק תווית, לוחצים על מחיקה.
כשמסיימים, לוחצים על הוספה. דף הנציג החדש נפתח מחדש.
בקטע הבא מוסבר איך להעביר את הנציג למצב טיוטה או לפרסם אותו.
תצוגה מקדימה ופרסום של הנציג
בקטע Preview, מזינים שאלה לדוגמה בשדה Ask a question ולוחצים על Enter.
כדי לוודא שהסוכן לאינטראקציה עם נתונים מחזיר את הנתונים שאתם מצפים לקבל, בודקים את התשובה של הסוכן. אם התשובה לא תואמת לציפיות, משנים את ההגדרות בקטע Editor כדי לשפר את ההגדרות של הסוכן לאינטראקציה עם נתונים עד שמקבלים תשובות מספקות. אתם יכולים להמשיך לבדוק ולשנות את הנציג כדי לשפר את התוצאות שלו.
לוחצים על שמירת הטיוטה.
כדי להעביר את הסוכן לאינטראקציה עם נתונים למצב טיוטה, שבו אפשר לערוך אותו מחדש מאוחר יותר, לוחצים על Go back כדי לחזור לדף Agent Catalog. הסוכן נמצא עכשיו במצב טיוטה, ולכן הוא מופיע בקטע Agent drafts בכרטיסייה Agent Catalog.
כדי לפרסם את הנציג, נשארים בדף ליצירת הנציג וממשיכים לשלב הבא.
כדי לפרסם את הסוכן לאינטראקציה עם נתונים ולהפוך אותו לזמין לשימוש בפרויקט, לוחצים על Publish. בתיבת הדו-שיח Publishing channels, בוחרים את ערוצי הפרסום שבהם רוצים להשתמש. לוחצים על פרסום הנציג (או על פרסום העדכונים).
כשמפרסמים את הנציג, משתמשים אחרים שיש להם גישה לאותן טבלאות במסד הנתונים יכולים לראות את הנציג ולשוחח איתו, ולהיעזר בהוראות ובהקשר שיצרתם.
אפשר ליצור שיחות עם הסוכן לאינטראקציה עם נתונים באמצעות הדף Agents במסוף Google Cloud . אתם יכולים גם ליצור ממשק משתמש משלכם כדי לשוחח עם הסוכן לאינטראקציה עם נתונים באמצעות Conversational Analytics API.
אופציונלי: בתיבת הדו-שיח Your agent is published and ready to share., לוחצים על 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.
כדי לחזור לדף של הסוכן החדש, לוחצים על סגירה. אחרי ששומרים או מפרסמים את הנציג, הוא מופיע בקטלוג הנציגים.
ניהול סוכנים לאינטראקציה עם נתונים
אתם יכולים למצוא נציגים קיימים בכרטיסייה Agent Catalog, שמורכבת משלושה חלקים:
- כל הסוכנים: רשימה של כל הסוכנים שאתם יוצרים ומפרסמים, וסוכנים שאחרים יוצרים ומשתפים איתכם.
- הסוכנים שלי: רשימה של כל הסוכנים שאתם יוצרים ומפרסמים. אתם יכולים לשנות סוכנים שפורסמו ולשתף אותם עם אחרים.
טיוטות של סוכנים: סוכנים שעדיין לא פרסמתם. אי אפשר לשתף סוכנים במצב טיוטה.
עריכת סוכן נתונים
כדי לערוך סוכן לאינטראקציה עם נתונים:
נכנסים לדף Bigtable במסוף Google Cloud .
בוחרים מכונה מהרשימה.
בתפריט הניווט, לוחצים על נציגים.
לוחצים על הכרטיסייה קטלוג הסוכנים.
מאתרים את כרטיס הסוכן של סוכן הנתונים שרוצים לשנות. אם סוכן לאינטראקציה עם נתונים הוא טיוטה שלא פורסמה, לוחצים על Agent drafts.
כדי לפתוח את הסוכן לאינטראקציה עם נתונים בכלי לעריכת סוכנים, לוחצים על Open actions ואז על Edit בכרטיס הסוכן.
עורכים את ההגדרות של הסוכן לאינטראקציה עם נתונים לפי הצורך.
כדי לשמור את השינויים בלי לפרסם, לוחצים על שמירת טיוטה.
כדי לפרסם את הסוכן לאינטראקציה עם נתונים ולהפוך אותו לזמין לשימוש בפרויקט, לוחצים על Publish. בתיבת הדו-שיח Publishing channels, בוחרים את ערוצי הפרסום שבהם רוצים להשתמש. לוחצים על פרסום הנציג (או על פרסום העדכונים). בתיבת הדו-שיח Share, אתם יכולים לשתף את הנציג עם אחרים או ללחוץ על Close.
כדי לחזור לחלונית Agent Catalog, לוחצים על Go back.
שיתוף סוכן לאינטראקציה עם נתונים
כדי לשתף סוכן לאינטראקציה עם נתונים שפורסם: אי אפשר לשתף סוכנים בטיוטה.
נכנסים לדף Bigtable במסוף Google Cloud .
בוחרים מכונה מהרשימה.
בתפריט הניווט, לוחצים על נציגים.
לוחצים על הכרטיסייה קטלוג הסוכנים.
מאתרים את כרטיס הסוכן של סוכן הנתונים שרוצים לשנות.
כדי לפתוח את הסוכן לאינטראקציה עם נתונים בכלי לעריכת סוכנים, לוחצים על Open actions > ואז על Edit בכרטיס של הסוכן.
כדי לשתף את סוכן לאינטראקציה עם נתונים עם משתמשים אחרים, לוחצים על Share.
בחלונית 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.
כדי לחזור לדף העריכה של הנציג, לוחצים על סגירה.
כדי לחזור לחלונית Agent Catalog, לוחצים על Go back.
מחיקת סוכן נתונים
נכנסים לדף Bigtable במסוף Google Cloud .
בוחרים מכונה מהרשימה.
בתפריט הניווט, לוחצים על נציגים.
לוחצים על הכרטיסייה קטלוג הסוכנים.
מאתרים את כרטיס הסוכן של הסוכן לאינטראקציה עם נתונים שרוצים למחוק. אם סוכן לאינטראקציה עם נתונים הוא טיוטה שלא פורסמה, לוחצים על Agent drafts.
לוחצים על פתיחת הפעולות > מחיקה.
בתיבת הדו-שיח Delete agent? לוחצים על Delete. מחיקת הסוכן מסירה אותו מהפרויקט באופן סופי.
אחרי שמוחקים סוכן, השיחות הקיימות איתו זמינות במצב צפייה בלבד. אי אפשר לשאול את הסוכן שנמחק שאלות חדשות.
פרסום סוכן נתונים ב-Gemini Enterprise
כדי לפרסם סוכן לאינטראקציה עם נתונים, צריך שיתוף פעולה בין מנתחי נתונים, אדמינים ב-Gemini Enterprise ומשתמשים עסקיים. בקטע התפקידים הנדרשים מוסבר אילו תפקידים נדרשים למשתמשים האלה.
יצירה ופרסום של סוכן
כדי ליצור, לערוך ולפרסם נציג, פועלים לפי השלבים הבאים:
- יוצרים או עורכים את הסוכן לאינטראקציה עם נתונים ב-Bigtable.
- מפרסמים את הנציג. כשמפרסמים את הסוכן, בוחרים באפשרות Gemini Enterprise כאפשרות פרסום.
- כדי להעתיק את קובץ ה-JSON של נקודת הקצה של A2A, לוחצים על העתקת קובץ ה-JSON.
- משתפים את קובץ ה-JSON של נקודת הקצה של A2A ואת רשימת המשתמשים עם האדמין של Gemini Enterprise, כדי שהוא יוכל לרשום את הסוכן בהתאמה אישית במסוף Google Cloud ולהגדיר את הרשאות הגישה. מידע נוסף זמין במאמר הקצאת נציג.
- משתפים את הסוכן עם המשתמשים והקבוצות שצריכים גישה.
הקצאת סוכן
כדי להפוך נציג שפורסם לזמין למשתמשים במסוף Google Cloud , פועלים לפי השלבים הבאים:
במסוף Google Cloud , נכנסים לדף Gemini Enterprise.
לוחצים על שם האפליקציה שבה רוצים לרשום את הנציג.
לוחצים על Agents (סוכנים) > Add Agents (הוספת סוכנים).
בקטע 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 ישירות בסשן עם הסוכן הספציפי הזה לאינטראקציה עם נתונים ב-Bigtable.
- מפעילים את הסוכן באמצעות כתיבת
@mention(למשל@sales_pipeline_agent) בצ'אט הראשי של Gemini Enterprise. - אתם יכולים לשאול שאלה אנליטית כללית, כמו "מה המגמה בצנרת המכירות שלנו ב-3 החודשים האחרונים?", כדי לאפשר ל-Gemini Enterprise להפנות את השאילתה באופן אוטומטי לסוכן לאינטראקציה עם נתונים הרלוונטי.
אחרי שמוצאים את הנציג, אפשר להשתמש באחת מהשיטות הבאות כדי לתקשר איתו:
- משלימים את הכניסה החד-פעמית באמצעות OAuth כדי לבצע אימות מאובטח ב-Bigtable.
- לשאול שאלות בשפה טבעית. הסוכן לניתוח נתונים בשיחה מעבד את הבקשות שלכם ומעביר את התשובה בחזרה ל-Gemini Enterprise כטקסט, Markdown, תרשימים או טבלאות.
- היסטוריית השיחות נשמרת באופן אוטומטי, ואפשר לראות אותה בחלונית ההיסטוריה.
מיקומים
הניתוח של השיחות פועל באופן גלובלי, ואי אפשר לבחור באיזה אזור להשתמש.