pac copilot-studio

(ตัวอย่าง) จัดการ Copilot Studio ตัวแทนและส่งออกรายงานสิทธิ์การใช้งานของผู้เช่า

คำสั่ง

pac copilot-studio delete-copilot-agent

(ตัวอย่าง) ลบบอท

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio delete-copilot-agent

--bot-id

รหัสบอท

พารามิเตอร์ที่เลือกได้สําหรับ copilot-studio delete-copilot-agent

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

delete-copilot-agent หมาย เหตุ

คุณยังสามารถเรียกใช้คําสั่งนี้โดยใช้ Power Platform REST API Bots - ลบตัวแทน Copilot

pac copilot-studio download-agent-channel-manifest

(ตัวอย่าง) ดาวน์โหลดแพคเกจรายชื่อแฟ้มของแชนเนลสําหรับตัวแทนที่ระบุและแชนเนลเป็นไฟล์ zip ปัจจุบันรองรับเฉพาะช่อง "M365" เท่านั้น

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio download-agent-channel-manifest

--agent-id

รหัสบอท

--channel-name

ชื่อแชนเนล ปัจจุบันรองรับเฉพาะ "M365" เท่านั้น

--out-file

เส้นทางของไฟล์ภายในเครื่องที่จะเขียนเนื้อหาที่ดาวน์โหลดไป

พารามิเตอร์ที่เลือกได้สําหรับ copilot-studio download-agent-channel-manifest

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

--include-agent-schema

จะรวมเค้าร่างตัวแทนในแพคเกจรายชื่อแฟ้มที่ดาวน์โหลด

download-agent-channel-manifest หมาย เหตุ

คุณยังสามารถเรียกใช้คําสั่งนี้โดยใช้ Power Platform REST API Agent Channel - ดาวน์โหลดรายชื่อช่องทางของบริษัทตัวแทน

pac copilot-studio download-licensing-report-file

(ตัวอย่าง) ดาวน์โหลดรายงานสิทธิ์การใช้งานที่สร้างขึ้นเป็นไฟล์ CSV ที่บีบอัด gzip ใช้ชื่อไฟล์ที่ส่งกลับโดยการดําเนินการรายงานที่มีสถานะสําเร็จ

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio download-licensing-report-file

--file-name

ชื่อไฟล์รายงาน ที่ส่งกลับโดยการดําเนินการรายงานที่มีสถานะสําเร็จ

--out-file

เส้นทางของไฟล์ภายในเครื่องที่จะเขียนเนื้อหาที่ดาวน์โหลดไป

--report-name

ชื่อของรายงานที่สร้างขึ้น

ใช้หนึ่งในค่าเหล่านี้:

• BillingDetailsPerEnvironment
• FeatureDetailsPerResource

pac copilot-studio generate-licensing-report

(ตัวอย่าง) เริ่มต้นสร้างรายงานการให้สิทธิ์การใช้งาน Copilot Studio สําหรับผู้เช่าของคุณในช่วงวันที่ร้องขอ การสร้างจะทํางานแบบอะซิงโครนัส สํารวจ URL ในส่วนหัวของตําแหน่งที่ตั้งสําหรับสถานะ ต้องมีบทบาทส่วนกลาง Dynamics 365 หรือผู้ดูแลระบบ Power Platform

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio generate-licensing-report

--end-date

วันที่สิ้นสุด UTC แบบรวมของช่วงรายงาน ต้องอยู่ในหรือหลังจากวันที่เริ่มต้น

--report-name

ชื่อของรายงานที่จะสร้าง

ใช้หนึ่งในค่าเหล่านี้:

• BillingDetailsPerEnvironment
• FeatureDetailsPerResource

--start-date

วันที่เริ่มต้น UTC แบบรวมของช่วงรายงาน

พารามิเตอร์ที่เลือกได้สําหรับ copilot-studio generate-licensing-report

--granularity

กรานูลาริตี้ของรายงานสิทธิ์การใช้งาน ค่าส่งกลับรายวันหนึ่งแถวต่อวันในช่วงวันที่ และ Summary จะส่งกลับแถวสรุปเดียวสําหรับช่วงทั้งหมด

ใช้หนึ่งในค่าเหล่านี้:

• Daily
• Summary

pac copilot-studio get-bot-quarantine-status

(ตัวอย่าง) ดึงข้อมูลสถานะการตรวจสอบสินค้าของบอท

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio get-bot-quarantine-status

--bot-id

รหัสบอท

พารามิเตอร์ที่เลือกได้สําหรับ copilot-studio get-bot-quarantine-status

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

get-bot-quarantine-status หมาย เหตุ

