pac copilot

Alat dan utilitas untuk manajemen salinan.

initPerintah , , pullclone, push, dan pack memungkinkan Anda menyimpan agen Copilot Studio sebagai sekumpulan file pada disk, mengeditnya secara lokal, dan menyinkronkannya dengan lingkungan Dataverse.

Perulangan umum terlihat seperti ini:

1. Memulai ruang kerja. Buat perancah agen baru dengan pac copilot init, atau unduh agen yang sudah ada dengan pac copilot clone. Bagaimanapun Anda mendapatkan ruang kerja lokal yang membawa metadata sinkronisasi yang bergantung pada perintah lainnya.
2. Tarik sebelum Anda mengedit. pac copilot pull menurunkan perubahan jarak jauh dan menggabungkannya ke dalam file lokal Anda, sehingga Anda memulai dari status server saat ini.
3. Dorong setelah selesai. pac copilot push mengirim kembali perubahan lokal Anda. Jika item yang sama berubah di server sementara itu, dorong berhenti dan meminta Anda untuk menarik terlebih dahulu.
4. Paket untuk penyebaran. pac copilot pack mengubah ruang kerja menjadi solusi .zip yang dapat Anda sebarkan dengan pac solution import.

Untuk pergi dari apa-apa ke agen langsung dalam satu langkah, pac copilot init --environment perancah, paket, impor, dan menghubungkan ruang kerja untuk Anda. Perintah individual memungkinkan Anda mendorong setiap bagian perulangan sendiri.

Commands

pac copilot clone

Kloning agen Copilot Studio ke direktori ruang kerja lokal.

pac copilot clonemengunduh agen Copilot Studio yang ada ke direktori ruang kerja lokal, bersama dengan metadata sinkronisasi yang pac copilot pull dan pac copilot push diandalkan. File agen ditulis ke subfolder bernama sesuai dengan nama tampilannya.

Example

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

Parameter yang Diperlukan untuk copilot clone

--bot -id

ID Copilot atau nama skema (nama unik yang ditemukan di Detail Bot atau nama file di penjelajah solusi).

Parameter Opsional untuk copilot clone

--component-collection -cc

ID koleksi komponen untuk mengkloning. Ulangi untuk beberapa.

--display-name -dn

Nama tampilan agen (digunakan untuk penamaan folder).

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

--output-dir -od

Folder akar untuk output kloning. Default ke direktori saat ini.

Remarks

• --botmenerima ID Copilot atau nama skema. Teruskan ID Copilot (GUID) atau nama skema agen. Perintah menyelesaikan nama skema terhadap lingkungan target.
• Subfolder tujuan harus kosong. Kloning menulis ke dalam folder yang dinamai sesuai dengan nama tampilan agen (disanitasi) di bawah --output-dir. Jika folder tersebut sudah berisi file, kloning akan berhenti daripada menimpanya. Gunakan --display-name untuk memilih nama folder lain.
• Mengkloning koleksi komponen. Untuk menurunkan koleksi komponen bersama agen, berikan satu atau beberapa ID koleksi dengan --component-collection, dipisahkan oleh titik koma.
• Kloning memerlukan profil terautentikasi (pac auth create) dan menyelesaikan lingkungan dari --environment, atau dari organisasi profil aktif saat Anda menghilangkannya.

pac copilot create

Membuat salinan baru menggunakan file templat yang sudah ada sebagai referensi.

Parameter yang Diperlukan untuk copilot create

--displayName

Nama tampilan salinan baru

--schemaName

Nama skema (nama unik) salinan baru.

--solution -s

Nama solusi.

--templateFileName

File yaml sumber yang berisi templat salinan yang diekstrak menggunakan perintah extract-template.

Parameter Opsional untuk copilot create

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

pac copilot delete

Menghapus Copilot Kustom.

Parameter yang Diperlukan untuk copilot delete

--bot -id

ID Copilot atau nama skema (nama unik yang ditemukan di Detail Bot atau nama file di penjelajah solusi).

Parameter Opsional untuk copilot delete

--confirm -y

Diperlukan untuk mengonfirmasi penghapusan salinan.

Parameter ini tidak memerlukan nilai. Ini saklar.

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

pac copilot extract-template

