pac copilot

Yardımcı pilot yönetimi için araçlar ve yardımcı programlar

Commands

Command	Description
pac copilot create	Başvuru olarak mevcut bir şablon dosyasını kullanarak yeni bir yardımcı pilot oluşturur.
pac copilot extract-template	Bir ortamdaki mevcut bir yardımcı pilottan şablon dosyası ayıklar.
pac copilot extract-translation	Bir veya daha fazla bot için yerelleştirilmiş içerik içeren dosyayı ayıklar.
pac copilot list	Geçerli veya hedef Dataverse ortamındaki yardımcı pilotların listesi.
pac copilot mcp	Yerel MCP (Model Bağlam Protokolü) sunucusu hakkında bilgi.
pac copilot merge-translation	Bir veya daha fazla bot için yerelleştirilmiş içerik içeren dosyaları birleştirin.
pac copilot model listesi	Geçerli ortamdaki AI Builder modelleri.
pac copilot model tahmini	Yapay zeka modeline metin veya istem gönderir
pac copilot modeli prepare-fetch	AI Büyük Dil Modeli'nden (LLM) FetchXML dosyasını alır ve geçerli ortamda yürütülmeye hazırlar.
pac copilot publish	Özel Copilot Yayımlama
pac copilot durumu	Geçerli veya hedef Dataverse ortamında belirtilen bir yardımcı pilotun dağıtım durumunu yoklayın.

pac copilot create

Başvuru olarak mevcut bir şablon dosyasını kullanarak yeni bir yardımcı pilot oluşturur.

Yardımcı pilot oluşturma için gerekli Parametreler

--displayName

Yeni yardımcı pilotun görünen adı

--schemaName

Yeni yardımcı pilotun şema adı (benzersiz adı).

--solution -s

Çözümün adı.

--templateFileName

extract-template komutu kullanılarak ayıklanan copilot şablonunu içeren kaynak yaml dosyası.

Copilot oluşturma için isteğe bağlı Parametreler

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

pac copilot extract-template

Bir ortamdaki mevcut bir yardımcı pilottan şablon dosyası ayıklar.

Example

Bu komut, bir ortamdaki mevcut bir yardımcı pilottan bir şablon dosyası ayıklar.

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

komutu, İngilizce ve Almanca dillerini kullanan bir yardımcı pilot için aşağıdakine benzer bir çıkış döndürür:

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 için gerekli parametreler

--bot -id

