Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

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

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

מוודאים שהחיוב מופעל בפרויקט Google Cloud .
מפעילים את Cloud SQL, את Data Analytics API עם Gemini ואת Gemini for Google Cloud APIs.
תפקידים שנדרשים להפעלת ממשקי API
כדי להפעיל ממשקי API, צריך את תפקיד ה-IAM 'אדמין של Service Usage' (roles/serviceusage.serviceUsageAdmin), שכולל את ההרשאה serviceusage.services.enable. איך מקצים תפקידים
הפעלת ממשקי ה-API

התפקידים הנדרשים

כדי לעבוד עם סוכני נתונים, אתם צריכים את אחד התפקידים הבאים ב-IAM של Conversational Analytics API:

אפשר להריץ שאילתות על נתונים ממקורות נתונים נתמכים של מסדי נתונים באמצעות השיטה QueryData: משתמש בשאילתת נתונים ב-Gemini Data Analytics ‏ (roles/geminidataanalytics.queryDataUser) ברמת הפרויקט.
יצירה, עריכה, שיתוף ומחיקה של כל סוכני הנתונים בפרויקט: Gemini בעלים של סוכן נתונים של ניתוח נתונים (roles/geminidataanalytics.dataAgentOwner) ברמת הפרויקט.
יצירת סוכני נתונים משלכם בפרויקט: Gemini Data Analytics Data Agent Creator (roles/geminidataanalytics.dataAgentCreator) ברמת הפרויקט. התפקיד הזה מקנה לכם באופן אוטומטי את התפקיד 'בעלים של סוכן נתונים' בסוכן נתונים של Gemini לניתוח נתונים, בסוכני הנתונים שאתם יוצרים.
צפייה בכל סוכני הנתונים בפרויקט ועריכה שלהם: Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor) ברמת הפרויקט.
הצגת כל סוכני הנתונים בפרויקט: Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer) ברמת הפרויקט.

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

משתמש IAM או חשבון שירות שנוספו למופע. מידע נוסף זמין במאמר ניהול משתמשים באמצעות אימות מסד נתונים ב-IAM ל-Cloud SQL.
התפקידים cloudsql.studioUser ו-cloudsql.instanceUser שניתנו למשתמש IAM ברמת הפרויקט. מידע נוסף זמין במאמר הוספת קשירת מדיניות IAM לפרויקט.
הרשאות למסד נתונים שניתנו למשתמש IAM או לחשבון שירות על ידי כניסה בתור המשתמש postgres.
```
GRANT ALL ON SCHEMA public TO public;
```
מידע נוסף זמין במאמר הענקת הרשאות למסד נתונים למשתמש IAM או לחשבון שירות ספציפיים.

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

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

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

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

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

הגדרת פרטים בסיסיים

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

מעבר אל Cloud SQL
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Agents (סוכנים).
לוחצים על הכרטיסייה סוכנים.
בוחרים מסד נתונים ונכנסים באמצעות חשבון IAM.
לוחצים על סוכן חדש. ייפתח הדף New agent (סוכן חדש).
בקטע Editor, בשדה Agent name, מזינים שם תיאורי לסוכן הנתונים – לדוגמה, Q4 sales data או User activity logs.
בשדה Agent description (תיאור הסוכן), מזינים תיאור של סוכן הנתונים. תיאור טוב מסביר מה הסוכן עושה, באילו נתונים הוא משתמש ועוזר לכם להחליט אם זהו סוכן הנתונים הנכון לשיחה – למשל, What are the top 10 selling products in Q2?
בקטע מקורות מידע, לוחצים על הוספת מקור. הדף הוספת נתונים ייפתח.
בוחרים את הטבלאות שהסוכן יעזר בהן כשהוא יענה על שאלות. כדי לראות מקורות ידע נוספים, לוחצים על הצגת עוד.
לוחצים על הוספה. דף הנציג החדש ייפתח מחדש.

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

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

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

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

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

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

בכרטיסייה Agent Catalog, פותחים את הסוכן שרוצים להתאים אישית.
לוחצים על עריכת סוכן.
בקטע מקורות מידע, מוצאים את הטבלה שרוצים להתאים אישית ולוחצים על התאמה אישית.
מזינים תיאור לטבלה.
כדי לערוך את התיאור של שדה מסוים, לוחצים על edit עריכה לצד השדה. החלונית עריכת שדה תיפתח.
1. בשדה ID (מזהה), מזינים תיאור של השדה.
2. כדי לשמור את תיאור השדה, לוחצים על עדכון.
כדי לשמור את התיאור ואת העדכונים בשדות, לוחצים על עדכון. דף הסוכן החדש ייפתח מחדש.
חוזרים על השלבים האלה לכל טבלה שרוצים להתאים אישית.

הוספת תוויות לסוכני נתונים

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

בכרטיסייה Agent Catalog (קטלוג הסוכנים), פותחים את הסוכן שרוצים להוסיף לו תווית.
לוחצים על עריכת סוכן.
בקטע Agent Settings (הגדרות הסוכן), לוחצים על Add label (הוספת תווית). נפתח החלונית ניהול תוויות.
לוחצים על הוספת תווית.
בשדות מפתח וערך, מזינים את צמד המפתח/ערך של התווית.
אם רוצים להוסיף עוד תוויות, לוחצים שוב על הוספת תווית.
כדי למחוק תווית, לוחצים על מחיקה.
כשמסיימים, לוחצים על הוספה. דף הנציג החדש ייפתח מחדש.

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

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