Mengekstrak file templat dari salinan yang ada di lingkungan.

Example

Perintah ini mengekstrak file templat dari salinan yang ada di lingkungan.

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

Perintah mengembalikan output seperti berikut ini untuk salinan menggunakan bahasa Inggris dan Jerman:

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

Parameter yang Diperlukan untuk copilot extract-template

--bot -id

ID Copilot atau nama skema (nama unik yang ditemukan di Detail Bot atau nama file di penjelajah solusi).

--templateFileName

Lokasi file yaml untuk menulis templat salinan.

Parameter Opsional untuk copilot extract-template

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

--overwrite -o

Izinkan penimpaan file data output jika sudah ada.

Parameter ini tidak memerlukan nilai. Ini saklar.

--templateName

Nama templat atau 'kickStartTemplate' jika nama tidak ditentukan.

--templateVersion

Versi templat dalam format X.X.X atau 1.0.0 jika versi tidak ditentukan.

pac copilot extract-translation

Mengekstrak file yang berisi konten yang dilokalkan untuk satu atau beberapa bot.

Example

Perintah ini mengekstrak file yang berisi konten yang dilokalkan untuk satu atau beberapa salinan.

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

Perintah mengembalikan output seperti berikut ini:

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

Parameter Opsional untuk copilot extract-translation

--all -a

Tulis file pelokalan untuk semua bahasa yang didukung. Secara default, hanya bahasa utama yang ditulis.

Parameter ini tidak memerlukan nilai. Ini saklar.

--bot -id

ID Copilot atau nama skema (nama unik yang ditemukan di Detail Bot atau nama file di penjelajah solusi).

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

--format

Format file untuk menulis file yang dilokalkan, baik 'resx' atau 'json'. Defaultnya adalah 'resx'.

--outdir

Direktori output yang akan ditulis.

--overwrite -o

Izinkan penimpaan file data output jika sudah ada.

Parameter ini tidak memerlukan nilai. Ini saklar.

--sourcedir -src

Direktori solusi sumber. Ketika ditentukan, akan mengabaikan lingkungan yang terhubung saat mencari bot dan sebagai gantinya mencari konten di folder solusi.

pac copilot init

Buat ruang kerja agen Copilot Studio baru dari templat.

pac copilot initperancah ruang kerja agen Copilot Studio baru dari templat. Ini berjalan dalam salah satu dari dua mode, dan kehadiran --environment memutuskan mode mana yang akan digunakan:

• Perancah lokal — tidak ada --environment. Menulis file templat ke direktori proyek dan berhenti. Perintah tidak membuat apa pun di Dataverse dan tidak memerlukan masuk. Gunakan mode ini saat Anda ingin menulis secara lokal dan menyambungkan ke lingkungan nanti.
• Bootstrap — --environment disediakan. Perancah file, mengemasnya ke dalam solusi, mengimpor solusi tersebut ke lingkungan, dan menghubungkan ruang kerja ke agen yang baru dibuat. Mode ini adalah jalur satu langkah dari tidak ada ke agen langsung yang siap disinkronkan, dan memerlukan profil yang diautentikasi.

Examples

Perancah ruang kerja secara lokal:

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

Perancah dan bootstrap agen langsung di lingkungan dalam satu langkah:

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

Buat perancah agen yang ditulis CLI (CliCopilot) ke dalam folder tertentu:

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

Parameter yang Diperlukan untuk copilot init

--name -n

Nama tampilan agen.

--publisher-prefix -pp

Publisher awalan penyesuaian untuk solusi.

Parameter Opsional untuk copilot init

--authoring-mode -am

Bentuk penulisan agen ke perancah (default: 'klasik'). Gunakan 'cli-copilot' untuk membuat perancah agen CliCopilot yang ditulis CLI.

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

--instructions -ins

Instruksi sistem agen.

--project-dir -pd

Direktori target untuk ruang kerja agen. Default ke direktori saat ini.

--schema-name -sn

Nama skema agen lengkap. Mengambil alih derivasi default ({publisher-prefix}_{sanitized-name}). Digunakan as-is tanpa modifikasi.

--template -t

Nama profil templat (default, minimal). Default ke 'default'.

Remarks

