pac copilot

เครื่องมือและโปรแกรมอรรถประโยชน์สําหรับการจัดการตัวนําร่อง

คําสั่ง init, clonepull, pushและ pack ช่วยให้คุณเก็บตัวแทน Copilot Studio เป็นชุดของไฟล์บนดิสก์ แก้ไขภายในเครื่อง และซิงโครไนซ์กับสภาพแวดล้อม Dataverse

รอบ ทั่วไปมีลักษณะดังนี้:

เริ่มต้นพื้นที่ทํางาน ยกระดับตัวแทนใหม่ด้วย pac copilot initหรือดาวน์โหลดที่มีอยู่ด้วยpac copilot clone ไม่ว่าด้วยวิธีใด คุณจะได้รับพื้นที่ทํางานภายในเครื่องที่มีเมตาดาต้าการซิงค์ที่คําสั่งอื่น ๆ ขึ้นอยู่กับ
ดึงก่อนที่คุณจะแก้ไข pac copilot pull นําการเปลี่ยนแปลงจากระยะไกลลงและผสานการเปลี่ยนแปลงเหล่านั้นลงในแฟ้มภายในเครื่องของคุณ เพื่อให้คุณเริ่มต้นจากสถานะเซิร์ฟเวอร์ปัจจุบัน
ส่งเมื่อคุณทําเสร็จแล้ว pac copilot push ส่งการเปลี่ยนแปลงภายในเครื่องของคุณกลับมา ถ้ารายการเดียวกันมีการเปลี่ยนแปลงบนเซิร์ฟเวอร์ในระหว่างนี้ push จะหยุดและขอให้คุณดึงก่อน
แพคเกจสําหรับการปรับใช้ pac copilot pack เปลี่ยนพื้นที่ทํางานเป็นโซลูชัน .zip ที่คุณสามารถปรับใช้ด้วย pac solution importได้

หากต้องการเปลี่ยนจากไม่มีสิ่งใดไปจนถึงตัวแทนถ่ายทอดสดในขั้นตอน pac copilot init --environment เดียว นั่งร้าน ชุด นําเข้า และเชื่อมต่อพื้นที่ทํางานสําหรับคุณ คําสั่งแต่ละรายการช่วยให้คุณสามารถขับรถแต่ละส่วนของลูปด้วยตัวเอง

คำสั่ง

สั่ง	คำอธิบาย
pac copilot clone	โคลนตัวแทน Copilot Studio ไปยังไดเรกทอรีพื้นที่ทํางานภายในเครื่อง
pac copilot create	สร้างตัวนําร่องใหม่โดยใช้ไฟล์แม่แบบที่มีอยู่เป็นการอ้างอิง
pac copilot delete	ลบ Copilot แบบกําหนดเอง
pac copilot extract-template	แยกไฟล์เทมเพลตจากตัวนําร่องที่มีอยู่ในสภาพแวดล้อม
pac copilot extract-translation	แยกไฟล์ที่มีเนื้อหาที่แปลเป็นภาษาท้องถิ่นสําหรับบอทอย่างน้อยหนึ่งรายการ
pac copilot init	สร้างพื้นที่ทํางานตัวแทน Copilot Studio ใหม่จากเทมเพลต
pac copilot list	รายการของตัวนําร่องในสภาพแวดล้อม Dataverse ปัจจุบันหรือเป้าหมาย
pac copilot mcp	ข้อมูลเกี่ยวกับเซิร์ฟเวอร์ MCP (Model Context Protocol) ภายในเครื่อง
pac copilot merge-translation	ผสานไฟล์ที่มีเนื้อหาที่แปลเป็นภาษาท้องถิ่นสําหรับบอทอย่างน้อยหนึ่งตัว
pac copilot model list	แบบจําลอง AI Builder ในสภาพแวดล้อมปัจจุบัน
pac copilot model predict	ส่งข้อความหรือพร้อมท์ไปยังแบบจําลอง AI
pac copilot model prepare-fetch	ใช้ไฟล์ FetchXML จาก AI Large Language Model (LLM) และเตรียมสําหรับการดําเนินการกับสภาพแวดล้อมปัจจุบัน
pac copilot pack	แพคเกจพื้นที่ทํางานของตัวแทน Copilot Studio ลงในไฟล์ zip ของโซลูชัน
pac copilot publish	เผยแพร่ Copilot แบบกําหนดเอง
pac copilot pull	ดึงการเปลี่ยนแปลงระยะไกลจาก Copilot Studio และผสานกับพื้นที่ทํางานภายใน
pac copilot push	ส่งการเปลี่ยนแปลงพื้นที่ทํางานภายในเครื่องไปยัง Copilot Studio
pac copilot quarantine	สถานะการกักกันของตัวแทนนักบินผู้ช่วย
pac copilot status	สํารวจสถานะการปรับใช้ของตัวนําร่องที่ระบุในสภาพแวดล้อม Dataverse ปัจจุบันหรือเป้าหมาย