בקטע תצוגה מקדימה, כותבים שאלה לדוגמה בשדה שאלת שאלה ומקישים על Enter.

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

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

אפשר ליצור שיחות עם סוכן הנתונים באמצעות הדף Agents במסוף Google Cloud . אפשר גם ליצור ממשק משלכם כדי לשוחח עם סוכן הנתונים באמצעות Conversational Analytics API.
אופציונלי: בתיבת הדו-שיח הסוכן שלך פורסם, לוחצים על שיתוף כדי לשתף את סוכן הנתונים עם משתמשים אחרים.
1. בחלונית Share permissions, לוחצים על Add principal.
2. בשדה New principals, מזינים חשבון משתמש אחד או יותר.
3. לוחצים על הרשימה Select a role (בחירת תפקיד).
4. ברשימה תפקיד, בוחרים אחד מהתפקידים הבאים:
  - משתמש בסוכן הנתונים של Gemini Data Analytics ‏(roles/geminidataanalytics.dataAgentUser): מעניק הרשאה לצ'אט עם סוכן הנתונים.
  - עורך סוכן הנתונים של Gemini Data Analytics‏ (roles/geminidataanalytics.dataAgentEditor): מאפשר לערוך את סוכן הנתונים.
  - צפייה בסוכן הנתונים של Gemini Data Analytics‏ (roles/geminidataanalytics.dataAgentViewer): הרשאה לצפייה בסוכן הנתונים.
לוחצים על Save.
כדי לחזור לדף החדש של הסוכן, לוחצים על סגירה. אחרי ששומרים או מפרסמים את הסוכן, אפשר לראות אותו בקטלוג הסוכנים.

ניהול סוכני נתונים

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

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

עריכה של סוכן נתונים

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

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

מעבר אל Cloud SQL
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Agents (סוכנים).
נכנסים אל סוכנים באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).
לוחצים על הכרטיסייה קטלוג הסוכנים.
מאתרים את כרטיס הסוכן של סוכן הנתונים שרוצים לשנות.
כדי לפתוח את סוכן הנתונים בעורך הסוכנים, לוחצים על Open actions (פתיחת פעולות) ואז על Edit (עריכה) בכרטיס הסוכן.
עורכים את ההגדרות של סוכן הנתונים לפי הצורך.
כדי לשמור את השינויים בלי לפרסם אותם, לוחצים על שמירה.
כדי לפרסם את השינויים, לוחצים על פרסום. בתיבת הדו-שיח שיתוף, אפשר לשתף את הסוכן עם אחרים או ללחוץ על ביטול.
כדי לחזור לחלונית סוכנים, לוחצים על חזרה.

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

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

מעבר אל Cloud SQL
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Agents (סוכנים).
נכנסים אל סוכנים באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).
לוחצים על הכרטיסייה קטלוג הסוכנים.
מאתרים את כרטיס הסוכן של סוכן הנתונים שרוצים לשנות.
כדי לפתוח את סוכן הנתונים בעורך הסוכנים, לוחצים על פתיחת פעולות > לוחצים על עריכה בכרטיס הסוכן.
כדי לשתף את סוכן הנתונים עם משתמשים אחרים, לוחצים על שיתוף.
בחלונית Share permissions, לוחצים על Add principal.
בשדה Add principals, מזינים חשבון משתמש אחד או יותר.
לוחצים על בחירת תפקיד.
ברשימה Role, בוחרים באחד מהתפקידים הבאים:
- משתמש סוכן הנתונים של Gemini Data Analytics ‏(roles/geminidataanalytics.dataAgentUser): מעניק הרשאה לצ'אט עם סוכן הנתונים.
- עורך סוכן הנתונים של Gemini Data Analytics‏ (roles/geminidataanalytics.dataAgentEditor): מאפשר לערוך את סוכן הנתונים.
- צפייה בסוכן הנתונים של Gemini Data Analytics‏ (roles/geminidataanalytics.dataAgentViewer): מאפשרת צפייה בסוכן הנתונים.
לוחצים על Save.
כדי לחזור לדף העריכה של הסוכן, לוחצים על סגירה.
כדי לחזור לחלונית סוכנים, לוחצים על חזרה.

מחיקה של סוכן נתונים

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

מעבר אל Cloud SQL
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Agents (סוכנים).
נכנסים אל סוכנים באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).
בוחרים בכרטיסייה קטלוג הסוכנים.
בקטע סוכנים בכרטיסייה קטלוג הסוכנים, מאתרים את כרטיס הסוכן של סוכן הנתונים שרוצים למחוק.
לוחצים על פתיחת פעולות > מחיקה.
בתיבת הדו-שיח למחוק את הסוכן?, לוחצים על מחיקה. מחיקת הסוכן לצמיתות תגרום להסרתו מהפרויקט.

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

מיקומים

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