חומר עזר עבור CLI של סוכן 365

חומר עזר בנושא ממשק שורת הפקודה של Agent 365 הוא ממשק שורת פקודה מקיף לבנייה וניהול של סוכני בינה מלאכותית עבור Microsoft 365. למד כיצד להתחיל בעבודה עם CLI של סוכן 365.

Global options

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

• --version: הצג פרטי גירסה.
• -?, -h, --help: הצג פרטי עזרה ושימוש.

Commands

הטבלה הבאה מפרטת את הפקודות הזמינות.

Tip

לכל פקודה יש דרישות תפקיד ספציפיות. עיין בעמודי ההפניה לפקודה הבודדים עבור התפקיד המינימלי הנדרש כדי לבצע כל פקודה. לדוגמה, הפקודה דורשתsetupמפתח מזהה סוכן + משתתף של Azure לכל הפחות. מנהל גלובלי נדרש רק לאישורי OAuth2; כאשר מנהל גלובלי הוא אדם אחר, a365 setup all הוא מדפיס את השלבים הבאים שעליו להשלים. עבור S2S (שרת לשרת) הענקות זהות של סוכן (--authmode s2s OR both), נדרש מנהל מזהה סוכן או גבוה יותר.

Command	Description
cleanup	ניקוי כל המשאבים (שרטוט, מופע ו- Azure). השתמש בהודעות משנה לניקוי פרטני.
cleanup azure	הסר את המשאבים של Azure (App Service, App Service Plan).
cleanup blueprint	הסר את יישום השרטוט של Entra ID ואת מנהל השירות.
cleanup instance	הסר זהות מופע סוכן ומשתמש מ- Entra ID.
develop	נהל שרתי כלים של MCP לפיתוח סוכן.
develop add-mcp-servers	הוסף שרתי MCP לתצורות הסוכן הנוכחיות.
develop add-permissions	הוסף הרשאות API של שרת MCP לאפליקציות Microsoft Entra עבור תרחישי פיתוח שבהם עליך להגדיר יישומים מותאמים אישית כדי לגשת לשרתי MCP.
develop get-token	אחזר אסימוני נושא לבדיקת שרתי MCP במהלך הפיתוח באמצעות אימות דפדפן אינטראקטיבי.
develop list-available	פרט את כל שרתי ה- MCP הזמינים בקטלוג (מה ניתן להתקין).
develop list-configured	פרט את שרתי MCP שתצורתם נקבעה כעת מהשרת המקומי שלך ToolingManifest.json.
develop remove-mcp-servers	הסר שרתי MCP מתצורות הסוכן הנוכחיות.
develop start-mock-tooling-server	הפעל שרת כלי מדומה למטרות בדיקה ופיתוח.
develop-mcp	נהל שרתי MCP בסביבות Dataverse.
develop-mcp approve	אשר שרת MCP.
develop-mcp block	חסימת שרת MCP.
develop-mcp list-environments	פרט את כל הסביבות Dataverse הזמינות לניהול שרתי MCP.
develop-mcp list-servers	פרט שרתי MCP בסביבה Dataverse ספציפית.
develop-mcp package-mcp-server	צור חבילת שרת MCP לשליחה במרכז הניהול של Microsoft.
develop-mcp publish	פרסום שרת MCP לסביבה Dataverse.
develop-mcp register-external-mcp-server	רשום שרת MCP חיצוני עם Entra, OAuth חיצוני, מפתח API או ללא אימות.
develop-mcp unpublish	ביטול פרסום של שרת MCP מתוך סביבה Dataverse.
logs	נהל יומני אבחון של CLI. פקודת logs מייצאת עותקים מצונזרים של קבצי יומן CLI שבטוחים לשיתוף עם התמיכה Microsoft.
logs export	ייצא עותק מצונזר של קובץ יומן אבחון של CLI שבטוח לשיתוף עם תמיכת Microsoft. מוחק טוקני JWT, כתובות דוא"ל, GUIDs ושמות משתמש של OS-path, ומחליף ערכים זהים בכינויים עקביים כדי לשמור על קורלציה ביומן.
publish	עדכן את ערכי המזהה manifest.json וצור חבילה manifest.zip להעלאה למרכז הניהול של Microsoft 365.
query-entra	מתן אפשרויות לשאילתה מזהה Entra של Microsoft לקבלת מידע אודות סוכן, כולל טווחים, הרשאות ומצב הסכמה.
query-entra blueprint-scopes	רשום את הרשאות ההאצלה והיישום שהוכרזו על ידי יישום ה-Agent Blueprint.
query-entra inheritance	וודא שההרשאות הניתנות להורשה של התכנית מוגדרות כראוי ושזהויות הסוכנים יקבלו אותן.
query-entra instance-scopes	פרט טווחים ומצב הסכמה שתצורתם נקבעה עבור מופע הסוכן.
setup	הגדר את סביבת סוכן 365 שלך עם שליטה פרטנית על כל שלב.
setup all	בצע את כל שלבי ההגדרה כדי להגדיר את סביבת סוכן 365 שלך
setup blueprint	צור שרטוט סוכן (רישום יישום Entra ID).
setup permissions	קביעת תצורה של הרשאות OAuth2 מעניקה הרשאות הניתנות להעברה בירושה.
setup permissions bot	קבע את תצורת ה- API של Messaging Bot OAuth2 מעניק הרשאות הניתנות להעברה בירושה.
setup permissions copilotstudio	קביעת התצורה של הרשאות OAuth2 מעניקה הרשאות הניתנות בירושה עבור השרטוט של הסוכן כדי להפעיל את Copilot Studio copilots באמצעות ה- API של Power Platform.
setup permissions custom	החלת הרשאות API מותאמות אישית על שרטוט הסוכן שלך שמעבר להרשאות הסטנדרטיות הנדרשות עבור פעולת סוכן.
setup permissions mcp	קביעת התצורה של OAuth2 של שרת MCP מעניק והרשאות הניתנות להעברה בירושה.
setup requirements	אימות ותיקון דרישות מוקדמות להגדרת Agent 365.