חומר עזר לפקודה של CLI develop של סוכן 365

נהל שרתי כלים של MCP לפיתוח סוכן. הפקודה develop מספקת אפשרויות לניהול שרתי כלים של MCP (Model Context Protocol) לפיתוח סוכנים. אתה יכול לרשום שרתים זמינים, לצפות בשרתים מוגדרים, ולהוסיף או להסיר שרתי MCP מהגדרת הסוכן שלך.

תפקיד מינימלי נדרש: אין (ניהול מניפסט מקומי)

Syntax

a365 develop [command] [options]

אפשרויות

Option	Description
-v, --verbose	הפעלת רישום ארוך
-?, , -h--help	הצג עזרה ומידע שימוש.

develop list-available

פרט את כל שרתי ה- MCP הזמינים בקטלוג (מה ניתן להתקין).

a365 develop list-available [options]

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

list-available אפשרויות

Option	Description
--dry-run	הצג מה הפקודה היתה עושה מבלי לבצע אותה.
--skip-auth	Skip authentication. רק לבדיקות. סביר להניח שהפקודה נכשלת ללא אימות תקף.
-?, , -h--help	הצג עזרה ומידע שימוש.

Note

develop list-available לא דורש a365.config.json. הוא קורא את הסביבה ממשתנה הסביבה A365_ENVIRONMENT (ברירת מחדל ל- prod).

develop list-configured

פרט את שרתי MCP שתצורתם נקבעה כעת מהשרת המקומי שלך ToolingManifest.json.

a365 develop list-configured [options]

הפקודה הזו מציגה את כל שרתי ה-MCP שהגדרת כרגע בקובץ ToolingManifest.json המקומי שלך.

list-configured אפשרויות

Option	Description
--project-path <path>	נתיב לתיקיית פרויקט הסוכן המכילה ToolingManifest.jsonאת . עוקף DeploymentProjectPath מ- a365.config.json.
--dry-run	הצג מה הפקודה היתה עושה מבלי לבצע אותה.
-?, , -h--help	הצג עזרה ומידע שימוש.

develop add-mcp-servers

הוסף שרתי MCP לתצורות הסוכן הנוכחיות.

a365 develop add-mcp-servers [<servers>...] [options]

פקודה זו מוסיפה את שרתי MCP שצוינו לתיקיית ToolingManifest.json הפרויקט שלך. הוא לא מעניק הרשאות לתכנית הסוכן.

Important

הפקודה הזו מתעדכנת ToolingManifest.json רק - היא לא מעניקה הרשאות ל-Agent Blueprint. איך אתה מיישם הרשאות תלוי במיקום שלך בתהליך ההגדרה:

• לפני ההגדרה הראשונית: המשך עם a365 setup all. הרשאות MCP מוחלות כחלק מיצירת התכנית הראשונית.
• לאחר שהתבנית כבר קיימת: מנהל גלובלי חייב לפעול a365 setup permissions mcp בנפרד. המנהל חייב לוודא שזה deploymentProjectPath מצביע על תיקיית הפרויקט שמכילה את העדכון ToolingManifest.json.

add-mcp-servers טיעונים

ציין שמות שרתי MCP אחד או יותר להוסיף להגדרות הסוכן שלך. אתה יכול לספק מספר שמות שרתים המופרדים ברווחים.

Argument	Description
<servers>	שמות שרתי MCP להוסיף

add-mcp-servers אפשרויות

השתמש באפשרויות אלו כדי להתאים אישית את התנהגות הפקודה add-mcp-servers .

Option	Description
--project-path <path>	נתיב לתיקיית פרויקט הסוכן המכילה ToolingManifest.jsonאת . עוקף DeploymentProjectPath מ- a365.config.json.
--dry-run	הצג מה הפקודה היתה עושה מבלי לבצע אותה.
-?, , -h--help	הצג עזרה ומידע שימוש.

develop remove-mcp-servers

הסר שרתי MCP מתצורות הסוכן הנוכחיות.

a365 develop remove-mcp-servers [<servers>...] [options]

פקודה זו מסירה שרתי MCP מסוימים מהקונפיגורציה הנוכחית של הסוכן שלך.

remove-mcp-servers טיעונים

Argument	Description
<servers>	שמות שרתי MCP שיש להסיר