• Direktori proyek harus kosong. init tidak mengacak file yang ada, jadi arahkan --project-dir ke folder baru atau kosong.
• Derivasi nama skema. Ketika Anda menghilangkan --schema-name, nama skema agen dibuat sebagai {publisher-prefix}_{sanitized-name}. Teruskan --schema-name untuk mengaturnya secara eksplisit; nilai digunakan as-is.
• Bootstrap berfungsi untuk kedua mode penulisan. init --environment bootstrap agen langsung dalam satu langkah untuk mode klasik default dan untuk --authoring-mode cli-copilot. Sebagai alternatif untuk agen CliCopilot, Anda dapat membuat perancah secara lokal (tidak --environment), lalu menjalankan pac copilot pack diikuti dengan pac solution import untuk menyebarkannya sendiri.
• Bootstrap membuat objek sisi server. Dalam mode bootstrap, init mengimpor solusi dan membuat agen di lingkungan target. Jika agen dengan nama skema yang sama sudah ada, init berhenti dan arahkan Anda untuk pac copilot clone tersambung ke agen yang ada sebagai gantinya.
• Lingkungan baru dapat lambat untuk menerima impor pertama. Lingkungan yang baru dibuat mungkin membutuhkan waktu satu atau dua menit untuk pemanasan. Bootstrap awal dapat gagal dengan "Operasi asinkron saat ini dinonaktifkan untuk organisasi ini." Tunggu sebentar dan jalankan lagi.
• --template (default atau minimal) hanya berlaku untuk mode penulisan klasik.

pac copilot list

Daftar salinan di lingkungan Dataverse saat ini atau target.

Example

Perintah ini mencantumkan semua salinan di lingkungan Dataverse saat ini atau target.

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

Perintah mengembalikan output seperti berikut ini:

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

Parameter Opsional untuk copilot list

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

pac copilot mcp

Informasi tentang server MCP (Protokol Konteks Model) lokal.

Example

pac copilot mcp --run

Parameter Opsional untuk copilot mcp

--run -r

Jalankan server MCP (Protokol Konteks Model) lokal.

Parameter ini tidak memerlukan nilai. Ini saklar.

Remarks

Pelajari cara menggunakan CLI Power Platform dengan server MCP bawaan

pac copilot merge-translation

Gabungkan file yang berisi konten yang dilokalkan untuk satu atau beberapa bot.

Example

Perintah ini menggabungkan file yang berisi konten yang dilokalkan untuk satu atau beberapa salinan.

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

Perintah mengembalikan output seperti berikut ini saat memperbarui bahasa Jerman:

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.

Pelajari tentang cara mengelola kesalahan dari perintah merge-translation

Parameter Opsional untuk copilot merge-translation

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

--file -f

Daftar file yang berisi terjemahan. Pola glob didukung.

--solution -s

Nama solusi.

--sourcedir -src

Direktori solusi sumber. Ketika ditentukan, akan mengabaikan lingkungan yang terhubung saat mencari bot dan sebagai gantinya mencari konten di folder solusi.

--verbose

Menghasilkan lebih banyak informasi diagnostik selama impor/ekspor data

Parameter ini tidak memerlukan nilai. Ini saklar.

--whatif

Tidak menjalankan perintah, tetapi menghasilkan detail tentang apa yang akan terjadi.

Parameter ini tidak memerlukan nilai. Ini saklar.

kesalahan merge-translation

Berdasarkan contoh di atas, jika ada satu kesalahan dalam file yang digunakan untuk memperbarui salinan, outputnya terlihat seperti:

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.

Bendera --verbose menambahkan detail tentang kesalahan:

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

Model AI Builder di lingkungan saat ini.

Example

Perintah ini mencantumkan semua model AI Builder.

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

Perintah mengembalikan output seperti berikut ini:

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

Parameter Opsional untuk copilot model list

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

pac copilot model predict

Mengirim teks atau perintah ke Model AI

Parameter Opsional untuk copilot model predict

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

--model-id -id

ID model AI Builder

--model-name -n

Nama Model AI lengkap atau parsial

--prompt -p

Permintaan untuk mengirim ke Model AI

--text -t

Teks untuk dikirim ke Model AI