pac copilot clone

โคลนตัวแทน Copilot Studio ไปยังไดเรกทอรีพื้นที่ทํางานภายในเครื่อง

pac copilot cloneดาวน์โหลดตัวแทน Copilot Studio ที่มีอยู่ลงในไดเรกทอรีพื้นที่ทํางานภายในเครื่อง พร้อมกับเมตาดาต้าการซิงค์ที่ใช้pac copilot pullและpac copilot pushพึ่งพา ไฟล์ของตัวแทนจะถูกเขียนลงในโฟลเดอร์ย่อยที่ชื่อตามชื่อที่แสดง

ตัวอย่าง

pac copilot clone `
   --bot 11111111-1111-1111-1111-111111111111 `
   --environment 22222222-2222-2222-2222-222222222222 `
   --output-dir contoso-support

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

< ค 0 />< ค 1 />

รหัสหรือชื่อ Schema ของ Copilot (ชื่อที่ไม่ซ้ํากันที่พบในรายละเอียดของบอทหรือชื่อไฟล์ในตัวสํารวจโซลูชัน)

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

< ค 0 />< ค 1 />

ID คอลเลกชันคอมโพเนนต์ที่จะลอกแบบ ทําซ้ําสําหรับหลาย

< ค 0 />< ค 1 />

ชื่อที่แสดงของเอเจนต์ (ใช้สําหรับตั้งชื่อโฟลเดอร์)

< ค 0 />< ค 1 />

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

< ค 0 />< ค 1 />

โฟลเดอร์รูทสําหรับเอาต์พุตลอกแบบ ค่าเริ่มต้นเป็นไดเรกทอรีปัจจุบัน

หมาย เหตุ

--botยอมรับชื่อ ID หรือชื่อสคีมา Copilot ส่งผ่าน ID Copilot (GUID) หรือชื่อ Schema ของตัวแทน คําสั่งแก้ไขชื่อเค้าร่างเทียบกับสภาพแวดล้อมเป้าหมาย
โฟลเดอร์ย่อยปลายทางต้องว่างเปล่า ลอกแบบเขียนลงในโฟลเดอร์ที่ชื่อตามชื่อที่แสดงของตัวแทน (ที่ผ่านการฆ่าเชื้อ) ภายใต้--output-dir หากโฟลเดอร์นั้นมีไฟล์อยู่แล้ว ลอกแบบจะหยุดแทนที่จะเขียนทับไฟล์เหล่านั้น ใช้ --display-name เพื่อเลือกชื่อโฟลเดอร์อื่น
การลอกแบบคอลเลกชันคอมโพเนนต์ เมื่อต้องการนําคอลเลกชันคอมโพเนนต์ลงควบคู่ไปกับตัวแทน ส่ง ID คอลเลกชันอย่างน้อยหนึ่งรายการด้วย --component-collectionคั่นด้วยเครื่องหมายอัฒภาค
การลอกแบบจําเป็นต้องมีโปรไฟล์ที่ได้รับการรับรองความถูกต้อง (pac auth create) และแก้ไขสภาพแวดล้อมจาก --environmentหรือจากองค์กรของโปรไฟล์ที่ใช้งานอยู่เมื่อคุณละเว้น

pac copilot create

สร้างตัวนําร่องใหม่โดยใช้ไฟล์แม่แบบที่มีอยู่เป็นการอ้างอิง

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

`--displayName`

ชื่อที่แสดงของ copilot ใหม่

`--schemaName`

ชื่อ Schema (ชื่อที่ไม่ซ้ํา) ของตัวนําร่องใหม่

< ค 0 />< ค 1 />

ชื่อของโซลูชัน

`--templateFileName`

ไฟล์ yaml ต้นทางที่มีเทมเพลต copilot ที่ถูกแยกโดยใช้คําสั่ง extract-template

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

< ค 0 />< ค 1 />

pac copilot delete

ลบ Copilot แบบกําหนดเอง

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

< ค 0 />< ค 1 />

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

< ค 0 />< ค 1 />

จําเป็นต้องยืนยันการลบของตัวนําร่อง

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

< ค 0 />< ค 1 />

pac copilot extract-template

แยกไฟล์เทมเพลตจากตัวนําร่องที่มีอยู่ในสภาพแวดล้อม

ตัวอย่าง

คําสั่งนี้จะแยกไฟล์เทมเพลตจากตัวนําร่องที่มีอยู่ในสภาพแวดล้อม

pac copilot extract-template `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
   --templateFileName NewTestCopilot.yaml

