การอ้างอิงคําสั่ง Agent 365 CLI develop

จัดการเซิร์ฟเวอร์เครื่องมือ MCP สําหรับการพัฒนาตัวแทน คําสั่ง develop มีตัวเลือกในการจัดการเซิร์ฟเวอร์เครื่องมือ MCP (Model Context Protocol) สําหรับการพัฒนาตัวแทน คุณสามารถแสดงเซิร์ฟเวอร์ที่พร้อมใช้งาน ดูเซิร์ฟเวอร์ที่กําหนดค่าไว้ และเพิ่มหรือลบเซิร์ฟเวอร์ MCP ออกจากการกําหนดค่าของบริษัทตัวแทนของคุณได้

จําเป็นต้องมีบทบาทขั้นต่ํา: ไม่มี (การจัดการรายชื่อแฟ้มภายในเครื่อง)

Syntax

a365 develop [command] [options]

ตัวเลือก

Option	Description
-c, --config <config>	เส้นทางของไฟล์การกําหนดค่า Default: a365.config.json
-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. แทนที่จาก DeploymentProjectPatha365.config.json.
--dry-run	แสดงสิ่งที่คําสั่งจะทําโดยไม่ต้องดําเนินการ
-?, -h, --help	แสดงข้อมูลความช่วยเหลือและการใช้งาน

develop add-mcp-servers

เพิ่มเซิร์ฟเวอร์ MCP ลงในการกําหนดค่าตัวแทนปัจจุบัน

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

คําสั่งนี้เพิ่มเซิร์ฟเวอร์ MCP ที่ระบุใน ToolingManifest.json โฟลเดอร์โครงการของคุณ แต่ไม่อนุญาตให้มีพิมพ์เขียวของเจ้าหน้าที่

Important

คําสั่งนี้จะอัปเดต ToolingManifest.json เท่านั้น - จะไม่ให้สิทธิ์แก่พิมพ์เขียวของเอเจนต์ วิธีใช้สิทธิ์จะขึ้นอยู่กับตําแหน่งที่คุณอยู่ในขั้นตอนการตั้งค่า

• ก่อนการตั้งค่าเริ่มต้น: ดําเนินการต่อด้วย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. แทนที่จาก DeploymentProjectPatha365.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. แทนที่จาก DeploymentProjectPatha365.config.json.
--dry-run	แสดงสิ่งที่คําสั่งจะทําโดยไม่ต้องดําเนินการ
-?, -h, --help	แสดงข้อมูลความช่วยเหลือและการใช้งาน

develop add-permissions

เพิ่มสิทธิ์ API ของเซิร์ฟเวอร์ MCP ไปยัง Microsoft Entra แอปพลิเคชันสําหรับสถานการณ์การพัฒนาที่คุณต้องการกําหนดค่าแอปพลิเคชันแบบกําหนดเองเพื่อเข้าถึงเซิร์ฟเวอร์ MCP

a365 develop add-permissions [options]

add-permissions ตัวเลือก

ใช้ตัวเลือกเหล่านี้เพื่อเพิ่มสิทธิ์ API ที่จําเป็นและขอบเขตในการลงทะเบียนแอปโดยใช้ประโยชน์จากค่าจากรายการเครื่องมือ

Option	Description
-c, --config <config>	เส้นทางของไฟล์การกําหนดค่า (ค่าเริ่มต้น: a365.config.json)
-m, --manifest <manifest>	เส้นทางไปยัง ToolingManifest.json (ค่าเริ่มต้น: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id>	ID แอปพลิเคชัน (ไคลเอ็นต์) เพื่อเพิ่มสิทธิ์ไปยัง (ค่าเริ่มต้น: clientAppId จาก config)
--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
-c, --config <config>	เส้นทางของไฟล์การกําหนดค่า (ค่าเริ่มต้น: a365.config.json)
--app-id <app-id>	ID แอปพลิเคชัน (ไคลเอ็นต์) สําหรับการรับรองความถูกต้อง (ค่าเริ่มต้น: clientAppId จาก config)
-m, --manifest <manifest>	เส้นทางไปยัง ToolingManifest.json (ค่าเริ่มต้น: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes>	ขอบเขตเฉพาะสําหรับการร้องขอ (คั่นด้วยช่องว่าง) (ค่าเริ่มต้น: อ่านจาก ToolingManifest.json)
-o, --output <output>	รูปแบบผลลัพธ์: table, jsonหรือ raw (ค่าเริ่มต้น: table)
--force-refresh	บังคับให้รีเฟรชโทเค็นโดยผ่านแคช
--resource <resource>	คําหลักทรัพยากรเพื่อรับโทเค็นสําหรับ: mcp (ค่าเริ่มต้น) หรือ powerplatform
--resource-id <resource-id>	ID แอปพลิเคชันทรัพยากรแบบกําหนดเอง (GUID) สําหรับทรัพยากรที่ไม่ครอบคลุมโดย --resource คําสําคัญ
-v, --verbose	แสดงผลลัพธ์โดยละเอียดรวมถึงโทเค็นแบบเต็ม
-?, -h, --help	แสดงข้อมูลความช่วยเหลือและการใช้งาน

get-token ตัวเลือกทรัพยากร

ใช้ตัวเลือก --resource และ --resource-id เพื่อรับโทเค็นสําหรับทรัพยากร Azure ที่แตกต่างกัน:

• --resource: ใช้คําสําคัญเพื่อเลือกทรัพยากรที่กําหนดไว้ล่วงหน้า:
  • mcp (ค่าเริ่มต้น): เครื่องมือตัวแทน 365 สําหรับเซิร์ฟเวอร์ MCP
  • powerplatform: API ของ Power Platform
• --resource-id: ป้อน 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	เรียกใช้เซิร์ฟเวอร์บนเทอร์มินัลใหม่	-