pac copilot

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

Команди

Command	Описание
pac copilot clone	Клонирайте агент на Copilot Studio в локална директория на работна област.
pac copilot create	Създава ново копие, като използва съществуващ файл на шаблон като препратка.
pac copilot delete	Изтриване на Copilot по избор.
pac copilot extract-template	Извлича файл на шаблон от съществуващ copilot в среда.
pac copilot extract-translation	Извлича файл, съдържащ локализирано съдържание за един или повече ботове.
pac copilot init	Създайте нова работна област на агент на Copilot Studio от шаблон.
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 pack	Пакетиране на работна област на агент на Copilot Studio в zip файл на решение.
pac copilot publish	Публикуване на колона по избор
pac copilot pull	Извличайте отдалечени промени от Copilot Studio и обединявайте с локалната работна област.
pac copilot push	Натиснете промените в локалната работна област, за да Copilot Studio.
pac copilot quarantine	Карантинен статус на агента на втория пилот.
pac copilot status	Запитване на състоянието на разполагане на зададено copilot в текущата или целевата среда на Dataverse.

pac copilot clone

Клонирайте агент на Copilot Studio в локална директория на работна област.

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

`--bot` `-id`

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

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

`--component-collection` `-cc`

ИД на колекция от компоненти за клониране. Повторете за няколко.

`--display-name` `-dn`

Показвано име на агента (използва се за именуване на папки).

`--environment` `-env`

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

`--output-dir` `-od`

Главна папка за изход от клонирано копие. По подразбиране е текущата директория.

pac copilot create

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

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

`--displayName`

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

`--schemaName`

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

`--solution` `-s`

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

`--templateFileName`

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

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

`--environment` `-env`

pac copilot delete

Изтриване на Copilot по избор.

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

`--bot` `-id`

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

`--confirm` `-y`

Задължително, за да потвърдите изтриването на copilot.

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

`--environment` `-env`

pac copilot extract-template

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

Пример

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

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`

`--templateFileName`

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

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

`--environment` `-env`

`--overwrite` `-o`

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

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

`--templateName`

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

`--templateVersion`

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

pac copilot extract-translation

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

Пример

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

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`

`--environment` `-env`

`--format`

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

`--outdir`

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

`--overwrite` `-o`

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

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

`--sourcedir` `-src`

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

pac copilot init

Създайте нова работна област на агент на Copilot Studio от шаблон.

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

`--name` `-n`

Показвано име на агента.

`--publisher-prefix` `-pp`

Publisher префикс за персонализиране за решението.

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

`--environment` `-env`

`--instructions` `-ins`

Инструкции за системата на агента.

`--project-dir` `-pd`

Целева директория за работната област на агента. По подразбиране е текущата директория.

`--schema-name` `-sn`

Пълно име на схемата на агента. Замества извличането по подразбиране ({publisher-prefix}_{sanitized-name}). Използва се as-is без промяна.

`--template` `-t`

Име на профил на шаблон (по подразбиране, минимално). По подразбиране е "по подразбиране".

pac copilot init-skills

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

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

`--output` `-o`

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

`--skills` `-s`

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

pac copilot list

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

Пример

Тази команда изброява всички копилотове в текущата или целевата среда 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`

pac copilot mcp

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

Пример

pac copilot mcp --run

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

`--run` `-r`

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

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

Забележки

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

pac copilot merge-translation

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

Пример

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

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`

`--file` `-f`

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

`--solution` `-s`

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

`--sourcedir` `-src`

`--verbose`

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

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

`--whatif`

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

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

грешки при обединяване и превод

Въз основа на примера по-горе, ако съществува една грешка във файла, използван за актуализиране на 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 в текущата среда.

Пример

