pac copilot

Alat dan utiliti untuk pengurusan juruterbang.

initPerintah , clone, pull, pushdan pack membolehkan anda menyimpan ejen Copilot Studio sebagai satu set fail pada cakera, mengeditnya secara tempatan dan menyegerakkannya dengan persekitaran Dataverse.

Gelung biasa kelihatan seperti ini:

1. Mulakan ruang kerja. Perancah ejen serba baharu dengan pac copilot init, atau muat turun ejen sedia ada dengan pac copilot clone. Walau apa pun, anda mendapat ruang kerja tempatan yang membawa metadata penyegerakan yang bergantung kepada arahan lain.
2. Tarik sebelum anda mengedit. pac copilot pull Menurunkan perubahan jauh dan menggabungkannya ke dalam fail tempatan anda, jadi anda bermula dari keadaan pelayan semasa.
3. Tolak apabila anda selesai. pac copilot push menghantar semula perubahan setempat anda. Jika item yang sama berubah pada pelayan sementara itu, tekan berhenti dan meminta anda menarik terlebih dahulu.
4. Pakej untuk penggunaan. pac copilot pack menukar ruang kerja kepada penyelesaian .zip yang boleh anda gunakan dengan pac solution import.

Untuk beralih daripada tiada kepada ejen langsung dalam satu langkah, pac copilot init --environment perancah, pek, import dan sambungkan ruang kerja untuk anda. Arahan individu membolehkan anda memacu setiap bahagian gelung sendiri.

Perintah

pac copilot clone

Klon ejen Copilot Studio ke direktori ruang kerja tempatan.

pac copilot clonememuat turun ejen Copilot Studio sedia ada ke dalam direktori ruang kerja tempatan, bersama-sama dengan metadata penyegerakan yang dan pac copilot pullpac copilot push bergantung. Fail ejen ditulis ke subfolder yang dinamakan sempena nama paparannya.

Contoh

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 terdapat dalam Butiran Bot atau nama fail dalam penjelajah penyelesaian).

Parameter Pilihan untuk copilot clone

--component-collection -cc

ID koleksi komponen untuk mengklon. Ulangi untuk berbilang.

--display-name -dn

Nama paparan ejen (digunakan untuk penamaan folder).

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

--output-dir -od

Folder akar untuk output klon. Lalai kepada direktori semasa.

Kenyataan

• --botmenerima ID Copilot atau nama skema. Lulus sama ada ID Copilot (GUID) atau nama skema ejen. Perintah menyelesaikan nama skema terhadap persekitaran sasaran.
• Subfolder destinasi mestilah kosong. Klon menulis ke dalam folder yang dinamakan sempena nama paparan ejen (dibersihkan) di bawah --output-dir. Jika folder itu sudah mengandungi fail, klon berhenti dan bukannya menimpanya. Gunakan --display-name untuk memilih nama folder yang berbeza.
• Pengklonan koleksi komponen. Untuk menurunkan koleksi komponen bersama ejen, hantar satu atau lebih ID koleksi dengan --component-collection, dipisahkan dengan titik koma.
• Klon memerlukan profil yang disahkan (pac auth create) dan menyelesaikan persekitaran daripada --environment, atau daripada organisasi profil aktif apabila anda meninggalkannya.

pac copilot create

Mencipta copilot baharu menggunakan fail templat sedia ada sebagai rujukan.

Parameter yang diperlukan untuk copilot create

--displayName

Nama paparan juruterbang baharu

--schemaName

Nama skema (nama unik) juruterbang baharu.

--solution -s

Nama penyelesaian.

--templateFileName

Fail yaml sumber yang mengandungi templat copilot yang diekstrak menggunakan arahan templat ekstrak.

Parameter Pilihan untuk copilot create

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

pac copilot delete

Padamkan Copilot Tersuai.

Parameter yang diperlukan untuk copilot delete

--bot -id

ID Copilot atau nama skema (nama unik yang terdapat dalam Butiran Bot atau nama fail dalam penjelajah penyelesaian).

Parameter Pilihan untuk copilot delete

--confirm -y

Diperlukan untuk mengesahkan pemadaman juruterbang.

Parameter ini tidak memerlukan nilai. Ia adalah suis.

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

pac copilot extract-template

