pac copilot

Инструменти и помощни програми за управление на копилота.

Commands

Command Description
pac copilot create Създава ново копие, като използва съществуващ файл на шаблон като препратка.
pac copilot extract-template Извлича файл на шаблон от съществуващ copilot в среда.
pac copilot extract-translation Извлича файл, съдържащ локализирано съдържание за един или повече ботове.
pac copilot init-skills Извлечете файловете с дефиниции на умения на Copilot в текущата директория.
pac copilot list Списък на копилотите в текущата или целевата среда на Dataverse.
pac copilot mcp Информация за локалния MCP (Model Context Protocol) сървър.
pac copilot merge-translation Обединяване на файлове, съдържащи локализирано съдържание за един или повече ботове.
pac copilot model list Модели на AI Builder в текущата среда.
pac copilot model predict Изпраща текст или подкана към AI модел
pac copilot model prepare-fetch Взема fetchXML файла от AI Large Language Model (LLM) и го подготвя за изпълнение спрямо текущата среда.
pac copilot publish Публикуване на колона по избор
pac copilot quarantine Карантинен статус на агента на втория пилот.
pac copilot status Запитване на състоянието на разполагане на зададено copilot в текущата или целевата среда на Dataverse.

pac copilot create

Създава ново копие, като използва съществуващ файл на шаблон като препратка.

Задължителни параметри за copilot create

--displayName

Показваното име на новата копилот

--schemaName

Името на схемата (уникално име) на новия копилот.

--solution -s

Име на решението.

--templateFileName

Изходен yaml файл, съдържащ copilot шаблона, извлечен с командата extract-template.

Незадължителни параметри за copilot create

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

pac copilot extract-template

Извлича файл на шаблон от съществуващ copilot в среда.

Example

Тази команда извлича файл на шаблон от съществуващ копилот в среда.

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

Командата връща резултата като следния за copilot с използване на английски и немски езици:

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

--bot -id

ИД на Copilot или име на схема (уникално име, намерено в подробности за бота или име на файл в прозореца на решения).

--templateFileName

Местоположение на файла yaml за записване на шаблона за copilot.

Незадължителни параметри за copilot extract-template

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

--overwrite -o

Разреши презаписване на изходния файл с данни, ако той вече съществува.

Този параметър не изисква стойност. Това е превключвател.

--templateName

Име на шаблон или "kickStartTemplate", ако не е зададено име.

--templateVersion

Версия на шаблона във формат X.X.X или 1.0.0, ако не е зададена версия.

pac copilot extract-translation

Извлича файл, съдържащ локализирано съдържание за един или повече ботове.

Example

Тази команда извлича файл, съдържащ локализирано съдържание за един или повече копилоти.

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

Командата връща резултата като следния:

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

--all -a

Записване на файлове за локализация за всички поддържани езици. По подразбиране се записва само основният език.

Този параметър не изисква стойност. Това е превключвател.

--bot -id

ИД на Copilot или име на схема (уникално име, намерено в подробности за бота или име на файл в прозореца на решения).

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

--format

Файловият формат, в който се записват локализирани файлове – resx или json. Стойността по подразбиране е "resx".

--outdir

Изходната директория, в която да се записва.

--overwrite -o

Разреши презаписване на изходния файл с данни, ако той вече съществува.

Този параметър не изисква стойност. Това е превключвател.

--sourcedir -src

Директория на изходно решение. Когато е зададено, ще игнорира свързаната среда, когато търси ботове, а вместо това ще търси съдържание в папката на решението.

pac copilot init-skills

Извлечете файловете с дефиниции на умения на Copilot в текущата директория.

Незадължителни параметри за copilot init-skills

--output -o

Изходна папка за файлове с умения. Default: .github/skills

--skills -s

Разделен със запетаи списък с имена на умения (имена на съществителни от най-високо ниво), които да копирате, например администратор, удостоверяване. По подразбиране: всички умения.

pac copilot list