remove-mcp-servers אפשרויות

Option	Description
--project-path <path>	נתיב לתיקיית פרויקט הסוכן המכילה ToolingManifest.jsonאת . עוקף DeploymentProjectPath מ- a365.config.json.
--dry-run	הצג מה הפקודה היתה עושה מבלי לבצע אותה.
-?, , -h--help	הצג עזרה ומידע שימוש.

develop add-permissions

הוסף הרשאות API של שרת MCP לאפליקציות Microsoft Entra עבור תרחישי פיתוח שבהם עליך להגדיר יישומים מותאמים אישית כדי לגשת לשרתי MCP.

a365 develop add-permissions [options]

add-permissions אפשרויות

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

Option	Description
-m, --manifest <manifest>	נתיב ל( ToolingManifest.json ברירת מחדל: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id>	מזהה אפליקציה (לקוח) להוספת הרשאות אליו (ברירת מחדל: clientAppId מתוך קונפיגורציה)
--scopes <scopes>	טווחים ספציפיים להוספת (מופרדים ברווח) (ברירת מחדל: כל הטווחים מ- ToolingManifest.json)
--dry-run	להראות מה הפקודה הייתה עושה בלי לבצע שינויים
-v, --verbose	הצג פלט מפורט
-?, , -h--help	הצג עזרה ומידע שימוש.

Important

הבקשה שצוינה ב---app-id או clientAppId חייבת להחזיק באישור Application.ReadWrite.All ב-Microsoft Entra. פקודה זו מיועדת ליישומי לקוח מותאמים אישית. כדי להגדיר הרשאות לשרטוטי סוכנים, השתמש a365 setup permissions mcp במקום זאת.

develop get-token

אחזר אסימוני נושא לבדיקת שרתי MCP במהלך הפיתוח באמצעות אימות דפדפן אינטראקטיבי.

a365 develop get-token [options]

get-token אפשרויות

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

Option	Description
--app-id <app-id>	מזהה אפליקציה (לקוח) לאימות (ברירת מחדל: clientAppId מהקונפיגורציה)
-m, --manifest <manifest>	נתיב ל( ToolingManifest.json ברירת מחדל: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes>	סקופים ספציפיים לבקש (מופרד ברווח) (ברירת מחדל: קריאה מ- ToolingManifest.json)
-o, --output <output>	פורמט פלט: table, , או json (ברירת מחדל: rawtable)
--force-refresh	כפיית רענון אסימון ועוקפת מטמון
--resource <resource>	מילת מפתח משאב לקבלת טוקן עבור: mcp (ברירת מחדל) או powerplatform
--resource-id <resource-id>	מזהה יישום משאבים מותאם אישית (GUID) למשאבים שאינם מכוסים במילות --resource מפתח
-v, --verbose	הצג פלט מפורט כולל טוקן מלא
-?, , -h--help	הצג עזרה ומידע שימוש.

get-token אפשרויות משאבים

השתמש באפשרויות --resource ו---resource-id כדי לקבל טוקנים למשאבים Azure שונים:

• --resource: השתמש במילת מפתח לבחירת משאב מוגדר מראש:
  • mcp (ברירת מחדל): כלי סוכן 365 לשרתים של MCP
  • powerplatform: Power Platform API
• --resource-id: הזן מזהה יישום משאב מותאם אישית (GUID) עבור משאבים שאינם מכוסים על ידי מילות מפתח

Important

אי אפשר להשתמש --resource ביחד --resource-id . כשאתה משתמש באחת מהאפשרויות, כלול --scopes. רק זרימת MCP ברירת המחדל תומכת ברזולוציית טווח מבוססת מניפסט.

develop start-mock-tooling-server

הפעל שרת כלי מדומה למטרות בדיקה ופיתוח.

a365 develop start-mock-tooling-server [options]

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

start-mock-tooling-server אפשרויות

השתמש באפשרויות אלו כדי להתאים אישית את התנהגות הפקודה start-mock-tooling-server .

Option	Description	Default
-p, --port <port>	מספר פורט לשרת המדומה	5309
-v, --verbose	הפעלת רישום ארוך	false
-?, -h, --help	הצגת מידע אודות עזרה ושימוש	-
-bg	הרץ את השרת על טרמינל חדש	-