Mengekstrak fail templat daripada copilot sedia ada dalam persekitaran.

Contoh

Perintah ini mengekstrak fail templat daripada copilot sedia ada dalam persekitaran.

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

Perintah mengembalikan output seperti berikut untuk juruterbang menggunakan bahasa Inggeris 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 terdapat dalam Butiran Bot atau nama fail dalam penjelajah penyelesaian).

--templateFileName

Lokasi fail yaml untuk menulis templat copilot.

Parameter Pilihan untuk copilot extract-template

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

--overwrite -o

Benarkan timpa fail data output jika ia sudah wujud.

Parameter ini tidak memerlukan nilai. Ia adalah suis.

--templateName

Nama templat atau 'kickStartTemplate' jika nama tidak dinyatakan.

--templateVersion

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

pac copilot extract-translation

Mengekstrak fail yang mengandungi kandungan setempat untuk satu atau lebih bot.

Contoh

Perintah ini mengekstrak fail yang mengandungi kandungan setempat untuk satu atau lebih juruterbang.

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:

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 Pilihan untuk copilot extract-translation

--all -a

Tulis fail penyetempatan untuk semua bahasa yang disokong. Secara lalai, hanya bahasa utama yang ditulis.

Parameter ini tidak memerlukan nilai. Ia adalah suis.

--bot -id

ID Copilot atau nama skema (nama unik yang terdapat dalam Butiran Bot atau nama fail dalam penjelajah penyelesaian).

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

--format

Format fail untuk menulis fail setempat, sama ada 'resx' atau 'json'. Lalai ialah 'resx'.

--outdir

Direktori output untuk ditulis.

--overwrite -o

Benarkan timpa fail data output jika ia sudah wujud.

Parameter ini tidak memerlukan nilai. Ia adalah suis.

--sourcedir -src

Direktori penyelesaian sumber. Apabila ditentukan, akan mengabaikan persekitaran yang disambungkan apabila mencari bot dan sebaliknya mencari kandungan dalam folder penyelesaian.

pac copilot init

Cipta ruang kerja ejen Copilot Studio baharu daripada templat.

pac copilot initperancah ruang kerja ejen Copilot Studio baharu daripada templat. Ia berjalan dalam salah satu daripada dua mod, dan kehadiran menentukan --environment mod mana yang hendak digunakan:

• Perancah tempatan — tidak --environment. Menulis fail templat ke dalam direktori projek dan berhenti. Perintah tidak mencipta apa-apa dalam Dataverse dan tidak memerlukan log masuk. Gunakan mod ini apabila anda mahu mengarang secara tempatan dan menyambung ke persekitaran kemudian.
• Bootstrap — --environment dibekalkan. Perancah fail, membungkusnya ke dalam penyelesaian, mengimport penyelesaian itu ke dalam persekitaran dan menyambungkan ruang kerja kepada ejen yang baru dicipta. Mod ini ialah laluan satu langkah daripada tiada kepada ejen sedia penyegerakan secara langsung dan ia memerlukan profil yang disahkan.

Contoh

Perancah ruang kerja secara tempatan:

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

Perancah dan bootstrap ejen langsung dalam persekitaran dalam satu langkah:

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

Perancah ejen yang dikarang 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 paparan ejen.

--publisher-prefix -pp

Awalan penyesuaian Publisher untuk penyelesaian.

Parameter Pilihan untuk copilot init

--authoring-mode -am

Bentuk pengarang ejen kepada perancah (lalai: 'klasik'). Gunakan 'cli-copilot' untuk merancah ejen CliCopilot yang dikarang CLI.

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

--instructions -ins

Arahan sistem ejen.

--project-dir -pd

Direktori sasaran untuk ruang kerja ejen. Lalai kepada direktori semasa.

--schema-name -sn

Nama skema ejen penuh. Menggantikan terbitan lalai ({publisher-prefix}_{sanitized-name}). Digunakan as-is tanpa pengubahsuaian.

--template -t

Nama profil templat (lalai, minimum). Lalai kepada 'lalai'.

Kenyataan

