הוספת סוכן ילד

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

יצירת סוכן ילד

1. עבור אל הדף ' סוכנים' של הסוכן הראשי ובחר הוסף סוכן.

2. בחר סוכן ילד חדש.

3. הזן שם ייחודי עבור סוכן הילד החדש שלך.

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

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

5. הזן הוראות ברורות שברצונך שהסוכן שלך יעקוב אחריהן בעת הפעלתן. כדי להפנות אל כלים, משתנים או להוסיף נוסחאות Power Fx בהוראות שלך, הזן קו נטוי (/) ובחר את האפשרות הרצויה מהתפריט שמופיע.

   חשוב

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

6. אם תרצה, הוסף ידע וכלים שרק סוכן צאצא זה יכול להשתמש בהם:

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

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

8. בחר שמור.

ניהול יחידות קלט ופלט

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

קביעת תצורה של קלט ואיסוף קלט

1. מהדף 'סוכן הורה ' , בחר את סוכן הילד שלך.

2. גלול למקטע Inputs .

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

4. בחר סוג נתונים.

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

6. בחר שמור.

תצורות קלט מתקדמות

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

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

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

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

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

הגדרת אופן הפעולה של סוכן האב לאחר השלמת סוכן המשנה

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

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

הגדרת פלטים

1. עבור אל הפרטים של סוכן הילד.

2. גלול אל המקטע Outputs.

3. כדי לראות את רשימת הפלטים הנוכחית, הרחב את המקטע Advanced בתוך המקטע Outputs.

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

5. בחר סוג נתונים.

6. בחר שמור.

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

קבע מתי להשתמש בסוכן שלך

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

אירוע	תיאור
התקבלה הודעה	מתבצעת קריאה כאשר מתקבלת פעילות הודעות – סוג הפעילות הנפוץ ביותר. התקבל כאשר משתמש מקליד או אומר משהו לסוכן. כברירת מחדל, הסוכן מגיב להודעות כלשהן. כדי להגביל את תגובת הסוכן לסוג מסוים של הודעה, השתמש ברשימה סוג פעילותתחת פרטים נוספים.
מתרחש אירוע לקוח מותאם אישית	נקרא כאשר מתקבלת פעילות אירוע. כברירת מחדל, הסוכן מגיב לכל אירוע. כדי להגביל את תגובת הסוכן לאירוע ספציפי, השתמש במאפיין שם אירוע תחת פרטים נוספים.
מתרחשת פעילות	מתבצעת קריאה כאשר מתקבלת פעילות מכל סוג. כדי להגביל את תגובת הסוכן לסוג ספציפי של פעילות, השתמש ברשימה סוג פעילותתחת פרטים נוספים.
השיחה משתנה	מתבצעת קריאה כאשר מתקבלת פעילות עדכון שיחה. לדוגמה, Teams שולח פעילות מסוג זה כאשר משתמש מצטרף לשיחה.
מופעל	נקרא כאשר מתקבלת פעילות קריאה. בדרך כלל מתקבלים מערוץ Teams - לדוגמה, כאשר המשתמש מקיים אינטראקציה עם הודעה או הרחבת חיפוש ב- Teams.
מנותב מחדש אל	נקרא כאשר הסוכן נקרא במפורש מתוך נושא.
המשתמש אינו פעיל במשך זמן מה	מתבצעת קריאה כאשר המשתמש לא קיים אינטראקציה עם הסוכן הראשי לאחר פרק זמן מוגדר. בחר את סף חוסר הפעילות הרצוי מהרשימה משך זמן של חוסר פעילות תחת פרטים נוספים.
תוכנית הושלמה	מתבצעת קריאה כאשר הסוכן הראשי מסיים לבצע את כל השלבים המתוכננים כדי להגיב לשאילתת משתמש או להדק אוטומטי.
תגובה שנוצרה על-ידי בינה מלאכותית עומד להישלח	מתבצעת קריאה כאשר הסוכן הראשי יוצר תגובה עבור משתמש לאחר קריאה לנושא, לכלים או למקורות ידע אחד או יותר. השתמש במשתנה Response.FormattedText המערכת כדי לראות את התגובה שנוצרה. הגדר את ContinueResponse המשתנה ל- False אם ברצונך למנוע את שליחת תגובת התזמור (לדוגמה, אם תשנה את ההודעה ותשלח הודעה משלך באמצעות צומת הודעה).

פרטים נוספים

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

תנאי

ציין תנאים שיש להתקיים כדי שהסוכן ייקרא. לדוגמה, ייתכן שתרצה שהסוכן יקרא רק אם הערוץ המשמש עובד אינו Microsoft Teams.

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

עדיפות

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

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

סדר הביצוע:

1. מתרחשת פעילות
2. התקבלה הודעה / מתרחש אירוע לקוח מותאם אישית / השיחה משתנה / הוא הופעל
3. הסוכן בוחר

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

באפשרותך להגדיר את המאפיין Priority באופן מפורש. מספר נמוך יותר מציין עדיפות גבוהה יותר.

שימוש בסוכני משנה ובכלים

סוכני Copilot Studio המשתמשים בארכיטקטורה גנרטיבית כוללים מגבלות במספר הכלים המרבי והמומלץ שהם יכולים להשתמש בהם. לקבלת מידע נוסף, ראה/ראי מגבלות על כלים בסוכנים.

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

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