Списък на копилотите в текущата или целевата среда на Dataverse.

Example

Тази команда изброява всички копилотове в текущата или целевата среда dataverse.

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

Командата връща резултата като следния:

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

Незадължителни параметри за copilot list

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

pac copilot mcp

Информация за локалния MCP (Model Context Protocol) сървър.

Example

pac copilot mcp --run

Незадължителни параметри за copilot mcp

--run -r

Изпълнете локалния MCP (Model Context Protocol) сървър.

Този параметър не изисква стойност. Това е превключвател.

Remarks

Научете как да използвате CLI за Power Platform с вграден MCP сървър

pac copilot merge-translation

Обединяване на файлове, съдържащи локализирано съдържание за един или повече ботове.

Example

Тази команда обединява файлове, съдържащи локализирано съдържание за един или повече копилоти.

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

Командата връща резултата като следния при актуализиране на немски език:

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.

Научете как да управлявате грешки от командата за превод на обединяване

Незадължителни параметри за copilot merge-translation

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

--file -f

Списъкът с файлове, които съдържат преводи. Глоб моделите се поддържат.

--solution -s

Име на решението.

--sourcedir -src

Директория на изходно решение. Когато е зададено, ще игнорира свързаната среда, когато търси ботове, а вместо това ще търси съдържание в папката на решението.

--verbose

Извеждане на повече диагностична информация по време на импортиране/експортиране на данни

Този параметър не изисква стойност. Това е превключвател.

--whatif

Не изпълнява командата, но извежда подробностите за това, което ще се случи.

Този параметър не изисква стойност. Това е превключвател.

merge-translation errors

Въз основа на примера по-горе, ако съществува една грешка във файла, използван за актуализиране на copilot, резултатът изглежда така:

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.

Флагът --verbose добавя подробни данни за грешката:

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

Модели на AI Builder в текущата среда.

Example

Тази команда изброява всички модели на AI Builder.

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

Командата връща резултата като следния:

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 list

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

pac copilot model predict

Изпраща текст или подкана към AI модел

Незадължителни параметри за copilot model predict

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

--model-id -id

ИД на модел на AI Builder

--model-name -n

Пълно или частично име на AI модел

--prompt -p

Подкана за изпращане до AI модел

--text -t

Текст за изпращане към AI модел

pac copilot model prepare-fetch

Взема fetchXML файла от AI Large Language Model (LLM) и го подготвя за изпълнение спрямо текущата среда.

Задължителни параметри за copilot model prepare-fetch

--inputFile -i

Input FetchXML файл, който обикновено идва от AI LLM.

--outputFile -o

Изходен FetchXML файл, който е готов за изпълнение спрямо текущата среда.

Незадължителни параметри за copilot model prepare-fetch

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

pac copilot publish

Публикуване на колона по избор

Задължителни параметри за copilot publish

--bot -id

ИД на Copilot или име на схема (уникално име, намерено в подробности за бота или име на файл в прозореца на решения).

Незадължителни параметри за copilot publish

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

pac copilot quarantine

Карантинен статус на агента на втория пилот.

Задължителни параметри за copilot quarantine

--bot-id -id

ID-то на втория пилот за карантина/премахване на карантината.

Незадължителни параметри за copilot quarantine

--environment -env

Среда (ИД, ИД на организация, URL адрес, уникално име или частично име).

--status -s

Стойност на карантинния статус. true = карантина, false = unquarantine. По подразбиране е true.

Този параметър не изисква стойност. Това е превключвател.

pac copilot status

Запитване на състоянието на разполагане на зададено copilot в текущата или целевата среда на Dataverse.

Example

Тази команда посочва състоянието на разполагане на зададено copilot в текущата или целевата среда на Dataverse.

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

Командата връща резултата като следния:

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 status

--bot-id -id

ИД на копилот (Chatbot).

Незадължителни параметри за copilot status

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

See also

Microsoft Power Platform CLI командни групи
Microsoft Power Platform CLI общ преглед