• Direktori projek mestilah kosong. init tidak perancah ke atas fail sedia ada, jadi tuding --project-dir ke folder baharu atau kosong.
• Terbitan nama skema. Apabila anda meninggalkan --schema-name, nama skema ejen dibina sebagai {publisher-prefix}_{sanitized-name}. Lulus --schema-name untuk menetapkannya secara eksplisit; nilai digunakan as-is.
• Bootstrap berfungsi untuk kedua-dua mod pengarangan. init --environment bootstrap ejen langsung dalam satu langkah untuk mod klasik lalai dan untuk --authoring-mode cli-copilot. Sebagai alternatif untuk ejen CliCopilot, anda boleh perancah secara tempatan (tidak --environment), kemudian jalankan pac copilot pack diikuti dengan pac solution import menggunakannya sendiri.
• Bootstrap mencipta objek bahagian pelayan. Dalam mod bootstrap, init mengimport penyelesaian dan mencipta ejen dalam persekitaran sasaran. Jika ejen dengan nama skema yang sama sudah wujud, init berhenti dan mengarahkan anda pac copilot clone untuk menyambung ke ejen sedia ada.
• Persekitaran serba baharu boleh menjadi lambat untuk menerima import pertama. Persekitaran yang baru dicipta mungkin mengambil masa satu atau dua minit untuk memanaskan badan. Bootstrap awal boleh gagal dengan "Operasi tak selacak pada masa ini dilumpuhkan untuk organisasi ini." Tunggu sebentar dan jalankan lagi.
• --template (default atau minimal) digunakan untuk mod pengarangan klasik sahaja.

pac copilot list

Senarai copilot dalam persekitaran Dataverse semasa atau sasaran.

Contoh

Perintah ini menyenaraikan semua copilot dalam persekitaran Dataverse semasa atau sasaran.

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

Perintah mengembalikan output seperti berikut:

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 Pilihan untuk copilot list

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

pac copilot mcp

Maklumat tentang pelayan MCP (Model Context Protocol) tempatan.

Contoh

pac copilot mcp --run

Parameter Pilihan untuk copilot mcp

--run -r

Jalankan pelayan MCP (Protokol Konteks Model) tempatan.

Parameter ini tidak memerlukan nilai. Ia adalah suis.

Kenyataan

Ketahui cara menggunakan CLI Power Platform dengan pelayan MCP terbina dalam

pac copilot merge-translation

Gabungkan fail yang mengandungi kandungan setempat untuk satu atau lebih bot.

Contoh

Perintah ini menggabungkan fail yang mengandungi kandungan setempat untuk satu atau lebih juruterbang.

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

Perintah mengembalikan output seperti berikut apabila mengemas kini 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.

Ketahui tentang cara mengurus ralat daripada arahan merge-translation

Parameter Pilihan untuk copilot merge-translation

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

--file -f

Senarai fail yang mengandungi terjemahan. Corak glob disokong.

--solution -s

Nama penyelesaian.

--sourcedir -src

Direktori penyelesaian sumber. Apabila ditentukan, akan mengabaikan persekitaran yang disambungkan apabila mencari bot dan sebaliknya mencari kandungan dalam folder penyelesaian.

--verbose

Keluarkan lebih banyak maklumat diagnostik semasa import/eksport data

Parameter ini tidak memerlukan nilai. Ia adalah suis.

--whatif

Tidak melaksanakan arahan, tetapi mengeluarkan butiran tentang apa yang akan berlaku.

Parameter ini tidak memerlukan nilai. Ia adalah suis.

Ralat terjemahan penggabungan

Berdasarkan contoh di atas, jika satu ralat wujud dalam fail yang digunakan untuk mengemas kini copilot, outputnya kelihatan 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 menambah --verbose butiran tentang ralat:

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 dalam persekitaran semasa.

Contoh

Perintah ini menyenaraikan semua model AI Builder.

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

Perintah mengembalikan output seperti berikut:

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 Pilihan untuk copilot model list

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

pac copilot model predict

Menghantar teks atau gesaan kepada Model AI

Parameter Pilihan untuk copilot model predict

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

--model-id -id

Id model AI Builder

--model-name -n

Nama model AI penuh atau separa

--prompt -p

Gesaan untuk menghantar kepada Model AI

--text -t

Teks untuk dihantar ke Model AI

pac copilot model prepare-fetch

Mengambil fail FetchXML daripada Model Bahasa Besar AI (LLM) dan menyediakannya untuk pelaksanaan terhadap persekitaran semasa.

