pac copilot

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

init, clone, , pull, pushve pack komutları, bir Copilot Studio aracısını diskte bir dosya kümesi olarak tutmanıza, yerel olarak düzenlemenize ve dataverse ortamıyla eşitlemenize olanak tanır.

Tipik bir döngü şöyle görünür:

1. Bir çalışma alanı başlatın. ile yepyeni bir aracı iskelesi yapın veya ile pac copilot initpac copilot clonevar olan bir aracıyı indirin. Her iki şekilde de diğer komutların bağımlı olduğu eşitleme meta verilerini taşıyan yerel bir çalışma alanı alırsınız.
2. Düzenlemeden önce çekin. pac copilot pull uzak değişiklikleri getirir ve yerel dosyalarınızla birleştirir, böylece geçerli sunucu durumundan başlarsınız.
3. İşiniz bittiğinde itin. pac copilot push yerel değişikliklerinizi geri gönderir. Bu sırada sunucuda aynı öğe değiştiyse, anında iletme durdurulur ve önce çekmenizi ister.
4. Dağıtım paketi. pac copilot packçalışma alanını ile pac solution importdağıtabileceğiniz bir çözüme .zip dönüştürür.

Tek adımda hiçbir şeyden canlı bir temsilciye geçmek için, pac copilot init --environment çalışma alanını sizin için iskeleler, paketler, içeri aktarır ve bağlar. Tek tek komutlar, döngünün her bir parçasını kendi başına kullanmanıza olanak sağlar.

Commands

pac copilot clone

bir Copilot Studio aracısını yerel çalışma alanı dizinine kopyalayın.

pac copilot clonemevcut bir Copilot Studio aracısını yerel bir çalışma alanı dizinine indirir ve pac copilot push bu pac copilot pull aracıyı kullanan eşitleme meta verileriyle birlikte indirir. Aracının dosyaları, görünen adından sonra adlı bir alt klasöre yazılır.

Example

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

Için Gerekli Parametreler copilot clone

--bot -id

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

için İsteğe Bağlı Parametreler copilot clone

--component-collection -cc

Kopyalanan bileşen koleksiyonu kimliği. Birden çok kez yineleyin.

--display-name -dn

Aracının görünen adı (klasör adlandırma için kullanılır).

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

--output-dir -od

Kopya çıktısı için kök klasör. Varsayılan olarak geçerli dizine geçer.

Remarks

• --botCopilot kimliğini veya şema adını kabul eder. Copilot kimliğini (GUID) veya aracının şema adını geçirin. komutu, hedef ortama göre bir şema adını çözümler.
• Hedef alt klasör boş olmalıdır. Clone, altında --output-diraracının (temizlenmiş) görünen adından sonra adlı bir klasöre yazar. Bu klasör zaten dosya içeriyorsa, kopya bunların üzerine yazmak yerine durur. Farklı bir klasör adı seçmek için kullanın --display-name .
• Bileşen koleksiyonlarını kopyalama. Bileşen koleksiyonlarını aracıyla birlikte aşağı getirmek için, ile noktalı virgülle --component-collectionayrılmış bir veya daha fazla koleksiyon kimlikleri geçirin.
• Kopya kimliği doğrulanmış bir profil (pac auth create) gerektirir ve ortamı atladığınızda ortamından veya etkin profilin kuruluşundan çözümler --environment.

pac copilot create

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

Için Gerekli Parametreler copilot create

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

için İsteğe Bağlı Parametreler copilot create

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

Özel Copilot silin.

Için Gerekli Parametreler copilot delete

--bot -id

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

için İsteğe Bağlı Parametreler copilot delete

--confirm -y

Yardımcı pilotun silinmesini onaylamak için gereklidir.

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

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

Için Gerekli Parametreler copilot extract-template

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

için İsteğe Bağlı Parametreler copilot extract-template

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

için İsteğe Bağlı Parametreler copilot extract-translation

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

Şablondan yeni bir Copilot Studio aracısı çalışma alanı oluşturun.

