יצירת סוכני נתונים

תצוגה מקדימה

השימוש בתכונה הזו כפוף לתנאי השימוש במוצרים בשלב טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות בגרסת טרום-GA הוא "כפי שהן" (As is), ויכול להיות שהתמיכה בהן תהיה מוגבלת. אתם יכולים לקרוא מידע נוסף בקטע תיאור שלבי ההשקה.

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

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

למפתחי אפליקציות, הסוכנים האלה מספקים את היתרונות הבאים:

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

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

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

2. מפעילים את Cloud SQL, את Data Analytics API עם Gemini ואת Gemini for Google Cloud APIs, אם הם עדיין לא מופעלים.

   התפקידים שנדרשים כדי להפעיל ממשקי 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 שנוספו למכונה. מידע נוסף זמין במאמר ניהול משתמשים באמצעות אימות מסד נתונים של IAM ל-Cloud SQL. התפקידים cloudsql.studioUser ו-cloudsql.instanceUser שניתנו למשתמש ב-IAM ברמת הפרויקט. מידע נוסף זמין במאמר הוספת קישור למדיניות IAM בפרויקט. אופציונלי: אם אתם משתמשים בקבוצות הקשר (גרסת טרום-השקה (Preview)) עם הסוכן לאינטראקציה עם נתונים של מסד הנתונים, כדי ליצור, להעלות ולנהל קבוצות הקשר: התפקיד "עריכה של Dataplex Catalog"‏ (roles/dataplex.catalogEditor) או "אדמין של Dataplex Catalog"‏ (roles/dataplex.catalogAdmin) שמוקצה למשתמש ה-IAM ברמת הפרויקט. מידע נוסף זמין במאמר הרשאות לקבוצות הקשר. הרשאות למסד נתונים שניתנו למשתמש או לחשבון שירות ב-IAM באמצעות כניסה בתור המשתמש postgres. GRANT ALL ON SCHEMA public TO public; מידע נוסף זמין במאמר הענקת הרשאות למסד נתונים למשתמש 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).

כשמנהלים את הגישה למשאבים של מסד נתונים ב-Cloud SQL ל-PostgreSQL, צריך להביא בחשבון את שכבות ההרשאות הבאות:

• ‫Google Cloud IAM: שליטה בגישה למכונה של מסד הנתונים כמשאב בענן. זה כולל הרשאות להתחבר, לנהל את המכונה ולהריץ שאילתות SQL, למשל באמצעות ההרשאה executeSql.
• הרשאות למסד הנתונים: שליטה בגישה לאובייקטים במסד הנתונים, כמו טבלאות, תצוגות וסכימות. הניהול שלהם מתבצע באמצעות פקודות SQL כמו GRANT ומערכות של משתמשים ותפקידים שספציפיות למסד הנתונים.

ב-Cloud SQL ל-PostgreSQL, צריך תפקידי IAM מתאימים ב-Cloud SQL כדי להתחבר למכונה ולקבל הרשאה לשלוח שאילתות. כדי לבצע פעולות באובייקטים כמו טבלאות ותצוגות, למשתמש שמקושר למסד הנתונים צריכות להיות ההרשאות הנדרשות שניתנו באמצעות מערכת GRANT של Cloud SQL ל-PostgreSQL. מידע נוסף זמין במאמר מידע על משתמשים ותפקידים ב-PostgreSQL. אם הנציג משתמש בחשבון שירות, אתם יכולים להקצות לו תפקיד במסד הנתונים. לדוגמה, ראו ניהול משתמשים באמצעות אימות מסד נתונים של IAM.

יצירת סוכן נתונים

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

הגדרת היסודות

1. במסוף Google Cloud , נכנסים לדף Cloud SQL ל-PostgreSQL.

   כניסה ל-Cloud SQL

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

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

4. לוחצים על הכרטיסייה נציגים.

5. בוחרים מסד נתונים ונכנסים באמצעות חשבון IAM.

6. לוחצים על סוכן חדש. הדף New agent נפתח.

7. בקטע Editor, בשדה Agent name, מזינים שם תיאורי לסוכן לאינטראקציה עם נתונים, לדוגמה Q4 sales data או User activity logs.

8. בשדה Agent description, כותבים תיאור של הסוכן לאינטראקציה עם נתונים. תיאור טוב מסביר מה סוכן לאינטראקציה עם נתונים עושה, באילו נתונים הוא משתמש ועוזר לכם לקבוע אם זה סוכן לאינטראקציה עם נתונים המתאים לשיחה. לדוגמה, What are the top 10 selling products in Q2?

9. בקטע מקורות ידע, לוחצים על הוספת מקור. הדף Add data נפתח.

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

11. לוחצים על הוספת נתונים. דף הנציג החדש נפתח מחדש.