Parameter yang diperlukan untuk copilot model prepare-fetch

--inputFile -i

Input FetchXML fail yang biasanya datang daripada AI LLM.

--outputFile -o

Output FetchXML fail yang sedia untuk dilaksanakan terhadap persekitaran semasa.

Parameter Pilihan untuk copilot model prepare-fetch

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

pac copilot pack

Pakej ruang kerja ejen Copilot Studio ke dalam fail zip penyelesaian.

pac copilot pack membungkus ruang kerja ejen ke dalam penyelesaian .zip Dataverse yang boleh anda gunakan dengan pac solution import. Ia ialah bentuk kendiri langkah pembungkusan yang pac copilot init --environment berjalan untuk anda, jadi anda boleh menghasilkan penyelesaian yang boleh digunakan sebagai langkah berasingan — contohnya, dalam saluran paip binaan. Ia berfungsi untuk kedua-dua ruang kerja ejen klasik dan pengarang CLI (CliCopilot).

Contoh

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

Parameter yang diperlukan untuk copilot pack

--publisher-prefix -pp

Awalan penyesuaian Publisher untuk penyelesaian.

Parameter Pilihan untuk copilot pack

--output-path -op

Laluan output untuk fail zip penyelesaian. Lalai kepada direktori semasa.

--project-dir -pd

Direktori ruang kerja ejen untuk dibungkus. Lalai kepada direktori semasa.

--solution-name -sn

Nama unik penyelesaian. Jika ditinggalkan, diperoleh daripada nama skema ejen.

Kenyataan

• Ia adalah operasi tempatan. Pek membaca ruang kerja dan menulis penyelesaian .zip. Ia tidak memerlukan pengesahan dan tiada persekitaran, jadi ia selamat untuk dijalankan dalam saluran paip binaan.
• Awalan penerbit mestilah sah. --publisher-prefix mestilah awalan penyesuaian yang terbentuk dengan baik, atau berhenti pek sebelum menulis apa-apa.
• Nama dan output penyelesaian. Jika anda meninggalkan --solution-name, nama unik penyelesaian diperoleh daripada nama skema ejen. Ditulis .zip ke direktori semasa melainkan anda menetapkan --output-path.
• Pek tidak digunakan. Ia menghasilkan penyelesaian tetapi tidak mengimportnya. Ikuti dengan pac solution import untuk menggunakan ejen, kemudian pac copilot clone jika anda mahukan ruang kerja yang disambungkan segerak untuknya.

pac copilot publish

Terbitkan Copilot Tersuai

Parameter yang diperlukan untuk copilot publish

--bot -id

ID Copilot atau nama skema (nama unik yang terdapat dalam Butiran Bot atau nama fail dalam penjelajah penyelesaian).

Parameter Pilihan untuk copilot publish

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

pac copilot pull

Tarik perubahan jauh daripada Copilot Studio dan gabungkan dengan ruang kerja tempatan.

Perintah mengambil pac copilot pull keadaan pelayan semasa ejen dan menggabungkannya ke dalam ruang kerja tempatan anda dengan menggunakan gabungan tiga hala. Proses ini memastikan bahawa pengeditan bahagian pelayan dan fail tempatan anda yang tidak disentuh kedua-duanya kekal utuh. Jalankannya sebelum anda mula mengedit, dan jalankannya semula sebelum anda menolak perubahan anda.

Contoh

Jalankan arahan dari dalam folder ruang kerja:

pac copilot pull

Atau halakannya ke ruang kerja di tempat lain pada cakera:

pac copilot pull --project-dir contoso-support

Parameter Pilihan untuk copilot pull

--project-dir -pd

Laluan ke direktori projek. Lalai kepada direktori kerja semasa.

Kenyataan

• Jalankannya di dalam ruang kerja penyegerakan. Perintah ini pull hanya berfungsi dalam folder yang dicipta oleh pac copilot clone atau pac copilot init. Ia membaca persekitaran sasaran dan ejen daripada metadata penyegerakan ruang kerja, itulah sebabnya tiada --environment hujah. Jika anda menjalankannya di tempat lain, ia gagal dengan ralat "ruang kerja tidak dijumpai".
• Ia menulis ke fail tempatan anda. Pull menggabungkan perubahan jauh ke dalam ruang kerja dan memuat turun fail pengetahuan. Komited atau sandarkan kerja tempatan yang anda minati sebelum menarik.
• Log masuk terlebih dahulu dengan pac auth create.