pac copilot initbir şablondan yeni bir Copilot Studio aracısı çalışma alanı oluşturur. İki moddan birinde çalışır ve hangi modun kullanılacağına --environment karar verir:

• Yerel iskele — hayır --environment. Şablon dosyalarını proje dizinine yazar ve durdurur. Komutu Dataverse'de herhangi bir şey oluşturmaz ve oturum açmayı gerektirmez. Yerel olarak yazmak ve daha sonra bir ortama bağlanmak istediğinizde bu modu kullanın.
• Bootstrap — --environment sağlanır. Dosyaları iskeleler, bir çözüme paketler, bu çözümü ortama aktarır ve çalışma alanını yeni oluşturulan aracıya bağlar. Bu mod, hiçbir şeyden canlı, eşitlemeye hazır bir aracıya giden tek adımlı yoldur ve kimliği doğrulanmış bir profil gerektirir.

Examples

Çalışma alanını yerel olarak iskeleye ekleyin:

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

Bir ortamdaki canlı bir aracıyı tek adımda iskeleleyin ve önyükleyin:

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

CLI tarafından yazılmış (CliCopilot) aracıyı belirli bir klasöre iskeleyle oluşturun:

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

Için Gerekli Parametreler copilot init

--name -n

Aracı görünen adı.

--publisher-prefix -pp

Çözüm için özelleştirme ön ekini Publisher.

için İsteğe Bağlı Parametreler copilot init

--authoring-mode -am

Yapı iskelesine aracı yazma şekli (varsayılan: 'klasik'). CLI tarafından yazılan cliCopilot aracısını iskelek için 'cli-copilot' kullanın.

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

--instructions -ins

Aracı sistemi yönergeleri.

--project-dir -pd

Aracı çalışma alanı için hedef dizin. Varsayılan olarak geçerli dizine geçer.

--schema-name -sn

Tam aracı şema adı. Varsayılan türetme ({publisher-prefix}_{sanitized-name}) geçersiz kılar. Değişiklik yapılmadan as-is kullanılır.

--template -t

Şablon profili adı (varsayılan, en az). Varsayılan olarak 'default' değeri gösterilir.

Remarks

• Proje dizini boş olmalıdır. init mevcut dosyaların üzerine iskele oluşturmaz, bu nedenle yeni veya boş bir klasöre işaret edin --project-dir .
• Şema adı türetme. atladığınızda --schema-namearacı şema adı olarak {publisher-prefix}_{sanitized-name}oluşturulur. Açıkça ayarlamak için geçirin --schema-name ; değeri as-iskullanılır.
• Bootstrap her iki yazma modu için de çalışır. init --environment varsayılan klasik mod ve --authoring-mode cli-copilotiçin bir adımda canlı bir aracıyı önyükleme. CliCopilot aracısına alternatif olarak, yerel olarak yapı iskelesi oluşturabilir (hayır --environment), ardından komutunu çalıştırarak pac copilot packpac solution import kendiniz dağıtabilirsiniz.
• Bootstrap, sunucu tarafı nesneleri oluşturur. Bootstrap modunda, init bir çözümü içeri aktarır ve aracıyı hedef ortamda oluşturur. Aynı şema adına sahip bir aracı zaten varsa, init durdurulur ve bunun yerine var olan aracıya bağlanmanız için pac copilot clone sizi işaret eder.
• Yepyeni bir ortam, ilk içeri aktarmayı kabul etmek için yavaş olabilir. Yeni oluşturulmuş bir ortamın ısınması bir veya iki dakika sürebilir. Erken önyükleme "Bu kuruluş için zaman uyumsuz işlemler şu anda devre dışı" hatasıyla başarısız olabilir. Biraz bekleyin ve tekrar çalıştırın.
• --template (default veya minimal) yalnızca klasik yazma modu için geçerlidir.

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

için İsteğe Bağlı Parametreler copilot list

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

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

--run -r

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

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

Remarks

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

için İsteğe Bağlı Parametreler copilot merge-translation

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

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

için İsteğe Bağlı Parametreler copilot model list

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