คุณยังสามารถเรียกใช้คําสั่งนี้โดยใช้ Power Platform REST API Bots - รับสถานะการกักกันของบอท

pac copilot-studio get-connector-consent-bypass

(ตัวอย่าง) รับการตั้งค่าบายพาสความยินยอมของตัวเชื่อมต่อผู้ดูแลระบบสําหรับบอท

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio get-connector-consent-bypass

--bot-id

รหัสบอท

พารามิเตอร์ที่เลือกได้สําหรับ copilot-studio get-connector-consent-bypass

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

get-connector-consent-bypass หมาย เหตุ

คุณยังสามารถเรียกใช้คําสั่งนี้โดยใช้ Power Platform REST API Bots - รับตัวเชื่อมต่อยินยอมบายพาสได้

pac copilot-studio get-licensing-report-operation

(ตัวอย่าง) รับสถานะของการดําเนินการสร้างรายงานสิทธิ์การใช้งาน เมื่อสถานะสําเร็จ การตอบกลับจะมีชื่อไฟล์รายงานและส่วนหัวของตําแหน่งที่ตั้งมี URL ดาวน์โหลด

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio get-licensing-report-operation

--operation-id

ID การดําเนินการรายงานที่ส่งกลับในส่วนหัวของตําแหน่งที่ตั้งเมื่อการสร้างรายงานเริ่มต้นขึ้น

--report-name

ชื่อของรายงานที่กําลังสร้างขึ้น

ใช้หนึ่งในค่าเหล่านี้:

• BillingDetailsPerEnvironment
• FeatureDetailsPerResource

pac copilot-studio get-maker-evaluation-test-run

(ตัวอย่าง) รับสถานะและผลลัพธ์ของการเรียกใช้การทดสอบการประเมินผลผู้สร้างเฉพาะ

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio get-maker-evaluation-test-run

--bot-id

รหัสบอท

--test-run-id

ID การทดสอบการเรียกใช้

พารามิเตอร์ที่เลือกได้สําหรับ copilot-studio get-maker-evaluation-test-run

--columns

รายการคุณสมบัติการตอบกลับที่คั่นด้วยจุลภาคเพื่อรวมในเอาต์พุตตาราง ใช้ --json สําหรับการตอบสนองที่สมบูรณ์

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

get-maker-evaluation-test-run หมาย เหตุ

คุณยังสามารถเรียกใช้คําสั่งนี้โดยใช้ Power Platform REST API Bots - รับการดําเนินการทดสอบการประเมินผู้สร้าง

pac copilot-studio get-maker-evaluation-test-set

(ตัวอย่าง) รับชุดการทดสอบเฉพาะสําหรับการประเมินผลผู้สร้างของบอท

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio get-maker-evaluation-test-set

--bot-id

รหัสบอท

--test-set-id

รหัสชุดการทดสอบ

พารามิเตอร์ที่เลือกได้สําหรับ copilot-studio get-maker-evaluation-test-set

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

get-maker-evaluation-test-set หมาย เหตุ

คุณยังสามารถเรียกใช้คําสั่งนี้โดยใช้ Power Platform REST API Bots - รับชุดการทดสอบการประเมินผู้สร้าง

pac copilot-studio list-maker-evaluation-test-runs

(ตัวอย่าง) แสดงรายการการเรียกใช้การทดสอบการประเมินผู้สร้างทั้งหมดสําหรับบอท

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio list-maker-evaluation-test-runs

--bot-id

รหัสบอท

พารามิเตอร์ที่เลือกได้สําหรับ copilot-studio list-maker-evaluation-test-runs

--columns

รายการคุณสมบัติการตอบกลับที่คั่นด้วยจุลภาคเพื่อรวมในเอาต์พุตตาราง ใช้ --json สําหรับการตอบสนองที่สมบูรณ์

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

list-maker-evaluation-test-runs หมาย เหตุ

คุณยังสามารถเรียกใช้คําสั่งนี้โดยใช้ Power Platform REST API Bots - รายการเรียกใช้การทดสอบการประเมินผู้สร้าง

pac copilot-studio list-maker-evaluation-test-sets

(ตัวอย่าง) เรียกใช้รายการของชุดการทดสอบสําหรับบอทในสภาพแวดล้อมที่ระบุ

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio list-maker-evaluation-test-sets

--bot-id

รหัสบอท

พารามิเตอร์ที่เลือกได้สําหรับ copilot-studio list-maker-evaluation-test-sets

--columns

