תכנון סוכנים ב-Agent Studio

תצוגה מקדימה

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

הקשר לתנאים אחרים. התכונה 'סוכני עיצוב' ב-Agent Studio עוזרת ללקוחות לעצב 'סוכני AI' כפי שמוגדר בתנאים הספציפיים לשירות, ולכן חלים עליה התנאים הספציפיים לשירות של 'שירותי AI אקטיבי'. כשמשתמשים בחיפוש Google ככלי ב-Agent Studio, חל גם הסעיף שכותרתו 'הארקה באמצעות חיפוש Google' בתנאים הספציפיים לשירות, למעט ההתייחסות הראשונה ל-Gemini Enterprise או ל-Agentspace' בתת-הסעיף (iv) של הסעיף 'שירותי AI מבוססי-סוכנים', שמוחלפת ב-'פלטפורמת הסוכנים של Gemini Enterprise'. לפני שמשתמשים בתכונה הזו, חשוב לעיין בתנאים של כל כלי אחר שבו משתמשים ב-Agent Studio ולוודא שהסוכן מתאים לפריסה ב-Agent Runtime.

בדף הזה מוסבר איך להשתמש ב-Agent Studio במסוףGoogle Cloud .

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

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

מגדירים את הסביבה

לפני שמשתמשים ב-Agent Studio, צריך להגדיר אתGoogle Cloud.

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

כדי לקבל את ההרשאות שנדרשות לשימוש ב-Agent Studio, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד משתמש בפלטפורמת סוכנים (roles/aiplatform.user) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

יצירת סוכן

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

כדי לעצב ולבדוק סוכן ב-Agent Studio:

1. נכנסים לדף Agents במסוף Google Cloud .
   

   כניסה לדף Agents

2. לוחצים על יצירת סוכן כדי לפתוח את אזור העריכה של Agent Studio לסוכן חדש.

3. תכננו ושמרו את הסוכן שלכם בלוח הציור של Agent Studio. אפשר לעבור בין הכרטיסיות הבאות:

   • ‫Flow: יצירת הסוכן הראשי והסוכנים המשניים באמצעות ייצוג חזותי של תהליך העבודה והלוגיקה של הסוכן.

     1. לוחצים על סוכן כדי לפתוח את החלונית פרטים של הסוכן הזה. אפשר גם ללחוץ על הוספת סוכן משנה (+) כדי להוסיף סוכני משנה.

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

        1. שם: מוסיפים שם שיעזור לזהות את הסוכן.

        2. תיאור: סיכום של מטרת הסוכן.

        3. הוראות: מוסיפים הוראות שינחו את הסוכן.

        4. מודל: בוחרים את המודל שיפעיל את הסוכן.

        5. כלים: לוחצים על הוספת כלים (+) כדי להוסיף כלים שיאפשרו לסוכן לבצע משימות. מידע נוסף מופיע במאמר בנושא הגדרה והוספה של כלים.

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

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

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

אחרי שהסוכן מוכן, אפשר לפרוס אותו ישירות מ-Agent Studio. מידע נוסף זמין במאמר פריסת סוכן מ-Agent Studio.

שמירת סוכן

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

1. באזור העריכה של Agent Studio, לוחצים על שמירה.

2. בתיבת הדו-שיח שמירת הסוכן, מזינים שם לסוכן.

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

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

הגדרה והוספה של כלים ב-Agent Studio

אתם יכולים להגדיר את הכלים הבאים לסוכן:

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

• הקשר של כתובת URL: מאפשר למודל לנתח כתובות URL מהנחיות שנשלחות לסוכן. ההגדרה הזו מופעלת כברירת מחדל.

• מאגר נתונים של חיפוש מבוסס סוכנים: לוחצים על הוספה (+) כדי לאפשר לסוכן לגשת למידע שעבר אינדוקס במאגר הנתונים של חיפוש מבוסס סוכנים.

  • מספר הפרויקט: מספר Google Cloud הפרויקט שמשויך למאגר הנתונים של חיפוש מבוסס סוכנים. הצגת מספר הפרויקט

  • מיקום: המיקום של מאגר הנתונים.

  • מזהה מאגר הנתונים: מזהה הנתונים שרוצים לכלול ב-Firestore במצב Datastore ‏ (Datastore). איך רואים את רשימת מאגרי הנתונים והמזהים שלהם

  • מזהה אוסף: מזהה האוסף של הנתונים שרוצים לכלול. הצגת רשימה של מאגרי הנתונים ומזהי האוספים אם ב<b>מאגר הנתונים</b> שלכם אין מזהה קולקציה, מזינים את הערך default_collection.

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

  1. נכנסים לדף IAM במסוף Google Cloud .
     

     כניסה לדף 'ניהול הזהויות והרשאות הגישה' (IAM)

  2. לוחצים על הענקת גישה.

  3. בשדה New principals, מזינים את הפרטים הבאים של חשבון השירות:

     [e-mail].

  4. לוחצים על + הוספת תפקידים. מחפשים את האפשרות Discovery Engine User (משתמש ב-Discovery Engine) ולוחצים עליה. לוחצים על אישור ואז על שמירה.

• שרת MCP: חיבור ישיר לשרת Model Context Protocol‏ (MCP).

  1. כדי להוסיף כלי MCP על ידי התחברות לשרת MCP, לוחצים על הוספה (+) לצד שרת MCP.
  2. השם המוצג של MCP: מזינים שם לשרת ה-MCP.
  3. כתובת URL של נקודת הקצה: מזינים כתובת URL של נקודת הקצה של שרת ה-MCP.
  4. אימות: מילוי אוטומטי של ללא. ‫Agent Studio תומך רק בשרתי MCP שלא נדרש בהם אימות.

  הסוכן יכול להשתמש בכל הכלים בשרת ה-MCP המחובר.

פריסת סוכן מ-Agent Studio

אחרי שיוצרים סוכן ורואים אותו בתצוגה מקדימה, אפשר לפרוס אותו בסביבת הייצור. כדי לפרוס סוכן מ-Agent Studio:

1. בדף הרשימה סוכנים, לוחצים על הסוכן שרוצים לפרוס. מוצג דף הפרטים של הסוכן שנבחר.
2. לוחצים על Deploy (פריסה) כדי לפתוח את תיבת הדו-שיח Deploy to an Agent Runtime instance (פריסה למופע בזמן ריצה של סוכן).

3. (אופציונלי) עורכים את השם המוצג או את התיאור של הסוכן.

4. בוחרים אזור פריסה מתוך רשימת האזורים הזמינים ולוחצים על אישור.

5. לוחצים על פריסה.

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

צפייה בסוכן שהופעל

כדי לראות את הסוכן שפרסתם:

1. נכנסים לדף Deployments של Agent Platform במסוף Google Cloud .
   

   מעבר לדף Deployments

2. אפשר להשתמש ברשימה אזור כדי לסנן לפי אזור הפריסה.

3. סוכנים שפרסתם והם חלק מהפרויקט שנבחר יופיעו ברשימה.

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

5. לוחצים על הכרטיסייה Playground כדי לבדוק את הסוכן.

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

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