Yapay zeka modeline metin veya istem gönderir

için İsteğe Bağlı Parametreler copilot model predict

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

Için Gerekli Parametreler copilot model prepare-fetch

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

için İsteğe Bağlı Parametreler copilot model prepare-fetch

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

Copilot Studio aracısı çalışma alanını çözüm zip dosyasına paketleyin.

pac copilot packaracı çalışma alanını ile pac solution importdağıtabileceğiniz bir Dataverse çözümüne .zip paketler. Bu, sizin için çalışan paketleme adımının pac copilot init --environment tek başına biçimidir, böylece dağıtılabilir çözümü ayrı bir adım olarak (örneğin bir derleme işlem hattında) oluşturabilirsiniz. Hem klasik hem de CLI tarafından yazılan (CliCopilot) aracı çalışma alanlarında çalışır.

Example

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

Için Gerekli Parametreler copilot pack

--publisher-prefix -pp

Çözüm için özelleştirme ön ekini Publisher.

için İsteğe Bağlı Parametreler copilot pack

--output-path -op

Çözüm zip dosyasının çıkış yolu. Varsayılan olarak geçerli dizine geçer.

--project-dir -pd

Pakete aracı çalışma alanı dizini. Varsayılan olarak geçerli dizine geçer.

--solution-name -sn

Çözüm benzersiz adı. Atlanırsa, aracı şema adından türetilir.

Remarks

• Bu yerel bir işlem. Pack çalışma alanını okur ve bir çözüm .zipyazar. Kimlik doğrulaması ve ortam gerektirmediğinden, derleme işlem hattında çalıştırmak güvenlidir.
• Yayımcı ön eki geçerli olmalıdır. --publisher-prefix iyi biçimlendirilmiş bir özelleştirme ön eki olmalıdır veya herhangi bir şey yazmadan önce paket durakları olmalıdır.
• Çözüm adı ve çıkışı. atlarsanız --solution-name, çözümün benzersiz adı aracı şema adından türetilir. .zip, ayarlamadığınız --output-pathsürece geçerli dizine yazılır.
• Paket dağıtılmıyor. Çözümü üretir ancak içeri aktarmaz. Aracıyı dağıtmak için aracıyı ile pac solution import birlikte izleyin, ardından pac copilot clone bunun için eşitlemeye bağlı bir çalışma alanı istiyorsanız.

pac copilot publish

Özel Copilot Yayımlama

Için Gerekli Parametreler copilot publish

--bot -id

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

için İsteğe Bağlı Parametreler copilot publish

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

Copilot Studio uzak değişiklikleri çekin ve yerel çalışma alanıyla birleştirin.

komutu aracının pac copilot pull geçerli sunucu durumunu getirir ve üç yönlü birleştirme kullanarak yerel çalışma alanınızla birleştirir. Bu işlem, sunucu tarafı düzenlemelerinin ve el değmemiş yerel dosyalarınızın aynı kalmasını sağlar. Düzenlemeye başlamadan önce çalıştırın ve değişikliklerinizi göndermeden önce yeniden çalıştırın.

Example

Komutunu çalışma alanı klasörünün içinden çalıştırın:

pac copilot pull

Veya diskin başka bir yerindeki bir çalışma alanına işaret edin:

pac copilot pull --project-dir contoso-support

için İsteğe Bağlı Parametreler copilot pull

--project-dir -pd

Proje dizininin yolu. Varsayılan olarak geçerli çalışma dizinine ayarlanır.

Remarks

• Eşitleme çalışma alanında çalıştırın. Komut pull yalnızca veya pac copilot inittarafından pac copilot clone oluşturulan bir klasörde çalışır. Çalışma alanının eşitleme meta verilerinden hedef ortamı ve aracıyı okur ve bu nedenle bağımsız değişken yoktur --environment . Başka bir yerde çalıştırırsanız, "çalışma alanı bulunamadı" hatasıyla başarısız olur.
• Yerel dosyalarınıza yazar. Çekme, uzak değişiklikleri çalışma alanıyla birleştirir ve bilgi dosyalarını indirir. Çekmeden önce ilgilendiğiniz yerel işleri işleyin veya yedekleyin.
• ile pac auth createilk olarak oturum açın.