Copilot kimliği veya şema adı (Bot Ayrıntıları'nda bulunan benzersiz ad veya çözüm gezginindeki dosya adı).

--templateFileName

Yardımcı şablon yazacak yaml dosyasının konumu.

Copilot extract-template için isteğe bağlı parametreler

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--overwrite -o

Çıktı veri dosyasının zaten varsa üzerine yazılmasını sağlayın.

Bu parametre için değer gerekmez. Bu bir anahtar.

--templateName

Ad belirtilmezse şablon adı veya 'kickStartTemplate'.

--templateVersion

X.X.X biçiminde şablon sürümü veya sürüm belirtilmezse 1.0.0.

pac copilot extract-translation

Bir veya daha fazla bot için yerelleştirilmiş içerik içeren dosyayı ayıklar.

Example

Bu komut, bir veya daha fazla yardımcı pilot için yerelleştirilmiş içerik içeren bir dosyayı ayıklar.

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

komutu aşağıdaki gibi bir çıkış döndürür:

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 için isteğe bağlı parametreler

--all -a

Desteklenen tüm diller için yerelleştirme dosyaları yazın. Varsayılan olarak, yalnızca birincil dil yazılır.

Bu parametre için değer gerekmez. Bu bir anahtar.

--bot -id

Copilot kimliği veya şema adı (Bot Ayrıntıları'nda bulunan benzersiz ad veya çözüm gezginindeki dosya adı).

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--format

'resx' veya 'json' olmak üzere yerelleştirilmiş dosyaların yazıldığı dosya biçimi. Varsayılan değer 'resx'tir.

--outdir

Yazacak çıkış dizini.

--overwrite -o

Çıktı veri dosyasının zaten varsa üzerine yazılmasını sağlayın.

Bu parametre için değer gerekmez. Bu bir anahtar.

--sourcedir -src

Kaynak çözüm dizini. Belirtildiğinde, bot ararken bağlı ortamı yoksayar ve bunun yerine çözüm klasöründe içerik arar.

pac copilot list

Geçerli veya hedef Dataverse ortamındaki yardımcı pilotların listesi.

Example

Bu komut geçerli veya hedef Dataverse ortamındaki tüm yardımcı pilotları listeler.

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

komutu aşağıdaki gibi bir çıkış döndürür:

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

Yardımcı pilot listesi için isteğe bağlı parametreler

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

pac copilot mcp

Yerel MCP (Model Bağlam Protokolü) sunucusu hakkında bilgi.

Example

pac copilot mcp --run

Copilot mcp için İsteğe Bağlı Parametreler

--run -r

Yerel MCP (Model Bağlam Protokolü) sunucusunu çalıştırın.

Bu parametre için değer gerekmez. Bu bir anahtar.

Açıklamalar

Power Platform CLI'yi yerleşik MCP sunucusuyla kullanmayı öğrenin

pac copilot merge-translation

Bir veya daha fazla bot için yerelleştirilmiş içerik içeren dosyaları birleştirin.

Example

Bu komut, bir veya daha fazla yardımcı pilot için yerelleştirilmiş içerik içeren dosyaları birleştirir.

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

Komut, Almanca dilini güncelleştirirken aşağıdaki gibi bir çıkış döndürür:

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.

Birleştirme çevirisi komutundan hataları yönetme hakkında bilgi edinin

Copilot birleştirme çevirisi için isteğe bağlı Parametreler

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--file -f

Çeviri içeren dosyaların listesi. Glob desenleri desteklenir.

--solution -s

Çözümün adı.

--sourcedir -src

Kaynak çözüm dizini. Belirtildiğinde, bot ararken bağlı ortamı yoksayar ve bunun yerine çözüm klasöründe içerik arar.

--verbose

Veri içeri/dışarı aktarma sırasında daha fazla tanılama bilgisi çıktısı alın

Bu parametre için değer gerekmez. Bu bir anahtar.

--whatif

Komutu yürütmez, ancak ne olacağının ayrıntılarını gösterir.

Bu parametre için değer gerekmez. Bu bir anahtar.

birleştirme çevirisi hataları

Yukarıdaki örneğe bağlı olarak, copilot'ı güncelleştirmek için kullanılan dosyada bir hata varsa çıkış şöyle görünür:

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.

bayrağı hatayla --verbose ilgili ayrıntıları ekler:

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 listesi

Geçerli ortamdaki AI Builder modelleri.

Example

Bu komut tüm AI Builder modellerini listeler.

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

komutu aşağıdaki gibi bir çıkış döndürür:

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 listesi için isteğe bağlı parametreler

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

pac copilot model tahmini

Yapay zeka modeline metin veya istem gönderir

Copilot model tahmini için isteğe bağlı parametreler

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--model-id -id

AI Builder model kimliği

--model-name -n

Tam veya kısmi AI Modeli adı

--prompt -p

Yapay zeka modeline gönderme istemi

--text -t

Yapay Zeka Modeline gönderilecek metin

pac copilot modeli prepare-fetch

AI Büyük Dil Modeli'nden (LLM) FetchXML dosyasını alır ve geçerli ortamda yürütülmeye hazırlar.

Copilot model prepare-fetch için gerekli Parametreler

--inputFile -i

Genellikle AI LLM'den gelen Input FetchXML dosyası.

--outputFile -o

Geçerli ortamda yürütülmeye hazır olan Output FetchXML dosyası.

Copilot modeli hazırlama-getirme için isteğe bağlı Parametreler

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

pac copilot publish

Özel Copilot Yayımlama

Copilot yayımlama için gerekli parametreler

--bot -id

Copilot kimliği veya şema adı (Bot Ayrıntıları'nda bulunan benzersiz ad veya çözüm gezginindeki dosya adı).

Copilot yayımlama için isteğe bağlı parametreler

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

pac copilot durumu

Geçerli veya hedef Dataverse ortamında belirtilen bir yardımcı pilotun dağıtım durumunu yoklayın.

Example

Bu komut, geçerli veya hedef Dataverse ortamında belirtilen bir yardımcı pilotun dağıtım durumunu yoklar.

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

komutu aşağıdaki gibi bir çıkış döndürür:

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 durumu için gerekli Parametreler

--bot-id -id

Bir yardımcı pilotun kimliği (Chatbot).

Copilot durumu için isteğe bağlı parametreler

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

Ayrıca bakınız

Microsoft Power Platform CLI Komut Grupları
Microsoft Power Platform CLI'ya genel bakış