תכנית סוכן והגדרת מופע

חשוב

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

הערה

אימות זהות סוכן הוא אחת משתי זרימות האימות שניתן להשתמש בהן. השני הוא תרשים הזרימה On-Behalf-Of (OBO).

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

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

מקרי שימוש:

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

צור את הזהות הנציגית שלך

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

תהליך יצירת הסוכן כולל שלושה שלבים עיקריים:

1. קונפיגורציה - אתחל את תצורת CLI של סוכן 365
2. הגדרה - יצירת שרטוט של משאבים ונציגים של Azure
3. יצירת מופע - יצירת מזהה יישום סוכני ומשתמש

דרישות מוקדמות

לפני שתתחיל, ודא שברשותך הפריטים הבאים:

• CLI של סוכן 365 - ראה התקנת CLI של סוכן 365

הרשאות נדרשות:

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

שלב 1: קביעת התצורה של ה- CLI של סוכן 365

הפקודה a365 config init יוצרת את קובץ התצורה a365.config.jsonהמרכזי המשמש את כל פקודות ה- CLI של Agent 365. ממשק המשתמש מספק אשף אינטראקטיבי עם שילוב ממשקי משתמש של Azure והגדרות ברירת מחדל חכמות כדי למזער קלט ידני.

אימות באמצעות Azure

לפני אתחול התצורה, בצע אימות מול Azure באמצעות az login הפקודה:

az login

בחר את המנוי המתאים כאשר תתבקש לעשות זאת. אשף קביעת התצורה משתמש ב- CLI של Azure כדי לבצע שאילתה על מנויים, קבוצות משאבים ותוכניות שירות של אפליקציות.

אתחל תצורה

הפעל את הפקודה הבאה כדי להפעיל את אשף קביעת התצורה האינטראקטיבית:

a365 config init

האשף משתמש שילוב CLI של Azure ובברירות מחדל חכמות כדי למזער קלט ידני. תתבקש לספק:

שדה	תיאור	Example
שם סוכן	מזהה ייחודי (אלפאנומרי בלבד)	myagent
נתיב פרוייקט פריסה	הנתיב לספריית הפרויקט של הסוכן שלך	C:\MyAgent\sample-agent
דואר אלקטרוני של מנהל	דואר אלקטרוני של המנהל המפקח על סוכן זה	manager@yourtenant.onmicrosoft.com
משאבים של Azure	בחר מתוך קבוצות משאבים ותוכניות שירות קיימות של אפליקציות	(בחירה אינטראקטיבית)

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

לקבלת מידע נוסף, עיין בהפנייתa365 config הפקודה.

אימות תצורה

השתמש בפקודהa365 config display כדי להציג את התצורה שלך כדי לוודא שכל הערכים נכונים:

a365 config display

שלב 2: יצירת שרטוט סוכן

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

הפעל הגדרה

בצע את פקודת ההתקנה:

a365 setup

תהליך ההתקנה מבצע פעולות אלה:

1. יצירת תשתית Azure (אם היא אינה קיימת כבר):

   • קבוצת משאבים
   • תוכנית שירות יישום עם SKU שצוין
   • Azure Web App עם זהות מנוהלת זמינה

2. רשום שרטוט של סוכן:

   • יצירת תוכנית הפעולה של הסוכן במנוי שלך ב-Azure AD
   • יצירת רישומי יישומים של Azure AD
   • קביעת התצורה של זהות הסוכן עם ההרשאות הנדרשות

3. קביעת תצורה של הרשאות API:

   • הגדרת טווחי API של Microsoft Graph
   • קביעת תצורה של הרשאות API של Messaging Bot
   • החלת הרשאות הניתנות בירושה עבור אינסטנציות סוכן

4. עדכון קבצי תצורה:

   • שומר את המזהים ונקודות הקצה שנוצרו ב- a365.generated.config.json
   • מתעד זהות מנוהלת ומידע על משאבים

הערה

במהלך ההתקנה, חלונות הדפדפן ייפתחו להסכמת מנהל מערכת. השלם זרימות הסכמה אלה כדי להמשיך. ההתקנה נמשכת בדרך כלל 3-5 דקות ושמירה אוטומטית של התצורה ב- a365.generated.config.json.

אמת את ההתקנה

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