pac copilot model prepare-fetch

Mengambil file FetchXML dari Model Bahasa Besar AI (LLM) dan menyiapkannya untuk eksekusi terhadap lingkungan saat ini.

Parameter yang Diperlukan untuk copilot model prepare-fetch

--inputFile -i

Input file FetchXML yang biasanya berasal dari AI LLM.

--outputFile -o

File Output FetchXML yang siap dijalankan terhadap lingkungan saat ini.

Parameter Opsional untuk copilot model prepare-fetch

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

pac copilot pack

Kemas ruang kerja agen Copilot Studio ke dalam file zip solusi.

pac copilot pack mengemas ruang kerja agen ke dalam solusi .zip Dataverse yang dapat Anda sebarkan dengan pac solution import. Ini adalah bentuk mandiri dari langkah pengemasan yang pac copilot init --environment berjalan untuk Anda, sehingga Anda dapat menghasilkan solusi yang dapat disebarkan sebagai langkah terpisah — misalnya, dalam alur build. Ini berfungsi untuk ruang kerja agen klasik dan penulisan CLI (CliCopilot).

Example

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

Parameter yang Diperlukan untuk copilot pack

--publisher-prefix -pp

Publisher awalan penyesuaian untuk solusi.

Parameter Opsional untuk copilot pack

--output-path -op

Jalur output untuk file zip solusi. Default ke direktori saat ini.

--project-dir -pd

Direktori ruang kerja agen ke paket. Default ke direktori saat ini.

--solution-name -sn

Nama unik solusi. Jika dihilangkan, berasal dari nama skema agen.

Remarks

• Ini adalah operasi lokal. Paket membaca ruang kerja dan menulis solusi .zip. Ini tidak memerlukan autentikasi dan tidak ada lingkungan, sehingga aman untuk berjalan dalam alur build.
• Awalan penerbit harus valid. --publisher-prefix harus berupa awalan kustomisasi yang terbentuk dengan baik, atau paket berhenti sebelum menulis apa pun.
• Nama solusi dan output. Jika Anda menghilangkan --solution-name, nama unik solusi berasal dari nama skema agen. .zip ditulis ke direktori saat ini kecuali Anda mengatur --output-path.
• Paket tidak disebarkan. Ini menghasilkan solusi tetapi tidak mengimpornya. Ikuti dengan pac solution import untuk menyebarkan agen, maka pac copilot clone jika Anda menginginkan ruang kerja yang terhubung dengan sinkronisasi untuk agen tersebut.

pac copilot publish

Menerbitkan Salinan Kustom

Parameter yang Diperlukan untuk copilot publish

--bot -id

ID Copilot atau nama skema (nama unik yang ditemukan di Detail Bot atau nama file di penjelajah solusi).

Parameter Opsional untuk copilot publish

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

pac copilot pull

Tarik perubahan jarak jauh dari Copilot Studio dan gabungkan dengan ruang kerja lokal.

Perintah pac copilot pull mengambil status server agen saat ini dan menggabungkannya ke ruang kerja lokal Anda dengan menggunakan penggabungan tiga arah. Proses ini memastikan bahwa pengeditan sisi server dan file lokal Anda yang tidak tersentuh tetap utuh. Jalankan sebelum Anda mulai mengedit, dan jalankan lagi sebelum Anda mendorong perubahan Anda.

Example

Jalankan perintah dari dalam folder ruang kerja:

pac copilot pull

Atau arahkan ke ruang kerja di tempat lain pada disk:

pac copilot pull --project-dir contoso-support

Parameter Opsional untuk copilot pull

--project-dir -pd

Jalur ke direktori proyek. Pengaturan default ke direktori kerja saat ini.

Remarks

• Jalankan di dalam ruang kerja sinkronisasi. Perintah pull hanya berfungsi di folder yang dibuat oleh pac copilot clone atau pac copilot init. Ini membaca lingkungan target dan agen dari metadata sinkronisasi ruang kerja, itulah sebabnya tidak --environment ada argumen. Jika Anda menjalankannya di tempat lain, itu gagal dengan kesalahan "ruang kerja tidak ditemukan".
• Ini menulis ke file lokal Anda. Pull menggabungkan perubahan jarak jauh ke ruang kerja dan mengunduh file pengetahuan. Terapkan atau cadangkan pekerjaan lokal yang Anda pedulikan sebelum menarik.
• Masuk terlebih dahulu dengan pac auth create.