รายการคุณสมบัติการตอบกลับที่คั่นด้วยจุลภาคเพื่อรวมในเอาต์พุตตาราง ใช้ --json สําหรับการตอบสนองที่สมบูรณ์

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

list-maker-evaluation-test-sets หมาย เหตุ

คุณยังสามารถเรียกใช้คําสั่งนี้โดยใช้ Power Platform REST API Bots - รายการชุดการทดสอบการประเมินผู้สร้าง

pac copilot-studio reassign-copilot-agent

(ตัวอย่าง) มอบหมายเจ้าของบอทใหม่

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio reassign-copilot-agent

--bot-id

รหัสบอท

--new-owner-aad-user-id

Entra ID ของเจ้าของใหม่

พารามิเตอร์ที่เลือกได้สําหรับ copilot-studio reassign-copilot-agent

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

reassign-copilot-agent หมาย เหตุ

คุณยังสามารถเรียกใช้คําสั่งนี้โดยใช้ Power Platform REST API Bots - มอบสิทธิ์ตัวแทน Copilot ใหม่ได้

pac copilot-studio run-maker-evaluation-test-set

(ตัวอย่าง) ทริกเกอร์การเรียกใช้การทดสอบการประเมินผู้สร้างสําหรับชุดการทดสอบเฉพาะ

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio run-maker-evaluation-test-set

--bot-id

รหัสบอท

--test-set-id

รหัสชุดการทดสอบ

พารามิเตอร์ที่เลือกได้สําหรับ copilot-studio run-maker-evaluation-test-set

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

--evaluation-run-name

ชื่อของการเรียกใช้การประเมิน

--mcs-connection-id

ID การเชื่อมต่อสําหรับตัวเชื่อมต่อ MCS ที่ใช้ในการดําเนินการเรียกใช้การประเมิน หรือปล่อยว่างไว้สําหรับการเรียกใช้แบบไม่ระบุชื่อ

--run-on-published-bot

ระบุว่าการดําเนินการควรทํางานบนอินสแตนซ์บอทที่เผยแพร่หรือไม่ ถ้าตั้งค่าเป็น false การดําเนินการจะทํางานบนอินสแตนซ์ของบอทแบบร่าง

--tools-connections

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

run-maker-evaluation-test-set หมาย เหตุ

คุณยังสามารถเรียกใช้คําสั่งนี้โดยใช้ Power Platform REST API Bots - เรียกใช้ชุดการทดสอบการประเมินผู้สร้าง

pac copilot-studio set-bot-as-quarantined

(ตัวอย่าง) ตั้งค่าสถานะการตรวจสอบสินค้าของบอทเป็น จริง

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio set-bot-as-quarantined

--bot-id

รหัสบอท

พารามิเตอร์ที่เลือกได้สําหรับ copilot-studio set-bot-as-quarantined

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

set-bot-as-quarantined หมาย เหตุ

คุณยังสามารถเรียกใช้คําสั่งนี้โดยใช้ Power Platform REST API Bots - ตั้งค่า Bot เป็น Quarantined ได้

pac copilot-studio set-bot-as-unquarantined

(ตัวอย่าง) ตั้งค่าสถานะการตรวจสอบสินค้าของบอทเป็น เท็จ

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio set-bot-as-unquarantined

--bot-id

รหัสบอท

พารามิเตอร์ที่เลือกได้สําหรับ copilot-studio set-bot-as-unquarantined

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

set-bot-as-unquarantined หมาย เหตุ

คุณยังสามารถเรียกใช้คําสั่งนี้โดยใช้ Power Platform REST API Bots - ตั้งค่า Bot เป็นไม่เท่ากัน

pac copilot-studio set-connector-consent-bypass

(ตัวอย่าง) ตั้งค่าตัวเชื่อมต่อผู้ดูแลระบบเลี่ยงผ่านการตั้งค่าสําหรับบอท

พารามิเตอร์ที่จําเป็นสําหรับ copilot-studio set-connector-consent-bypass

--admin-consent-bypass

ระบุว่าจะเปิดใช้งานการยินยอมของตัวเชื่อมต่อผู้ดูแลระบบสําหรับบอทหรือไม่

--bot-id

รหัสบอท

พารามิเตอร์ที่เลือกได้สําหรับ copilot-studio set-connector-consent-bypass

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

set-connector-consent-bypass หมาย เหตุ

คุณยังสามารถเรียกใช้คําสั่งนี้โดยใช้ Power Platform REST API Bots - ตั้งค่าตัวเชื่อมต่อยินยอมบายพาสได้

ดูเพิ่มเติม

กลุ่มคําสั่ง Microsoft Power Platform CLI
ภาพรวม Microsoft Power Platform CLI