1. הצג תצורה שנוצרה:

   a365 config display -g
   

   אשר שערכים אלה קיימים:

   • agentBlueprintId - מזהה היישום של תבנית הסוכן שלך
   • agentBlueprintObjectId - מזהה אובייקט Azure AD של Blueprint
   • managedIdentityPrincipalId - מזהה ראשי של זהות מנוהלת שהוקצתה על ידי המערכת

2. סקור את משאבי Azure בפורטל Azure:

   ודא שהמשאבים הבאים נוצרו:

   • קבוצת משאבים:

     • עבור אל קבוצות משאבים → קבוצת המשאבים שלך
     • ודא שהיא מכילה את תוכנית שירות היישום ואת יישום האינטרנט שלך

   • תוכנית שירות של יישום:

     • עבור אל שירותי אפליקציות>תוכניות שירותי אפליקציות
     • מצא את התוכנית שלך ואמת ששכבת התמחור תואמת ל- SKU של התצורה שלך

   • Web App:

     • עבור אל App Services>Web Apps
     • מצא את יישום האינטרנט שלך ולאחר מכן עבור אל הגדרות מערכת>הזהויות>שהוקצתה
     • ודא שהמצב מופעל
     • שים לב שהמזהה של האובייקט (ראשי) תואם ל-managedIdentityPrincipalId

3. אמת את אפליקציות Azure AD בפורטל Azure:

   עבור אל רישומי אפליקציות של Azure Active Directory>כל>היישומים:

   • חפש את השרטוט של הסוכן שלך על-ידי agentBlueprintId
   • פתח את היישום ובחר הרשאות API
   • ודא שהרשאות ניתנות עם סימני ביקורת ירוקים:
     • Microsoft Graph (הרשאות מוקצות והרשאות יישום)
     • הרשאות API של Messaging Bot
   • כל ההרשאות אמורות להציג את ההודעה "הוענקו עבור [הדייר שלך]"

שלב 3: יצירת מופע סוכן

הפקודה a365 create-instance יוצרת את מזהה היישום הסוכןי ואת המשתמש הסוכןי עבור שרטוט הסוכן שלך, ומאפשרת אימות והרשאות. פעולה זו יוצרת מופע ספציפי של הסוכן שלך עם זהות ואישורים משלו, ומאפשרת לו לאמת את סביבת Microsoft 365 שלך ולתפעל בה.

צור מופע

הפעל את הפקודה הבאה:

a365 create-instance

מה זה עושה:

1. יצירת מזהה יישום סוכן - יישום Azure AD עבור מופע סוכן זה
2. יצירת משתמש סוכן - מנהל שירות עבור מופע הסוכן
3. משתמש במזהה שרטוט של סוכן - מתוך התצורה שנוצרה (a365.generated.config.json)
4. הענקת הסכמת מנהל מערכת - החלת הרשאות ירושה מהשרטוט באופן אוטומטי
5. עדכון הגדרות - שומר אישורי סוכן חדשים בסביבה המקומית

הפלט הצפוי:

תראה הודעות התקדמות עבור כל שלב:

• שלב 1: יצירת זהות סוכן ומשתמש סוכן
• בקשות להסכמת מנהל מערכת (חלונות הדפדפן ייפתחו)
• שלב 2: הקצאת רשיון
• עדכוני תצורה

אימות מופע

1. הצג תצורה שנוצרה:

   a365 config display -g
   

   ודא שהערכים הבאים קיימים:

   • AgenticAppId - מזהה היישום של מופע הסוכן שלך
   • AgenticUserId - מזהה המשתמש של הסוכן שלך

2. אימות בפורטל Azure:

   • עבור אל רישומי אפליקציות של Azure Active Directory>
   • מצא את מזהה האפליקציה האג'נטית שלך (בדוק את התצורה שהופקה עבור המזהה)
   • ודא שהרשאות API מוענקות והסכמתן

‏‫השלבים הבאים‬

זהות הסוכן שלך רשומה ומוכן כעת. הבא:

1. הוספת יכולות כלי - הפיכת כלי Microsoft 365 לזמינים (מומלץ לבדיקת אימות)
2. בדוק את הסוכן שלך - בדיקה באמצעות מגרש המשחקים לסוכנים