pac copilot push

Yerel çalışma alanı değişikliklerini Copilot Studio gönderme.

pac copilot push yerel çalışma alanınızdaki değişiklikleri Dataverse'deki aracıya geri gönderir. Dosyalarınızı bilinen son sunucu durumuyla karşılaştırır, yalnızca bilgi dosyaları, bulut akışları ve bağlantı başvuruları dahil olmak üzere değişenleri karşıya yükler ve nelerin gönderildiğini raporlar.

Example

Çalışma alanı klasörünün içinden çalıştırın:

pac copilot push

Veya diskin başka bir yerindeki bir çalışma alanına işaret edin:

pac copilot push --project-dir contoso-support

için İsteğe Bağlı Parametreler copilot push

--project-dir -pd

Proje dizininin yolu. Varsayılan olarak geçerli çalışma dizinine ayarlanır.

Remarks

• Eşitleme çalışma alanında çalıştırın. gibipull, push yalnızca veya pac copilot inittarafından pac copilot clone oluşturulan bir klasörde çalışır. Çalışma alanının eşitleme meta verilerinden hedef ortamı okur. Tartışma yok --environment .
• Çakışma olursa önce çekin. Aynı öğe hem yerel olarak hem de sunucuda değiştiyse, anında iletme durdurulur ve yeniden denemeden önce çalıştırmanızı pac copilot pull ister. Bu işlem, görmediğiniz bir sunucu tarafı değişikliğinin sessizce üzerine yazılmasını engeller.
• Hiçbir yerel değişiklik no-opdeğildir. Gönderme gönderecek bir şey bulmazsa, bunu bildirir ve ortama dokunmadan çıkar.
• Başarılı bir gönderim, hedef ortamdaki canlı aracıyı sessize alır .
• ile pac auth createilk olarak oturum açın.

pac copilot quarantine

Yardımcı pilot ajanın karantina durumu.

Için Gerekli Parametreler copilot quarantine

--bot-id -id

Karantina/karantinadan çıkarma yardımcı pilotunun kimliği.

için İsteğe Bağlı Parametreler copilot quarantine

--environment -env

Ortam (kimlik, kuruluş kimliği, url, benzersiz ad veya kısmi ad).

--status -s

Karantina durumu değeri. doğru = karantina, yanlış = karantinadan çıkar. Varsayılan değer true'dır.

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

pac copilot status

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.

Için Gerekli Parametreler copilot status

--bot-id -id

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

için İsteğe Bağlı Parametreler copilot status

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

Eşitleme komutları için kimlik doğrulaması ve ortam

clone, pull, pushve init --environment komutlarının tümü dataverse ortamıyla iletişim kurar, bu nedenle bir kimlik doğrulama profiline ihtiyaç duyarlar. ile pac auth createilk olarak oturum açın.

• clone, pullve push etkin bir profil gerektirir. pac copilot init yalnızca geçirdiğinizde --environmentbir tane gerekir; bu olmadan, init dosyaları yerel olarak iskeleler ve oturum açma gerekmez.
• pull ve push çalışma alanının eşitleme meta verilerinden hedef ortamı okuyarak bağımsız --environment değişken almamasını sağlayın. clone ve init yapın.
• pac copilot pack tamamen yereldir. Yalnızca dosyaları okur ve yazar, bu nedenle kimlik doğrulaması ve ortam gerektirmez.

pullve push yalnızca veya inittarafından clone oluşturulan bir çalışma alanında çalışır. Çalışma alanı oluşturulduğunda yazılan eşitleme meta verileri, onlara hangi aracı ve ortamla konuşulacaklarını bildirir, bu nedenle başka bir yerde çalıştırmak "çalışma alanı bulunamadı" hatasıyla hızlı bir şekilde başarısız olur.

Ayrıca bakınız

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