פריסת סוכנים ב-Microsoft Teams

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

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

השיקולים המרכזיים הכלולים:

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

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

מדוע פריסת Teams שונה

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

ההתמדה של Teams יוצרת כמה סיכונים:

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

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

ניהול מחזור החיים של ההפעלה

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

יישום איפוסי חוסר פעילות

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

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

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

מתן הדרכה לאחר האיפוס

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

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

ספק פקודת איפוס בשירות עצמי

הוסף העברת הודעות שמיידעת את המשתמשים שהם יכולים להקליד פקודה ספציפית: "אם משהו נראה שגוי, נסה להקליד /debug clearstate כדי לרענן את המצב שלי".

פקודה זו כופה איפוס שיחה מלא:

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

השתמש בפקודה זו כאשר:

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

הגדל את השקיפות ושפר את איתור הבאגים

כדי להגביר את השקיפות ולשפר את איתור הבאגים עבור סוכנים שפורסמו ב-Teams, השתמש בהפעלת OnKnowledgeRequested.

השתמש ב- OnKnowledgeRequested כדי לחשוף שאילתות שכתבת

Copilot Studio משכתב את שאלות המשתמשים לפני ביצוע אחזור. אם הפעלת את הגורם המפעיל OnKnowledgeRequested , באפשרותך לבצע את הפעולות הבאות:

• אבחון אי-התאמה של כוונות
• הבנת אופן ההכתבה מחדש של שאילתות
• הגדל את אמון המשתמשים במהלך איתור באגים

הערה

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

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

kind: AdaptiveDialog
beginDialog:
  kind: OnKnowledgeRequested
  id: main
  actions:
    - kind: SendActivity
      id: sendActivity_debug
      activity: |-    
        **Debug**: sending this lexical query "{System.KnowledgeSearchQuery}"
        **Debug**: sending this semantic query "{System.SearchQuery}"
inputType: {}
outputType: {}

שאילתה זו מספקת גישה לקריאה בלבד לשאילתת החיפוש המעודנת (שכתוב שאילתה) שה- orchestrator יפיק משאלה של המשתמש.

יתרונות:

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

בקרת גירסאות ומהימנות עדכון

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

תוכנית Bot של משטח בפתיח או בנושא ייעודי

כלול מזהה גרסה באמצעות פתיח או נושא גרסה ייעודי:

Contoso Helpdesk Bot – Version 1.3 (Nov 2025)

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

הפוך את 'כפה את הגירסה החדשה ביותר' לזמינה בעת פרסום

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

שיקולי יישום ספציפיים ל- Teams

ל- Teams יש אופני פעולה ייחודיים הדורשים תשומת לב מיוחדת.

התייחס לנושא הברכה בתור לוגיקת האתחול

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

• קבע את לוגיקת האתחול ב-Greeting
• הוסף הוראות ברורות בתיאור האפליקציה Teams.
• הזכר למשתמשים: "לאחר פרק זמן קצוב, הקלד 'hello' כדי להתחיל שיחה חדשה."

מיטוב גורמים מפעילים ותוכניות חלופיות

משתמשי Teams מקיימים אינטראקציה באופן טבעי ובלתי צפוי. ודא שהבוט שלך:

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

אימות אופן הפעולה של אימות מחבר

בעת שימוש במחברים (ServiceNow, Outlook, ואחרים), בדוק:

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

עצה

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

בדיקה בתנאים אמיתיים

מאחר ש- Teams שומר על המצב בין הפעלות, הבדיקה שלך צריכה לשקף את חוויית המשתמש האמיתית:

1. פרוס באמצעות הצג רק לי.
2. בדוק תרחישים שפועלים זמן רב (חוזר לאחר שעות העבודה).
3. פרסם עדכונים ואשר שהסוכן מחליף גרסאות.
4. בדוק עיבוד של Adaptive Card במחשבים שולחניים ובמכשירים ניידים.
5. בדוק פעולות בהקשרים שונים של שיחות.

רשימת פעולות לביצוע פריסה

נַעֲשָׂה?	משימה
✓	גורם מפעיל של חוסר פעילות הוגדר לנקות את היסטוריית השיחות
✓	הודעות למשתמש מסבירות איפוס ומנחות איך לבצע הפעלה מחדש
✓	/debug clearstate תועד עבור משתמשים
✓	OnKnowledgeRequested מופעל עבור שקיפות במהלך הפיתוח
✓	מזהה הגירסה הכלול בתגובות
✓	כפה הפעלה של הגירסה החדשה ביותר לפי הצורך
✓	נושא הברכה כולל לוגיקת אתחול
✓	אופן הפעולה של חזרה הוא ידידותי למשתמש
✓	אימות מחבר נבדק עבור תפוגת תוקף וחידוש
✓	בדיקה ב- Teams בתנאים אמיתיים הושלמה

נקודות מפנה

• נהל את מחזור החיים של ההפעלה על-ידי קביעת התצורה של גורמים מפעילים של חוסר פעילות ושימוש באפשרויות ניקוי מצב בהתאם לצורך.
• שפר את השקיפות על-ידי חשיפת פעילות המערכת באמצעות שכתובי שאילתות והודעות הקשורות למצב.
• הִתְחַשֵּׁב בְּהתנהגויות ספציפיות ל-Teams, כגון טיפול בברכות ידניות וניהול זיכרון קבוע.
• שמור על מהימנות הסוכן על-ידי יישום שיטות עבודה של ניהול גירסאות ואכיפה של עדכונים בעת הצורך.
• תמיכה בהגדרות אוטומטיות של משתמשים על-ידי מתן פקודות לפתרון בעיות בשירות עצמי ואפשרויות שחזור מונחות.

מידע קשור

• חבר וקבע תצורה של סוכן עבור Teams ו- Microsoft 365
• מושגים עיקריים - פרסום ופריסה של הסוכן שלך