התחברות לסוכן Microsoft (תצוגה מקדימה)

הערה

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

‏‫[מאמר זה הוא תיעוד קדם-הפצה והוא עשוי להשתנות.]‬

באפשרותך לחבר סוכן Microsoft Foundry Agent לסוכן המותאם אישית שלך, ולאפשר לו להתקשר לסוכן זה להגיב למשתמש או להפעלה.

חשוב

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

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

אם אתה בונה סוכן המוכן לייצור, ראה Microsoft Copilot Studio Overview.

‏‫דרישות מוקדמות‬

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

כרגע אפשר להפעיל את נקודת קצה הפעילות רק באופן תכנותי, באמצעות API REST או SDK של Python. אין אפשרות להפעיל אותו מפורטל Microsoft Foundry. למדו עוד על תהליך ההפעלה ב-Configure ושתפו את הסוכן שלכם.

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

התחברות לסוכן Microsoft Foundry

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

2. תחת התחבר לסוכן חיצוני, בחר Microsoft Foundry מסוגי הסוכנים הזמינים.

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

   הערה

   בעת התחברות לסוכני Microsoft מ- Copilot Studio, באפשרותך להתחבר רק לסוכנים שנוצרו בפורטל בית Microsoft החדש. חיבור לסוכן שנוצר בפורטל הקודם מוביל לשגיאה שמציינת 404 - Version not found.

4. לאחר יצירת החיבור, בחר הבא.

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

6. הזן Agent id עבור סוכן Microsoft שברצונך להתחבר אליה.

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

8. בחר הוסף סוכן.

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

הערה

• אם קריאת הבדיקה הראשונה שלך לסוכן Foundry המחובר נכשלת עם שגיאה דומה ל"המחבר 'Azure AI Foundry Agent Service' החזיר שגיאת HTTP עם קוד 400. שגיאה פנימית: נקודת קצה הסוכן <name> אינה תומכת בפעילות. אנא עדכן את נקודת הקצה של הסוכן שתתמוך בפרוטוקול זה.", לסוכן Foundry אין את נקודת קצה פרוטוקול הפעילות מופעלת. ראו דרישות מוקדמות במאמר זה, ואז הפעל את נקודת קצה הפעילות על ידי ביצוע הגדרה ושיתוף הסוכן בתיעוד של Microsoft Foundry.

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

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