คําสั่งจะส่งกลับผลลัพธ์ดังต่อไปนี้สําหรับตัวนําร่องที่ใช้ภาษาอังกฤษและภาษาเยอรมัน:

Connected as user@contoso.org

Loaded 34 components for bot 'New Test Copilot ' with id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e. Primary language: English, supported languages: German

New Test Copilot -> C:\Users\user\NewTestCopilot.yaml

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

< ค 0 />< ค 1 />

`--templateFileName`

ตําแหน่งที่ตั้งของไฟล์ yaml ที่จะเขียนเทมเพลต copilot

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

< ค 0 />< ค 1 />

อนุญาตให้เขียนทับแฟ้มข้อมูลผลลัพธ์ถ้ามีอยู่แล้ว

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

`--templateName`

ชื่อเทมเพลตหรือ 'kickStartTemplate' ถ้าไม่ได้ระบุชื่อไว้

`--templateVersion`

เวอร์ชันเทมเพลตในรูปแบบ X.X.X หรือ 1.0.0 ถ้าไม่ได้ระบุเวอร์ชัน

pac copilot extract-translation

แยกไฟล์ที่มีเนื้อหาที่แปลเป็นภาษาท้องถิ่นสําหรับบอทอย่างน้อยหนึ่งรายการ

ตัวอย่าง

คําสั่งนี้จะแยกไฟล์ที่มีเนื้อหาที่แปลเป็นภาษาท้องถิ่นสําหรับผู้ควบคุมอย่างน้อยหนึ่งราย

pac copilot extract-translation `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
   --all `
   --outdir . `
   --format json

คําสั่งจะแสดงผลลัพธ์ดังต่อไปนี้:

Connected as user@contoso.org

Loaded 32 components for bot 'New Test Copilot' with id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e. Primary language: English, supported languages: German

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

< ค 0 />< ค 1 />

เขียนไฟล์การแปลเป็นภาษาท้องถิ่นสําหรับภาษาที่สนับสนุนทั้งหมด ตามค่าเริ่มต้น เฉพาะภาษาหลักเท่านั้นที่จะถูกเขียน

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

< ค 0 />< ค 1 />

`--format`

รูปแบบไฟล์ที่จะเขียนไฟล์ที่แปลเป็นภาษาท้องถิ่นไม่ว่าจะเป็น 'resx' หรือ 'json' ค่าเริ่มต้นคือ 'resx'

`--outdir`

ไดเรกทอรีผลลัพธ์ที่จะเขียนถึง

< ค 0 />< ค 1 />

อนุญาตให้เขียนทับแฟ้มข้อมูลผลลัพธ์ถ้ามีอยู่แล้ว

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

< ค 0 />< ค 1 />

ไดเรกทอรีโซลูชันต้นทาง เมื่อระบุแล้ว จะละเว้นสภาพแวดล้อมที่เชื่อมต่อเมื่อค้นหาบอท และค้นหาเนื้อหาในโฟลเดอร์โซลูชันแทน

pac copilot init

สร้างพื้นที่ทํางานตัวแทน Copilot Studio ใหม่จากเทมเพลต

pac copilot initยกระดับพื้นที่ทํางานใหม่ของตัวแทน Copilot Studio จากเทมเพลต ซึ่งทํางานในหนึ่งในสองโหมด และการแสดงต --environment นจะตัดสินใจว่าจะใช้โหมดใด:

นั่งร้านภายในเครื่อง — ไม่ใช่--environment เขียนไฟล์เทมเพลตลงในไดเรกทอรีโครงการและหยุด คําสั่งไม่ได้สร้างอะไรเลยใน Dataverse และไม่จําเป็นต้องลงชื่อเข้าใช้ ใช้โหมดนี้เมื่อคุณต้องการเขียนภายในเครื่องและเชื่อมต่อกับสภาพแวดล้อมในภายหลัง
Bootstrap — --environment ที่ให้มา ยกระดับไฟล์ จัดแพคเกจไฟล์เหล่านั้นลงในโซลูชัน นําเข้าโซลูชันนั้นลงในสภาพแวดล้อม และเชื่อมต่อพื้นที่ทํางานกับตัวแทนที่สร้างขึ้นใหม่ โหมดนี้เป็นเส้นทางแบบขั้นตอนเดียวจากไม่มีอะไรไปจนถึงตัวแทนการถ่ายทอดสดตัวพร้อมการซิงค์และจําเป็นต้องมีโปรไฟล์ที่รับรองความถูกต้อง

ตัวอย่าง

ยกระดับพื้นที่ทํางานภายในเครื่อง:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso

Scaffold และบูทสเตรปตัวแทนถ่ายทอดสดในสภาพแวดล้อมในขั้นตอนเดียว:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --environment 22222222-2222-2222-2222-222222222222

ยกระดับตัวแทน (CliCopilot) ที่เขียนโดย CLI ลงในโฟลเดอร์เฉพาะ:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --authoring-mode cli-copilot `
   --project-dir contoso-support

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

