Bagikan melalui

pac copilot

Alat dan utilitas untuk manajemen salinan

Commands

Command Description
pac copilot create Membuat salinan baru menggunakan file templat yang sudah ada sebagai referensi.
pac copilot extract-template Mengekstrak file templat dari salinan yang ada di lingkungan.
pac copilot extract-translation Mengekstrak file yang berisi konten yang dilokalkan untuk satu atau beberapa bot.
pac copilot list Daftar salinan di lingkungan Dataverse saat ini atau target.
pac copilot mcp Informasi tentang server MCP (Protokol Konteks Model) lokal.
pac copilot merge-translation Gabungkan file yang berisi konten yang dilokalkan untuk satu atau beberapa bot.
pac copilot model list Model AI Builder di lingkungan saat ini.
pac copilot model predict Mengirim teks atau perintah 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.
pac copilot publish Menerbitkan Salinan Kustom
pac copilot status Polling status penyebaran salinan yang ditentukan di lingkungan Dataverse saat ini atau target.

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 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 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.

Komentar

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

AI Builder model Id

--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 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 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.

Lihat juga

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

  • Last updated on