12. לוחצים על שמירת הטיוטה כדי לשמור את ההתקדמות.

התאמה אישית של תיאורי טבלאות ושדות

כדי לשפר את הדיוק של סוכן לאינטראקציה עם נתונים, אפשר לספק מטא-נתונים נוספים של הטבלה. רק הסוכן לאינטראקציה עם נתונים משתמש במטא-נתונים האלה, והם לא משפיעים על טבלת המקור. אפשר להוסיף את המטא-נתונים הבאים:

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

כשמוסיפים תיאורים של טבלאות ושדות, מומלץ לפעול לפי השיטות הבאות:

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

כדי להתאים אישית את התיאורים של הטבלאות והשדות של הנציג:

1. בכרטיסייה קטלוג הסוכנים, פותחים את הסוכן שרוצים להתאים אישית.
2. לוחצים על עריכת הנציג.
3. בקטע מקורות ידע, מוצאים את הטבלה שרוצים להתאים אישית ולוחצים על התאמה אישית.
4. מוסיפים תיאור בשדה תיאור הטבלה או מאשרים את ההצעה של Gemini.
5. בקטע Fields, בודקים את התיאורים שהציע Gemini לעמודות בטבלה.
6. ניהול התיאורים המוצעים לשדות:
   • כדי לאשר את ההצעות, בוחרים את התיאורים הרצויים ולוחצים על אישור ההצעות.
   • כדי לדחות הצעות, בוחרים את התיאורים הרצויים ולוחצים על Reject suggestions.
7. כדי לערוך תיאור של שדה, לוחצים על Edit לצד השדה.
   1. בתיאור, מזינים תיאור של השדה.
   2. לוחצים על עדכון כדי לשמור את השינויים.
8. לוחצים על עדכון כדי לשמור את ההתאמה האישית של הטבלה.
9. חוזרים על השלבים האלה בכל טבלה שרוצים להתאים אישית.

יצירת שאילתות מאומתות

הערה: אפשר להוסיף שאילתות מאומתות רק במצב "מודרך"

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

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

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

1.  In **Review suggested verified queries**, review the suggested verified queries. 
1.  Select the quereies that apply to your use case.
1.  Click **Add** to add the queries to the context.

Note: To edit the suggested queries, expand the suggested query and click **Edit**.

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

   1. בשדה Question, כותבים את השאלה שאפשר לענות עליה באמצעות השאילתה המאומתת.
   2. לוחצים על Generate SQL כדי ש-Gemini ייצור שאילתה מאומתת שתואמת לשאלה שהוספתם.
   3. לוחצים על Run ומוודאים שהשאילתה מחזירה את התוצאות שציפיתם להן.
   4. בודקים את התשובה ומשנים את השאילתה המאומתת, אם צריך.
   5. לוחצים על הוספה.

2. חוזרים על השלבים האלה כדי ליצור עוד שאילתות מאומתות.

הוספת תוויות לסוכנים לאינטראקציה עם נתונים

בקטע Agent Settings אפשר ליצור תוויות כדי לארגן את המשאבים של Google Cloud . תוויות הן צמדי מפתח/ערך שמאפשרים לקשר בין אובייקטים או ביניהם לבין משאבים אחרים של Google Cloud.

1. במסוף Google Cloud , נכנסים לדף Cloud SQL ל-PostgreSQL.

   כניסה ל-Cloud SQL

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

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

4. נכנסים ל-Conversations באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).

5. לוחצים על הכרטיסייה קטלוג הסוכנים.

6. מאתרים את כרטיס הסוכן של סוכן הנתונים שרוצים לשנות.

7. כדי לפתוח את הסוכן לאינטראקציה עם נתונים בכלי לעריכת סוכנים, לוחצים על Open actions ואז על Edit בכרטיס הסוכן.

8. בקטע Agent Settings, לוחצים על Add label. החלונית Manage labels נפתחת.

9. לוחצים על הוספת תווית.

10. בשדות key ו-value, מזינים את צמד המפתח/ערך של התווית.

11. אם רוצים להוסיף עוד תוויות, לוחצים שוב על הוספת תווית.

12. כדי למחוק תווית, לוחצים על מחיקה.

13. כשמסיימים, לוחצים על הוספה. דף הנציג החדש נפתח מחדש.

בקטע הבא מוסבר איך להעביר את הנציג למצב טיוטה או לפרסם אותו.

תצוגה מקדימה ופרסום של הנציג

1. בקטע Preview, מזינים שאלה לדוגמה בשדה Ask a question ולוחצים על Enter.

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

2. לוחצים על שמירת הטיוטה.