< ค 0 />< ค 1 />

ชื่อที่แสดงของตัวแทน

< ค 0 />< ค 1 />

Publisher คํานําหน้าการกําหนดค่าสําหรับโซลูชัน

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

< ค 0 />< ค 1 />

รูปร่างของตัวแทนการเขียนให้เป็นแบบยกระดับ (ค่าเริ่มต้น: 'คลาสสิก') ใช้ 'cli-copilot' เพื่อยกระดับตัวแทน CliCopilot ที่สร้างโดย CLI

< ค 0 />< ค 1 />

คําแนะนําของระบบตัวแทน

< ค 0 />< ค 1 />

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

< ค 0 />< ค 1 />

ชื่อสคีมาของตัวแทนแบบเต็ม แทนที่การสืบทอดค่าเริ่มต้น ({publisher-prefix}_{sanitized-name}) ใช้ as-is โดยไม่มีการแก้ไข

< ค 0 />< ค 1 />

ชื่อโปรไฟล์เทมเพลต (ค่าเริ่มต้น น้อยที่สุด) ค่าเริ่มต้นเป็น 'ค่าเริ่มต้น'

หมาย เหตุ

ไดเรกทอรีโครงการต้องว่างเปล่า init ไม่ยกระดับเหนือไฟล์ที่มีอยู่ ดังนั้นให้ชี้ไปที่ --project-dir โฟลเดอร์ใหม่หรือที่ว่างเปล่า
การสืบทอดชื่อเค้าร่าง เมื่อคุณไม่ใช้ --schema-nameชื่อเค้าร่างตัวแทนถูกสร้างขึ้นเป็น{publisher-prefix}_{sanitized-name} ส่งผ่าน --schema-name เพื่อตั้งค่าอย่างชัดเจน ค่า จะถูกใช้ as-is
Bootstrap ทํางานสําหรับโหมดการเขียนทั้งสอง init --environmentบูทสเตรปตัวแทนการถ่ายทอดสดในขั้นตอนเดียวสําหรับโหมดคลาสสิกเริ่มต้นและสําหรับ--authoring-mode cli-copilot เป็นทางเลือกสําหรับตัวแทน CliCopilot คุณสามารถนั่งร้านภายในเครื่อง (ไม่มี --environment) จากนั้นเรียกใช้ pac copilot pack ตามด้วย pac solution import เพื่อปรับใช้ด้วยตัวคุณเอง
Bootstrap สร้างวัตถุฝั่งเซิร์ฟเวอร์ ในโหมด init bootstrap นําเข้าโซลูชัน และสร้างตัวแทนในสภาพแวดล้อมเป้าหมาย ถ้าตัวแทนที่มีชื่อแผนการเดียวกันมี init อยู่แล้ว หยุดและชี้ให้คุณ pac copilot clone เชื่อมต่อกับตัวแทนที่มีอยู่แทน
สภาพแวดล้อมใหม่อาจช้าในการยอมรับการนําเข้าครั้งแรก สภาพแวดล้อมที่สร้างขึ้นใหม่อาจใช้เวลาหนึ่งหรือสองนาทีในการอุ่นเครื่อง การเริ่มต้นระบบในช่วงแรกอาจล้มเหลวด้วย "การดําเนินการต่างเวลาในขณะนี้ถูกปิดใช้งานสําหรับองค์กรนี้" รอสักครู่แล้วเรียกใช้อีกครั้ง
--template (default หรือ minimal) นําไปใช้กับโหมดการเขียนแบบคลาสสิกเท่านั้น

pac copilot list

รายการของตัวนําร่องในสภาพแวดล้อม Dataverse ปัจจุบันหรือเป้าหมาย

ตัวอย่าง

คําสั่งนี้แสดงรายการตัวนําร่องทั้งหมดในสภาพแวดล้อม Dataverse ปัจจุบันหรือเป้าหมาย

pac copilot list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118

คําสั่งจะแสดงผลลัพธ์ดังต่อไปนี้:

Name                           Bot ID                               Component State Is Managed Solution ID                          Status Code State Code
Ask Me Anything Copilot       584e012c-dc95-46d6-af5a-1263b6a44342 Published       Unmanaged  285af946-6383-49a0-8615-4e2afafeaf38 Active      Provisioned
New Test Copilot               9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e Published       Unmanaged  285af946-6383-49a0-8615-4e2afafeaf38 Active      Provisioned

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

< ค 0 />< ค 1 />

pac copilot mcp

ข้อมูลเกี่ยวกับเซิร์ฟเวอร์ MCP (Model Context Protocol) ภายในเครื่อง