Тази команда изброява всички модели на 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`

pac copilot model predict

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

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

`--environment` `-env`

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

pac copilot pack

Пакетиране на работна област на агент на Copilot Studio в zip файл на решение.

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

`--publisher-prefix` `-pp`

Publisher префикс за персонализиране за решението.

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

`--output-path` `-op`

Изходен път за zip файла на решението. По подразбиране е текущата директория.

`--project-dir` `-pd`

Директория на работна област на агент за пакетиране. По подразбиране е текущата директория.

`--solution-name` `-sn`

Уникално име на решение. Ако е пропуснато, извлечено от името на схемата на агента.

pac copilot publish

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

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

`--bot` `-id`

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

`--environment` `-env`

pac copilot pull

Извличайте отдалечени промени от Copilot Studio и обединявайте с локалната работна област.

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

`--project-dir` `-pd`

Път до директорията на проекта. По подразбиране е текущата работна директория.

pac copilot push

Натиснете промените в локалната работна област, за да Copilot Studio.

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

`--project-dir` `-pd`

Път до директорията на проекта. По подразбиране е текущата работна директория.

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.

Пример

Тази команда посочва състоянието на разполагане на зададено 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`

Вж. също

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

Обратна връзка

Тази страница полезна ли беше?

Last updated on 2026-06-03

pac copilot

Команди

pac copilot clone

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

--bot -id

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

--component-collection -cc

--display-name -dn

--environment -env

--output-dir -od

pac copilot create

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

--displayName

--schemaName

--solution -s

--templateFileName

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

--environment -env

pac copilot delete

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

--bot -id

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

--confirm -y

--environment -env

pac copilot extract-template

Пример

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

--bot -id

--templateFileName

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

--environment -env

--overwrite -o

--templateName

--templateVersion

pac copilot extract-translation

Пример

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

--all -a

--bot -id

--environment -env

--format

--outdir

--overwrite -o

--sourcedir -src

pac copilot init

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

--name -n

--publisher-prefix -pp

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

--environment -env

--instructions -ins

--project-dir -pd

--schema-name -sn

--template -t

pac copilot init-skills

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

--output -o

--skills -s

pac copilot list

Пример

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

--environment -env

pac copilot mcp

Пример

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

--run -r

Забележки

pac copilot merge-translation

Пример

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

--environment -env

--file -f

--solution -s

--sourcedir -src

--verbose

--whatif

грешки при обединяване и превод

pac copilot model list

Пример

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

`--bot` `-id`

`--component-collection` `-cc`

`--display-name` `-dn`

`--environment` `-env`

`--output-dir` `-od`

`--displayName`

`--schemaName`

`--solution` `-s`

`--templateFileName`

`--environment` `-env`

`--bot` `-id`

`--confirm` `-y`

`--environment` `-env`

`--bot` `-id`

`--templateFileName`

`--environment` `-env`

`--overwrite` `-o`

`--templateName`

`--templateVersion`

`--all` `-a`

`--bot` `-id`

`--environment` `-env`

`--format`

`--outdir`

`--overwrite` `-o`

`--sourcedir` `-src`

`--name` `-n`

`--publisher-prefix` `-pp`

`--environment` `-env`

`--instructions` `-ins`

`--project-dir` `-pd`

`--schema-name` `-sn`

`--template` `-t`

`--output` `-o`

`--skills` `-s`

`--environment` `-env`

`--run` `-r`

`--environment` `-env`

`--file` `-f`

`--solution` `-s`

`--sourcedir` `-src`

`--verbose`

`--whatif`

`--environment` `-env`

`--environment` `-env`

`--model-id` `-id`

`--model-name` `-n`

`--prompt` `-p`

`--text` `-t`

`--inputFile` `-i`

`--outputFile` `-o`

`--environment` `-env`

`--publisher-prefix` `-pp`

`--output-path` `-op`

`--project-dir` `-pd`

`--solution-name` `-sn`

`--bot` `-id`

`--environment` `-env`

`--project-dir` `-pd`

`--project-dir` `-pd`

`--bot-id` `-id`

`--environment` `-env`

`--status` `-s`

`--bot-id` `-id`

`--environment` `-env`