הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
השתמש בפקודה a365 publish כדי לארוז את הסוכן שלך, ולאחר מכן העלה את החבילה למרכז הניהול של Microsoft 365. לאחר הפרסום, תוכל ליצור מופעי סוכן בתוך הארגון שלך ולנהל את הסוכן.
דרישות מוקדמות
לפני שתתחיל, ודא שיש לך את הפריטים הבאים.
חשבונות והרשאות נדרשים
דייר Microsoft 365 עם אחד מהתפקידים הבאים (נדרש לשלב ההעלאה למרכז הניהול):
- מנהל מערכת כללי של
כלים נדרשים
- A365 CLI מותקן (סוכן Agent 365 CLI)
שלבי ההגדרה הנדרשים
לפני הפרסום, יש להשלים את השלבים הבאים:
- צור תכנית אב של סוכן - עקוב אחרי שלב ההגדרה כדי ליצור את תכנית האב של הסוכן.
- בדוק את הסוכן באופן מקומי – ודא שהסוכן פועל כראוי באמצעות Agents Playground (ראה בדיקת סוכנים באופן מקומי).
-
הכן קבצי תצורה - ודא ש-
a365.config.jsonו-a365.generated.config.jsonמעודכנים.
פרסם פקודה
הפעל את הפקודה a365 publish:
a365 publish
הערה
כאשר מריצים a365 publish -h, מוצגות כל האפשרויות שהפקודה הזו תומכת בהן.
מה הפקודה הזו עושה:
-
עדכן את המניפסט - עדכונים של
manifest.jsonעם מזהה התכנית של הסוכן שלך. -
יצירת חבילה - חבילות
manifest.jsonוסמלים לתוךmanifest.zip. - הדפס הוראות - מציג הוראות שלב אחר שלב להעלאה באמצעות מרכז הניהול של Microsoft 365:
הערה
הפקודה a365 publish עובדת הן לסוכנים והן לחברי צוות מבוססי בינה מלאכותית. לסוכנים שהוקצו באמצעות --agent-name (ללא קונפיגורציה), ודא ש- a365.generated.config.json קיימים בתיקיית העבודה לפני הרצת a365 publish, כי הפקודה קוראת את מזהה הבלופרינט מהקובץ הזה.
העלה אל מרכז הניהול
לאחר סיום a365 publish, פעל לפי ההוראות המודפסות כדי להעלות את הסוכן שלך:
- עבור אל מרכז הניהול של Microsoft 365.
- עבור אל סוכנים>כל הסוכנים.
- בחר העלה סוכן מותאם אישית.
- העלה את הקובץ
manifest.zipמהתיקייהmanifestבפרויקט שלך.
לקבלת מידע נוסף, ראה העלאת סוכנים למרכז הניהול של Microsoft 365.
אימות פרסום מוצלח
השתמש ברשימת הבדיקה הבאה כדי לוודא שהסוכן שלך פורסם בהצלחה:
✅
הפרסום באמצעות CLI הצליח
✅
manifest תיקייה שנוצרה וכוללת את manifest.json ו-manifest.zip
✅
הסוכן מופיע במרכז הניהול של Microsoft
פלט CLI
מוצגות הודעות הפלט הבאות כאשר פקודת publish מצליחה:
✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ הוראות העלאה שלב אחר שלב מוצגות
אם הפקודה נכשלת, בדוק את הודעות השגיאה וודא שהשלמת את הגדרת ה-Blueprint.
שגיאות אפשריות:
| שגיאה | שלב לפתרון |
|---|---|
Agent blueprint ID not found |
הפעל את a365 setup להשלמת הגדרת ה-Blueprint. |
Permissions missing |
הרץ מחדש את ההגדרה באמצעות הפקודה a365 setup permissions. |
בצע את הצעדים הללו כאשר תהליך הפרסום נכשל.
קבצי מניפסט
ניתן לבדוק את הקבצים הבאים בתיקייה manifest באמצעות הפקודה Test-Path של PowerShell.
# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True
הערה
אם אינך רואה את הקבצים האלה, נסה להריץ את הפקודה a365 publish שוב.
הסוכן מופיע במרכז הניהול
הערה
לאחר ההעלאה, יכול לקחת 5-10 דקות עד שהסוכן שלך יופיע במרכז הניהול וב-Teams. העיכוב הזה תקין.
ודא שהסוכן מופיע באמצעות השלבים הבאים:
- עברו אל מרכז הניהול של Microsoft 365.
- עבור אל סוכנים>כל הסוכנים.
- הסוכן שלך מופיע ברשימה.
הטבלה הבאה מציגה אילו פרטים תוכלו למצוא:
| שדה | מה לבדוק |
|---|---|
| שם | שם הסוכן שלך (מ- manifest.json) |
| גירסה | מספר גרסה (לדוגמה, 1.0.0) |
| מוציא לאור | שם הארגון |
| זמינות | זמין/כל המשתמשים |
למידע נוסף
השלבים הבאים
לאחר שפרסמת את הסוכן שלך, צור מופע כדי שתוכל להגדיר ולהשתמש בו בדייר שלך.
פתרון בעיות
בעיות נפוצות בעת פרסום סוכנים במרכז הניהול של Microsoft 365.
עצה
מדריך פתרון הבעיות של Agent 365 כולל המלצות מתקדמות לפתרון תקלות, שיטות עבודה מומלצות וקישורים לתוכן פתרון תקלות לכל חלק במחזור החיים של פיתוח Agent 365.
הפקודה 'פרסם' נכשלת
תסמינים:
- שגיאה במהלך
a365 publish -
manifest.zipלא נוצר
סיבות שורש:
- ההגדרה לא שלמה
- שגיאות אימות של המניפסט
- אין די הרשאות
פתרון:
ודא שההגדרה הושלמה.
Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintIdהרץ את פקודת publish ועקוב אחר ההנחיות.
ההעלאה נכשלת במרכז הניהול
תסמינים:
- שגיאה בעת העלאת
manifest.zipבמרכז הניהול של Microsoft 365 - הסוכן אינו מופיע לאחר ההעלאה
סיבות שורש:
- הרשאות לא מספקות במרכז הניהול
- לא תקף או מיושן
manifest.zip
פתרון:
- ודא שיש לך את תפקיד המנהל הגלובלי.
- הרץ את
a365 publishשוב כדי ליצור עותק חדש שלmanifest.zip. - נסה להעלות שוב בהתאם לשלבי ההעלאה.
לקבלת עזרה נוספת, ראה העלאת סוכנים למרכז הניהול של Microsoft 365.