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

สําคัญ

คุณจําเป็นต้องเป็นส่วนหนึ่งของโปรแกรมการแสดงตัวอย่าง Frontier เพื่อเข้าถึง Microsoft Agent 365 ก่อน Frontier เชื่อมต่อคุณโดยตรงกับนวัตกรรม AI ล่าสุดของ Microsoft การแสดงตัวอย่างในส่วนหน้าจะต้องอยู่ภายใต้ข้อกําหนดการแสดงตัวอย่างที่มีอยู่ของข้อตกลงของลูกค้าของคุณ เนื่องจากคุณลักษณะเหล่านี้ยังคงอยู่ในการพัฒนา ความพร้อมใช้งานและความสามารถของพวกเขาอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป

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

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

วากยสัมพันธ์

a365 develop [command] [options]

ตัวเลือก

ตัวเลือก	คำอธิบาย
-c, --config <config>	เส้นทางของไฟล์การกําหนดค่า ค่าเริ่มต้น: a365.config.json
-v, --verbose	เปิดใช้งานการบันทึกแบบอย่างละเอียด
-?, , -h--help	แสดงข้อมูลความช่วยเหลือและการใช้งาน

develop list-available

แสดงเซิร์ฟเวอร์ MCP ทั้งหมดที่มีอยู่ในแค็ตตาล็อก (สิ่งที่คุณสามารถติดตั้งได้)

a365 develop list-available [options]

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

list-available ตัวเลือก

ตัวเลือก	คำอธิบาย
-c, --config <config>	เส้นทางของไฟล์การกําหนดค่า ค่าเริ่มต้น: a365.config.json
--dry-run	แสดงสิ่งที่คําสั่งจะทําโดยไม่ต้องดําเนินการ
--skip-auth	ข้ามการรับรองความถูกต้อง สําหรับการทดสอบเท่านั้น คําสั่งอาจล้มเหลวโดยไม่มีการรับรองความถูกต้องที่ถูกต้อง
-?, , -h--help	แสดงข้อมูลความช่วยเหลือและการใช้งาน

develop list-configured

แสดงเซิร์ฟเวอร์ MCP ที่กําหนดค่าไว้ในขณะนี้จากภายในเครื่อง ToolingManifest.jsonของคุณ

a365 develop list-configured [options]

คําสั่งนี้แสดงเซิร์ฟเวอร์ MCP ทั้งหมดที่คุณกําหนดค่าไว้ในไฟล์ ToolingManifest.json ภายในเครื่องของคุณ

list-configured ตัวเลือก

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

develop add-mcp-servers

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

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

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

สําคัญ

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

• ก่อนการตั้งค่าเริ่มต้น: ดําเนินการต่อด้วยa365 setup all สิทธิ์ MCP จะถูกนําไปใช้เป็นส่วนหนึ่งของการสร้างพิมพ์เขียวเริ่มต้น
• หลังจากพิมพ์เขียวที่มีอยู่แล้ว: ผู้ดูแลระบบส่วนกลางต้องทํางาน a365 setup permissions mcp แยกต่างหาก ผู้ดูแลระบบต้องเรียกใช้a365 config displayก่อนเพื่อตรวจสอบว่าdeploymentProjectPathในจุดของพวกเขาa365.config.jsonไปยังโฟลเดอร์โครงการที่มีการอัปเดตToolingManifest.json

add-mcp-servers อาร์กิวเมนต์

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

อาร์กิวเมนต์	คำอธิบาย
<servers>	ชื่อของเซิร์ฟเวอร์ MCP ที่จะเพิ่ม

add-mcp-servers ตัวเลือก

ใช้ตัวเลือกเหล่านี้เพื่อกําหนดลักษณะการทํางานของ add-mcp-servers คําสั่ง รวมถึงการเลือกไฟล์การกําหนดค่าและการทดสอบการเรียกใช้แบบแห้ง

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

develop remove-mcp-servers

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

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

คําสั่งนี้จะลบเซิร์ฟเวอร์ MCP ที่ระบุออกจากการกําหนดค่าเอเจนต์ปัจจุบันของคุณ

remove-mcp-servers อาร์กิวเมนต์

อาร์กิวเมนต์	คำอธิบาย
<servers>	ชื่อของเซิร์ฟเวอร์ MCP ที่จะลบ

remove-mcp-servers ตัวเลือก

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

develop add-permissions

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

a365 develop add-permissions [options]

add-permissions ตัวเลือก

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

ตัวเลือก	คำอธิบาย
-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	แสดงข้อมูลความช่วยเหลือและการใช้งาน

สําคัญ

โปรแกรมประยุกต์ที่ระบุโดย --app-id หรือ clientAppId ต้องมีสิทธิ์ Application.ReadWrite.All ใน Microsoft Entra คําสั่งนี้สําหรับแอปพลิเคชันไคลเอ็นต์แบบกําหนดเอง หากต้องการกําหนดค่าสิทธิ์สําหรับพิมพ์เขียวของเจ้าหน้าที่ ให้ใช้ a365 setup permissions mcp แทน

develop get-token

เรียกใช้โทเค็นแบเรอร์สําหรับการทดสอบเซิร์ฟเวอร์ MCP ในระหว่างการพัฒนาโดยใช้การรับรองความถูกต้องเบราว์เซอร์แบบโต้ตอบ

a365 develop get-token [options]

get-token ตัวเลือก

ใช้ตัวเลือกเหล่านี้เพื่อร้องขอโทเค็นการเข้าถึง ขอบเขตการควบคุม ลักษณะการรีเฟรช และเลือกรูปแบบผลลัพธ์

ตัวเลือก	คำอธิบาย
-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) สําหรับทรัพยากรที่ไม่ครอบคลุมโดยคําสําคัญ

สําคัญ

--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 คําสั่ง

ตัวเลือก	คำอธิบาย	ค่าเริ่มต้น
-p, --port <port>	หมายเลขพอร์ตสําหรับเซิร์ฟเวอร์จําลอง	5309
-v, --verbose	เปิดใช้งานการบันทึกแบบอย่างละเอียด	เท็จ
-?, -h, --help	แสดงข้อมูลความช่วยเหลือและการใช้งาน	-
-bg	เรียกใช้เซิร์ฟเวอร์บนเทอร์มินัลใหม่	-