ตัวอย่าง

pac copilot mcp --run

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

< ค 0 />< ค 1 />

เรียกใช้เซิร์ฟเวอร์ภายในเครื่อง MCP (โพรโทคอลบริบทแบบจําลอง)

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

หมาย เหตุ

เรียนรู้วิธีการใช้ Power Platform CLI กับเซิร์ฟเวอร์ MCP ที่มีอยู่ภายใน

pac copilot merge-translation

ผสานไฟล์ที่มีเนื้อหาที่แปลเป็นภาษาท้องถิ่นสําหรับบอทอย่างน้อยหนึ่งตัว

ตัวอย่าง

คําสั่งนี้ผสานไฟล์ที่มีเนื้อหาที่แปลเป็นภาษาท้องถิ่นสําหรับผู้ควบคุมอย่างน้อยหนึ่งราย

pac copilot merge-translation `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --file ms_store_newTestCopilot.de-DE.json `
   --solution SolutionName

คําสั่งจะแสดงผลลัพธ์ดังต่อไปนี้เมื่ออัปเดตภาษาเยอรมัน:

Connected as user@contoso.org

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 0 key(s) were missing, 0 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

เรียนรู้เกี่ยวกับวิธีการจัดการข้อผิดพลาดจากคําสั่งการแปลแบบผสาน

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

< ค 0 />< ค 1 />

รายการของไฟล์ที่มีการแปล สนับสนุนรูปแบบ Glob

< ค 0 />< ค 1 />

ชื่อของโซลูชัน

< ค 0 />< ค 1 />

`--verbose`

ส่งออกข้อมูลการวินิจฉัยเพิ่มเติมในระหว่างการนําเข้า/ส่งออกข้อมูล

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

`--whatif`

ไม่ดําเนินการคําสั่ง แต่แสดงรายละเอียดของสิ่งที่จะเกิดขึ้น

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

ข้อผิดพลาดในการผสานการแปล

ตามตัวอย่างข้างต้น ถ้ามีข้อผิดพลาดหนึ่งข้ออยู่ในไฟล์ที่ใช้ในการอัปเดตตัวนําสัญญาณ ผลลัพธ์จะมีลักษณะดังนี้:

Connected as user@contoso.org

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 1 key(s) were missing, 1 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

ค่า --verbose สถานะจะเพิ่มรายละเอียดเกี่ยวกับข้อผิดพลาด:

Connected as user@contoso.org

Missing translation key: 'dialog(ms_store_newTestCopilot.topic.Lesson2)'.'trigger(main)'.'action(LbWwpD)'.Entity.Definition.'closedListItem(Redmond)'.DisplayName.

Unused translation: 'dialog(ms_store_newTestCopilot.topic.Lesson2)'.'trigger(main)'.'action(LbWwpD)'.Entity.Definition.'closedListItem(Redmont)'.DisplayName, value: Redmond

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 1 key(s) were missing, 1 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

pac copilot model list

แบบจําลอง AI Builder ในสภาพแวดล้อมปัจจุบัน

ตัวอย่าง

คําสั่งนี้จะแสดงรายการแบบจําลอง AI Builder ทั้งหมด

pac copilot model list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118

คําสั่งจะแสดงผลลัพธ์ดังต่อไปนี้:

Id                                   State    Name
32a9e265-1149-4155-af54-d2856d2b83f5 Active   Document Processing 2023/09/20, 12:21:40
2bcd7b94-50bc-4767-af4a-367c63fb5487 Inactive AI Classify
4e72b59a-17d6-451e-8657-89fbdec56d7a Inactive AI Extract
572f57a7-7a8f-49fc-adb4-331e02c509a6 Inactive AI Reply
b9b636cf-9748-47a7-b617-6df5f00f5151 Inactive AI Sentiment
c076eac8-f218-4feb-8ad1-7ee4fb039419 Inactive AI Summarize
a0440df3-2656-e911-8194-000d3a6cd5a5 Inactive BusinessCard model
62d1e848-5ca7-490a-94bf-79baabe85ef4 Inactive CategoryClassification model
4da7ec17-5c26-4fd2-9ddb-be4f7eda21a9 Inactive DataGenieEmailAddressValidation
51f4da11-5702-401d-b53a-9638744e8ac9 Inactive Document Layout Analysis Model
d1bb8d57-24ab-3b36-9592-bd792e153b79 Inactive DVCopilotQueryModel
3fbd4e5c-32bc-40fc-acce-59c2821cf113 Inactive Empty Dynamic Prompt
8c281981-c5d6-484f-bac7-4924ddd0b8ae Inactive EntityExtraction model
a1afa5d4-7a44-4c31-9cd2-e852a78431fa Inactive GptPromptEngineering model
2c444168-f8b1-4c6a-9313-2d9c03be6fea Inactive Id Scanning Model
77365cfa-7021-4cb7-a9b2-dc9823cde772 Inactive ImageDescription model
aef1bdd2-2a74-4f74-b4eb-9dfa22e35ded Inactive Invoice Model
5ed4d0fd-e9d4-4026-b09b-71f83ea90c60 Inactive Invoice Processing Model
c8425db7-c5a7-4226-b38e-c93a044c0fe1 Inactive KeyPhraseExtraction model
17a6f893-5b0b-4867-8fac-fb2eda9080b2 Inactive LanguageDetection model
046ab801-2756-e911-8194-000d3a6cd5a5 Inactive ObjectDetectionProposal model
892d3698-ba03-3d15-8e9e-843ca4ac5e7d Inactive PowerAppsAppCopilotModel
baa44529-bebe-49e6-837a-80bee63b0d2c Inactive Receipt Scanning Model
f1c549c2-a97e-47a5-b612-c5c2bab0f163 Inactive SentimentAnalysis model
7f8a7856-003a-3662-9871-0000d7674433 Inactive SimsModel
86419a67-205a-454f-b6fc-601394f2786d Inactive TextRecognition model
6225038a-8b5a-4913-bfd2-d8236f4102ba Inactive TextTranslation model
02e1fca3-232a-4f58-8c93-bdd8c9cd6de9 Inactive TextTranslationInternal model

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

< ค 0 />< ค 1 />

pac copilot model predict

ส่งข้อความหรือพร้อมท์ไปยังแบบจําลอง AI

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

< ค 0 />< ค 1 />

รหัสแบบจําลอง AI Builder

< ค 0 />< ค 1 />

ชื่อแบบจําลอง AI แบบเต็มหรือบางส่วน

< ค 0 />< ค 1 />

แจ้งให้ส่งไปยังแบบจําลอง AI

< ค 0 />< ค 1 />

ข้อความที่จะส่งไปยังแบบจําลอง AI

pac copilot model prepare-fetch

ใช้ไฟล์ FetchXML จาก AI Large Language Model (LLM) และเตรียมสําหรับการดําเนินการกับสภาพแวดล้อมปัจจุบัน

พารามิเตอร์ที่จําเป็นสําหรับ copilot model prepare-fetch

< ค 0 />< ค 1 />

ไฟล์ FetchXML ที่มักจะมาจาก AI LLM

< ค 0 />< ค 1 />

ไฟล์เอาท์พุท FetchXML ที่พร้อมที่จะดําเนินการกับสภาพแวดล้อมปัจจุบัน

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

< ค 0 />< ค 1 />

pac copilot pack

แพคเกจพื้นที่ทํางานของตัวแทน Copilot Studio ลงในไฟล์ zip ของโซลูชัน

pac copilot packแพคเกจพื้นที่ทํางานของตัวแทนลงในโซลูชัน .zip Dataverse ที่คุณสามารถปรับใช้ด้วยpac solution import เป็นรูปแบบสแตนด์อโลนของขั้นตอนบรรจุภัณฑ์ที่ทํางาน pac copilot init --environment สําหรับคุณดังนั้นคุณสามารถสร้างโซลูชันที่ปรับใช้ได้เป็นขั้นตอนแยกต่างหากตัวอย่างเช่นในไปป์ไลน์สร้าง ใช้ได้กับพื้นที่ทํางานของตัวแทน (CliCopilot) แบบคลาสสิกและ CLI

ตัวอย่าง