pac copilot push

Dorong perubahan ruang kerja lokal ke Copilot Studio.

pac copilot push mengirim perubahan di ruang kerja lokal Anda kembali ke agen di Dataverse. Ini membandingkan file Anda dengan status server terakhir yang diketahui, hanya mengunggah apa yang berubah - termasuk file pengetahuan, alur cloud, dan referensi koneksi - dan melaporkan apa yang didorongnya.

Example

Jalankan dari dalam folder ruang kerja:

pac copilot push

Atau arahkan ke ruang kerja di tempat lain pada disk:

pac copilot push --project-dir contoso-support

Parameter Opsional untuk copilot push

--project-dir -pd

Jalur ke direktori proyek. Pengaturan default ke direktori kerja saat ini.

Remarks

• Jalankan di dalam ruang kerja sinkronisasi. Seperti pull, push hanya berfungsi di folder yang dibuat oleh pac copilot clone atau pac copilot init. Ini membaca lingkungan target dari metadata sinkronisasi ruang kerja. Tidak ada --environment argumen.
• Tarik dulu jika ada konflik. Jika item yang sama berubah baik secara lokal maupun di server, dorong berhenti dan meminta Anda untuk menjalankan pac copilot pull sebelum mencoba lagi. Proses ini menjaga dorongan dari diam-diam menimpa perubahan sisi server yang tidak Anda lihat.
• Tidak ada perubahan lokal yang no-op. Jika push tidak menemukan apa pun untuk dikirim, ia melaporkan bahwa dan keluar tanpa menyentuh lingkungan.
• Dorongan yang berhasil membuat mutasi agen langsung di lingkungan target.
• Masuk terlebih dahulu dengan pac auth create.

pac copilot quarantine

Status karantina agen copilot.

Parameter yang Diperlukan untuk copilot quarantine

--bot-id -id

ID kopilot untuk dikarantina/berhenti dikarantina.

Parameter Opsional untuk copilot quarantine

--environment -env

Lingkungan (ID, ID organisasi, url, nama unik, atau nama parsial).

--status -s

Nilai status karantina. true = karantina, false = batalkan karantina. Secara bawaan diatur menjadi benar.

Parameter ini tidak memerlukan nilai. Ini saklar.

pac copilot status

Polling status penyebaran salinan yang ditentukan di lingkungan Dataverse saat ini atau target.

Example

Perintah ini melakukan polling status penyebaran salinan tertentu di lingkungan Dataverse saat ini atau target.

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

Perintah mengembalikan output seperti berikut ini:

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

Parameter yang Diperlukan untuk copilot status

--bot-id -id

ID salinan (Chatbot).

Parameter Opsional untuk copilot status

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

Autentikasi dan lingkungan untuk perintah sinkronisasi

clonePerintah , pull, push, dan init --environment semuanya berbicara dengan lingkungan Dataverse, sehingga mereka memerlukan profil autentikasi. Masuk terlebih dahulu dengan pac auth create.

• clone, pull, dan push memerlukan profil aktif. pac copilot init hanya membutuhkan satu ketika Anda lulus --environment; tanpa itu, init perancah file secara lokal dan tidak perlu masuk.
• pull dan push baca lingkungan target dari metadata sinkronisasi ruang kerja, sehingga tidak mengambil --environment argumen. clone dan init lakukan.
• pac copilot pack murni lokal. Ini hanya membaca dan menulis file, sehingga tidak memerlukan autentikasi dan tanpa lingkungan.

pull dan push hanya bekerja di dalam ruang kerja yang dibuat oleh clone atau init. Metadata sinkronisasi yang ditulis ketika ruang kerja dibuat adalah apa yang memberi tahu mereka agen dan lingkungan mana yang akan diajak bicara, sehingga menjalankannya di tempat lain gagal dengan cepat dengan kesalahan "ruang kerja tidak ditemukan".

Baca juga

Microsoft Power Platform Grup Perintah CLI
Gambaran umum CLI Microsoft Power Platform