3. כדי להעביר את הסוכן לאינטראקציה עם נתונים למצב טיוטה, שבו אפשר לערוך אותו מחדש מאוחר יותר, לוחצים על Go back כדי לחזור לדף Agent Catalog. הסוכן נמצא עכשיו במצב טיוטה, ולכן הוא מופיע בקטע My draft agents בכרטיסייה Agent Catalog.

   כדי לפרסם את הנציג, נשארים בדף ליצירת הנציג וממשיכים לשלב הבא.

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

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

   אתם יכולים ליצור שיחות עם הסוכן לאינטראקציה עם נתונים באמצעות הדף Conversations במסוף Google Cloud . אתם יכולים גם ליצור ממשק משתמש משלכם כדי לשוחח עם הסוכן לאינטראקציה עם נתונים באמצעות Conversational Analytics API.

5. אופציונלי: בתיבת הדו-שיח Your agent is published and ready to share., לוחצים על Share כדי לשתף את סוכן לאינטראקציה עם נתונים עם משתמשים אחרים.

   1. בחלונית Share permissions, לוחצים על Add principal.
   2. בשדה New principals, מזינים חשבון משתמש אחד או יותר.
   3. לוחצים על הרשימה Select a role.
   4. ברשימה 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): מעניק הרשאה לצפות בסוכן לאינטראקציה עם נתונים.
   5. לוחצים על Save.

6. אופציונלי: אתם יכולים לפרסם את הסוכן לאינטראקציה עם נתונים ב-Gemini Enterprise. מידע נוסף זמין במאמר פרסום סוכן לאינטראקציה עם נתונים ב-Gemini Enterprise.

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

ניהול סוכנים לאינטראקציה עם נתונים

אתם יכולים למצוא נציגים קיימים בכרטיסייה Agent Catalog, שמורכבת משלושה חלקים:

הסוכנים שלי: רשימה של כל הסוכנים שאתם יוצרים ומפרסמים. אתם יכולים לשנות סוכנים שפורסמו ולשתף אותם עם אחרים.

הסוכנים שלי שבמצב טיוטה: סוכנים שעדיין לא פרסמתם. אי אפשר לשתף סוכנים במצב טיוטה.

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

עריכת סוכן נתונים

כדי לערוך סוכן לאינטראקציה עם נתונים:

1. במסוף Google Cloud , נכנסים לדף Cloud SQL ל-PostgreSQL.

   כניסה ל-Cloud SQL

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

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

4. נכנסים ל-Conversations באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).

5. לוחצים על הכרטיסייה קטלוג הסוכנים.

6. מאתרים את כרטיס הסוכן של סוכן הנתונים שרוצים לשנות.

7. כדי לפתוח את הסוכן לאינטראקציה עם נתונים בכלי לעריכת סוכנים, לוחצים על Open actions ואז על Edit בכרטיס הסוכן.

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

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

10. כדי לפרסם את הסוכן לאינטראקציה עם נתונים ולהפוך אותו לזמין לשימוש בפרויקט, לוחצים על Publish. בתיבת הדו-שיח Share, אתם יכולים לשתף את הנציג עם אחרים או ללחוץ על Close.

11. כדי לחזור לחלונית Conversations, לוחצים על Go back.

שיתוף סוכן לאינטראקציה עם נתונים

כדי לשתף סוכן לאינטראקציה עם נתונים שפורסם: אי אפשר לשתף סוכנים בטיוטה.

1. במסוף Google Cloud , נכנסים לדף Cloud SQL ל-PostgreSQL.

   כניסה ל-Cloud SQL

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

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

4. נכנסים ל-Conversations באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).

5. לוחצים על הכרטיסייה קטלוג הסוכנים.

6. מאתרים את כרטיס הסוכן של סוכן הנתונים שרוצים לשנות.

7. כדי לפתוח את הסוכן לאינטראקציה עם נתונים בכלי לעריכת סוכנים, לוחצים על Open actions > ואז על Edit בכרטיס של הסוכן.

8. כדי לשתף את סוכן לאינטראקציה עם נתונים עם משתמשים אחרים, לוחצים על Share.

9. בחלונית Share permissions, לוחצים על Add principal.

10. בשדה Add principals, מזינים חשבון משתמש אחד או יותר.

11. לוחצים על בחירת תפקיד.

12. ברשימה 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): הרשאה לצפות בסוכן הנתונים.

13. לוחצים על Save.

14. כדי לחזור לדף העריכה של הנציג, לוחצים על סגירה.

15. כדי לחזור לחלונית Conversations, לוחצים על Go back.

מחיקת סוכן נתונים

1. במסוף Google Cloud , נכנסים לדף Cloud SQL ל-PostgreSQL.

   כניסה ל-Cloud SQL

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

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

4. נכנסים ל-Conversations באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).

5. לוחצים על הכרטיסייה קטלוג הסוכנים.

