Бележка
Достъпът до тази страница изисква удостоверяване. Можете да опитате да влезете или да промените директориите.
Достъпът до тази страница изисква удостоверяване. Можете да опитате да промените директориите.
Инструменти и помощни програми за управление на копилота.
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 общ преглед