pac copilot pack `
   --publisher-prefix contoso `
   --project-dir contoso-support `
   --output-path out

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

< ค 0 />< ค 1 />

Publisher คํานําหน้าการกําหนดค่าสําหรับโซลูชัน

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

< ค 0 />< ค 1 />

เส้นทางผลลัพธ์สําหรับไฟล์ zip ของโซลูชัน ค่าเริ่มต้นเป็นไดเรกทอรีปัจจุบัน

< ค 0 />< ค 1 />

ไดเรกทอรีพื้นที่ทํางานของตัวแทนในแพคเกจ ค่าเริ่มต้นเป็นไดเรกทอรีปัจจุบัน

< ค 0 />< ค 1 />

ชื่อเฉพาะของโซลูชัน ถ้าเว้นไว้ จะสืบทอดมาจากชื่อเค้าร่างของบริษัทตัวแทน

หมาย เหตุ

มันเป็นการดําเนินงานในท้องถิ่น Pack อ่านพื้นที่ทํางานและเขียนโซลูชัน.zip ซึ่งไม่จําเป็นต้องมีการรับรองความถูกต้องและไม่มีสภาพแวดล้อม ดังนั้นจึงปลอดภัยที่จะเรียกใช้ในไปป์ไลน์การสร้าง
คํานําหน้าผู้เผยแพร่ต้องถูกต้อง --publisher-prefix ต้องเป็นคํานําหน้าการกําหนดค่าที่ได้การจัดรูปแบบอย่างดี หรือการหยุดแพ็คก่อนที่จะเขียนสิ่งใดๆ
ชื่อโซลูชันและผลลัพธ์ ถ้าคุณไม่ใช้ --solution-nameชื่อที่ไม่ซ้ํากันของโซลูชันจะสืบทอดมาจากชื่อ Schema ของตัวแทน .zipถูกเขียนไปยังไดเรกทอรีปัจจุบันเว้นแต่ว่าคุณตั้งค่า--output-path
Pack ไม่ปรับใช้ สร้างโซลูชัน แต่ไม่นําเข้า ติดตามด้วย pac solution import เพื่อปรับใช้ตัวแทน จากนั้น pac copilot clone ถ้าคุณต้องการพื้นที่ทํางานที่เชื่อมต่อการซิงค์สําหรับมัน

pac copilot publish

เผยแพร่ Copilot แบบกําหนดเอง

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

< ค 0 />< ค 1 />

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

< ค 0 />< ค 1 />

pac copilot pull

ดึงการเปลี่ยนแปลงระยะไกลจาก Copilot Studio และผสานกับพื้นที่ทํางานภายใน

คําสั่ง pac copilot pull ดึงสถานะเซิร์ฟเวอร์ปัจจุบันของตัวแทน และผสานลงในพื้นที่ทํางานภายในเครื่องของคุณโดยใช้การผสานแบบสามทาง กระบวนการนี้ช่วยให้มั่นใจว่าการแก้ไขฝั่งเซิร์ฟเวอร์และไฟล์ภายในเครื่องที่ไม่ได้แตะต้องของคุณจะยังคงเหมือนเดิม เรียกใช้ก่อนที่คุณจะเริ่มแก้ไขและเรียกใช้อีกครั้งก่อนที่คุณจะส่งการเปลี่ยนแปลงของคุณ

ตัวอย่าง

เรียกใช้คําสั่งจากภายในโฟลเดอร์พื้นที่ทํางาน:

pac copilot pull

หรือชี้ไปยังพื้นที่ทํางานที่อื่นบนดิสก์:

pac copilot pull --project-dir contoso-support

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

< ค 0 />< ค 1 />

เส้นทางไปยังไดเรกทอรีโครงการ ค่าเริ่มต้นของไดเรกทอรีการทํางานปัจจุบัน

หมาย เหตุ

เรียกใช้ภายในพื้นที่ทํางานการซิงค์ คําสั่ง pull ทํางานเฉพาะในโฟลเดอร์ที่สร้างขึ้นโดย pac copilot clone หรือpac copilot init โดยจะอ่านสภาพแวดล้อมเป้าหมายและตัวแทนจากเมตาดาต้าการซิงค์ของพื้นที่ทํางาน ซึ่งเป็นเหตุผลที่ไม่มี --environment อาร์กิวเมนต์ ถ้าคุณเรียกใช้จากที่อื่น จะล้มเหลวด้วยข้อผิดพลาด "ไม่พบพื้นที่ทํางาน"
ซึ่งเขียนไปยังไฟล์ภายในเครื่องของคุณ ดึงผสานการเปลี่ยนแปลงระยะไกลลงในพื้นที่ทํางานและดาวน์โหลดไฟล์ความรู้ ยอมรับหรือสํารองข้อมูลงานในเครื่องที่คุณใส่ใจก่อนดึง
ลงชื่อเข้าใช้ก่อนด้วยpac auth create

pac copilot push

ส่งการเปลี่ยนแปลงพื้นที่ทํางานภายในเครื่องไปยัง Copilot Studio

pac copilot push ส่งการเปลี่ยนแปลงในพื้นที่ทํางานภายในเครื่องของคุณกลับไปยังตัวแทนใน Dataverse ซึ่งจะเปรียบเทียบไฟล์ของคุณกับสถานะเซิร์ฟเวอร์ที่รู้จักล่าสุด อัปโหลดเฉพาะสิ่งที่เปลี่ยนแปลง รวมถึงไฟล์ความรู้ โฟลว์ระบบคลาวด์ และการอ้างอิงการเชื่อมต่อ และรายงานสิ่งที่ส่งไป

ตัวอย่าง

เรียกใช้จากภายในโฟลเดอร์พื้นที่ทํางาน:

pac copilot push

หรือชี้ไปยังพื้นที่ทํางานที่อื่นบนดิสก์:

pac copilot push --project-dir contoso-support

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

< ค 0 />< ค 1 />

หมาย เหตุ

เรียกใช้ภายในพื้นที่ทํางานการซิงค์ pushเช่น pullทํางานในโฟลเดอร์ที่สร้างโดย pac copilot clone หรือ pac copilot initเท่านั้น ซึ่งจะอ่านสภาพแวดล้อมเป้าหมายจากเมตาดาต้าการซิงค์ของพื้นที่ทํางาน ไม่มี --environment อาร์กิวเมนต์
ดึงก่อนถ้ามีความขัดแย้ง ถ้ารายการเดียวกันเปลี่ยนแปลงทั้งภายในเครื่องและบนเซิร์ฟเวอร์ push จะหยุดและขอให้คุณเรียกใช้ pac copilot pull ก่อนที่จะลองอีกครั้ง กระบวนการนี้จะเก็บการส่งแบบพุชจากการเขียนทับการเปลี่ยนแปลงฝั่งเซิร์ฟเวอร์ที่คุณไม่เห็นโดยไม่เงียบ
ไม่มีการเปลี่ยนแปลงภายในเครื่องเป็น no-op ถ้า push ไม่พบสิ่งใดในการส่ง จะรายงานว่าและออกจากระบบโดยไม่ต้องสัมผัสสภาพแวดล้อม
การพุชที่ประสบความสําเร็จจะกลายพันธุ์ตัวแทนการถ่ายทอดสด ในสภาพแวดล้อมเป้าหมาย
ลงชื่อเข้าใช้ก่อนด้วยpac auth create

pac copilot quarantine

สถานะการกักกันของตัวแทนนักบินผู้ช่วย

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

< ค 0 />< ค 1 />

ID ของนักบินผู้ช่วยในการกักกัน/ยกเลิกการกักกัน

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

< ค 0 />< ค 1 />

สภาพแวดล้อม (ID, รหัสองค์กร, url, ชื่อที่ไม่ซ้ํา หรือชื่อบางส่วน)

< ค 0 />< ค 1 />

ค่าสถานะการกักกัน จริง = กักกัน เท็จ = ไม่กักกัน ค่าเริ่มต้นเป็นจริง

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

pac copilot status

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

ตัวอย่าง

คําสั่งนี้จะสํารวจสถานะการปรับใช้ของตัวนําร่องที่ระบุในสภาพแวดล้อม Dataverse ปัจจุบันหรือเป้าหมาย

pac copilot status `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot-id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e