6. מאתרים את כרטיס הסוכן של הסוכן לאינטראקציה עם נתונים שרוצים למחוק.

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

8. בתיבת הדו-שיח Delete agent?‎ לוחצים על Delete. מחיקת הסוכן מסירה אותו מהפרויקט באופן סופי.

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

פרסום סוכן נתונים ב-Gemini Enterprise

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

יצירה ופרסום של סוכן

כדי ליצור, לערוך ולפרסם נציג, פועלים לפי השלבים הבאים:

1. יוצרים או עורכים את הסוכן לאינטראקציה עם נתונים ב-Cloud SQL ל-PostgreSQL.
2. מפרסמים את הנציג. כשמפרסמים את הסוכן, בוחרים באפשרות Gemini Enterprise כאפשרות פרסום.
3. כדי להעתיק את קובץ ה-JSON של נקודת הקצה של A2A, לוחצים על העתקת קובץ ה-JSON.
4. משתפים את קובץ ה-JSON של נקודת הקצה של A2A ואת רשימת המשתמשים עם האדמין של Gemini Enterprise, כדי שהוא יוכל לרשום את הסוכן בהתאמה אישית במסוף Google Cloud ולהגדיר את הרשאות הגישה. מידע נוסף זמין במאמר הקצאת נציג.
5. משתפים את הסוכן עם המשתמשים והקבוצות שצריכים גישה.

הקצאת סוכן

כדי להפוך נציג שפורסם לזמין למשתמשים במסוף Google Cloud , פועלים לפי השלבים הבאים:

1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise.

   Gemini Enterprise

2. לוחצים על שם האפליקציה שבה רוצים לרשום את הנציג.

3. לוחצים על Agents (סוכנים) > Add Agents (הוספת סוכנים).

4. בקטע Choose an agent type, לוחצים על Add באפשרות Custom agent via A2A.

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

6. לוחצים על תצוגה מקדימה של פרטי הנציג > הבא.

7. כדי לאפשר לנציג לגשת למשאבים של Google Cloud בשמכם, בצעו את הפעולות הבאות:

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

   2. בשדה 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 במזהה הלקוח שיצרתם בקטע הגדרת פרטי ההרשאה.

   3. בשדה Token URI, מזינים את הערך הבא:

      https://oauth2.googleapis.com/token

   4. בשדה Scopes, מזינים את הערך הבא:

      https://www.googleapis.com/auth/cloud-platform

8. לוחצים על סיום.

9. משתפים את הנציג עם המשתמשים או הקבוצות.

מידע נוסף זמין במאמר רישום וניהול של סוכני A2A.

איך מוצאים סוכן ומשתמשים בו

אתם יכולים למצוא סוכן לאינטראקציה עם נתונים ולהשתמש בו ב-Gemini Enterprise בכל אחת מהדרכים הבאות:

• מוצאים את הסוכן בגלריית הסוכנים ומתחילים צ'אט ייעודי.
• משתמשים בכתובת ה-URL הייעודית של הסוכן כדי לפתוח את Gemini Enterprise ישירות בסשן עם הסוכן הספציפי הזה לאינטראקציה עם נתונים ב-Cloud SQL ל-PostgreSQL.
• מפעילים את הסוכן באמצעות כתיבת @mention (למשל @sales_pipeline_agent) בצ'אט הראשי של Gemini Enterprise.
• אתם יכולים לשאול שאלה אנליטית כללית, כמו "מה המגמה בצנרת המכירות שלנו ב-3 החודשים האחרונים?", כדי לאפשר ל-Gemini Enterprise להפנות את השאילתה באופן אוטומטי לסוכן לאינטראקציה עם נתונים הרלוונטי.

אחרי שמוצאים את הנציג, אפשר להשתמש באחת מהשיטות הבאות כדי לתקשר איתו:

• משלימים את הכניסה החד-פעמית באמצעות OAuth כדי לאמת באופן מאובטח את Cloud SQL ל-PostgreSQL.
• לשאול שאלות בשפה טבעית. הסוכן לניתוח נתונים בשיחה מעבד את הבקשות שלכם ומעביר את התשובה בחזרה ל-Gemini Enterprise כטקסט, Markdown, תרשימים או טבלאות.
• היסטוריית השיחות נשמרת באופן אוטומטי, ואפשר לראות אותה בחלונית ההיסטוריה.

מיקומים

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

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

• מידע נוסף על ניתוח נתונים של שיחות ב-Cloud SQL ל-PostgreSQL
• מידע נוסף על Conversational Analytics API
• ניתוח נתונים באמצעות שיחות.
• איך התפקיד "צפייה בסוכן הנתונים של Gemini לניתוח נתונים" (roles/geminidataanalytics.dataAgentViewer) נותן הרשאה לצפות בסוכן הנתונים