pac copilot push

Tolak perubahan ruang kerja tempatan ke Copilot Studio.

pac copilot push menghantar perubahan dalam ruang kerja setempat anda kembali kepada ejen dalam Dataverse. Ia membandingkan fail anda dengan keadaan pelayan terakhir yang diketahui, memuat naik hanya perkara yang berubah - termasuk fail pengetahuan, aliran awan dan rujukan sambungan - dan melaporkan perkara yang ditolaknya.

Contoh

Jalankannya dari dalam folder ruang kerja:

pac copilot push

Atau halakannya ke ruang kerja di tempat lain pada cakera:

pac copilot push --project-dir contoso-support

Parameter Pilihan untuk copilot push

--project-dir -pd

Laluan ke direktori projek. Lalai kepada direktori kerja semasa.

Kenyataan

• Jalankannya di dalam ruang kerja penyegerakan. Seperti pull, push hanya berfungsi dalam folder yang dicipta oleh pac copilot clone atau pac copilot init. Ia membaca persekitaran sasaran daripada metadata penyegerakan ruang kerja. Tiada --environment hujah.
• Tarik dahulu jika terdapat konflik. Jika item yang sama berubah secara tempatan dan pada pelayan, tekan berhenti dan meminta anda menjalankan pac copilot pull sebelum mencuba lagi. Proses ini menghalang dorongan daripada menimpa perubahan bahagian pelayan secara senyap yang anda tidak lihat.
• Tiada perubahan tempatan adalah no-op. Jika push tidak menemui apa-apa untuk dihantar, ia melaporkannya dan keluar tanpa menyentuh persekitaran.
• Tolakan yang berjaya mengubah ejen langsung dalam persekitaran sasaran.
• Log masuk terlebih dahulu dengan pac auth create.

pac copilot quarantine

Status kuarantin ejen copilot.

Parameter yang diperlukan untuk copilot quarantine

--bot-id -id

ID juruterbang untuk kuarantin/nyahkuarantin.

Parameter Pilihan untuk copilot quarantine

--environment -env

Persekitaran (ID, ID org, url, nama unik atau nama separa).

--status -s

Nilai status kuarantin. benar = kuarantin, palsu = nyahkuarantin. Lalai kepada benar.

Parameter ini tidak memerlukan nilai. Ia adalah suis.

pac copilot status

Tinjauan status penggunaan copilot yang ditentukan dalam persekitaran Dataverse semasa atau sasaran.

Contoh

Perintah ini mengundi status penggunaan copilot tertentu dalam persekitaran Dataverse semasa atau sasaran.

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

Perintah mengembalikan output seperti berikut:

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 juruterbang (Chatbot).

Parameter Pilihan untuk copilot status

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

Pengesahan dan persekitaran untuk arahan penyegerakan

clonePerintah , pull, pushdan init --environment semuanya bercakap dengan persekitaran Dataverse, jadi mereka memerlukan profil pengesahan. Log masuk terlebih dahulu dengan pac auth create.

• clone, pull, dan push memerlukan profil aktif. pac copilot init hanya memerlukan satu apabila anda lulus --environment; tanpanya, init perancah fail secara tempatan dan tidak memerlukan log masuk.
• pull dan push baca persekitaran sasaran daripada metadata penyegerakan ruang kerja, supaya mereka tidak mengambil --environment hujah. clone dan init lakukan.
• pac copilot pack adalah tempatan semata-mata. Ia membaca dan menulis fail sahaja, jadi ia tidak memerlukan pengesahan dan tiada persekitaran.

pull dan push hanya bekerja di dalam ruang kerja yang dicipta oleh clone atau init. Metadata penyegerakan yang ditulis apabila ruang kerja dicipta ialah perkara yang memberitahu mereka ejen dan persekitaran yang hendak bercakap, jadi menjalankannya di tempat lain gagal dengan pantas dengan ralat "ruang kerja tidak dijumpai".

Lihat juga

Microsoft Power Platform Kumpulan Perintah CLI
Microsoft Power Platform Gambaran keseluruhan CLI