คําสั่งจะแสดงผลลัพธ์ดังต่อไปนี้:

Connected as user@contoso.org
Connected to... Contoso Organization
Virtual Agent New Bot German with ID 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e has been provisioned.

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

< ค 0 />< ค 1 />

ID ของนักบิน (แชทบอท)

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

< ค 0 />< ค 1 />

การรับรองความถูกต้องและสภาพแวดล้อมสําหรับคําสั่งซิงค์

คําสั่ง clone, pull, pushและ init --environment ทั้งหมดพูดกับสภาพแวดล้อม Dataverse ดังนั้นพวกเขาจึงจําเป็นต้องมีโปรไฟล์การรับรองความถูกต้อง ลงชื่อเข้าใช้ก่อนด้วยpac auth create

clone, pullและ push จําเป็นต้องมีโปรไฟล์ที่ใช้งานอยู่ pac copilot init ต้องการเพียงหนึ่งเมื่อคุณส่งผ่าน --environment; หากไม่มี init ไฟล์ scaffolds ภายในเครื่องและไม่จําเป็นต้องลงชื่อเข้าใช้
pull และ push อ่านสภาพแวดล้อมเป้าหมายจากเมตาดาต้าการซิงค์ของพื้นที่ทํางาน ดังนั้นจึงไม่ใช้ --environment อาร์กิวเมนต์ clone และ init ทํา
pac copilot pack เป็นท้องถิ่นอย่างแท้จริง ซึ่งอ่านและเขียนไฟล์เท่านั้นดังนั้นจึงไม่จําเป็นต้องมีการรับรองความถูกต้องและไม่มีสภาพแวดล้อม

pullและpushทํางานเฉพาะภายในพื้นที่ทํางานที่สร้างขึ้นโดย clone หรือinit เมตาดาต้าการซิงค์ที่เขียนขึ้นเมื่อมีการสร้างพื้นที่ทํางานคือสิ่งที่บอกพวกเขาว่าตัวแทนและสภาพแวดล้อมใดที่ต้องพูดคุยด้วย ดังนั้น การเรียกใช้ที่ใดก็ตามจะล้มเหลวอย่างรวดเร็วด้วยข้อผิดพลาด "ไม่พบพื้นที่ทํางาน"

ดูเพิ่มเติม

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

คำติชม

หน้านี้มีประโยชน์หรือไม่

Last updated on 2026-07-14