pac copilot

Средства и служебные программы для управления copilot.

Commands

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

pac copilot create

Создает новый copilot с помощью существующего файла шаблона в качестве ссылки.

Обязательные параметры для copilot create

--displayName

Отображаемое имя нового copilot

--schemaName

Имя схемы (уникальное имя) нового copilot.

--solution -s

Имя решения.

--templateFileName

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

Необязательные параметры для copilot create

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

pac copilot extract-template

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

Example

Эта команда извлекает файл шаблона из существующего 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

Идентификатор Copilot или имя схемы (уникальное имя, найденное в bot Details или имя файла в обозревателе решений).

--templateFileName

Расположение yaml-файла для записи шаблона copilot в.

Необязательные параметры для copilot extract-template

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--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 или имя схемы (уникальное имя, найденное в bot Details или имя файла в обозревателе решений).

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--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. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

pac copilot mcp

Сведения о локальном сервере MCP (протокол контекста модели).

Example

pac copilot mcp --run

Необязательные параметры для copilot mcp

--run -r

Запустите локальный сервер MCP (протокол контекста модели).

Этот параметр не требует значения. Это переключатель.

Remarks

Узнайте, как использовать интерфейс командной строки 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. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--file -f

Список файлов, содержащих переводы. Поддерживаются шаблоны glob.

--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. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

pac copilot model predict

Отправляет текст или запрос в модель ИИ

Необязательные параметры для copilot model predict

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--model-id -id

Идентификатор модели AI Builder

--model-name -n

Полное или частичное имя модели ИИ

--prompt -p

Запрос на отправку в модель ИИ

--text -t

Текст для отправки в модель ИИ

pac copilot model prepare-fetch

Принимает файл FetchXML из модели большого языка ИИ (LLM) и подготавливает его к выполнению в текущей среде.

Обязательные параметры для copilot model prepare-fetch

--inputFile -i

Входной файл FetchXML, который обычно поставляется из ИИ LLM.

--outputFile -o

Выходной файл FetchXML, готовый к выполнению в текущей среде.

Необязательные параметры для copilot model prepare-fetch

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

pac copilot publish

Публикация пользовательского copilot

Обязательные параметры для copilot publish

--bot -id

Идентификатор Copilot или имя схемы (уникальное имя, найденное в bot Details или имя файла в обозревателе решений).

Необязательные параметры для copilot publish

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

pac copilot quarantine

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

Обязательные параметры для copilot quarantine

--bot-id -id

ID второго пилота для карантина/снятия карантина.

Необязательные параметры для copilot quarantine

--environment -env

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

--status -s

Значение карантинного статуса. true = карантин, false = снятие карантина. По умолчанию используется значение 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

Идентификатор copilot (Chatbot).

Необязательные параметры для copilot status

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

See also

Microsoft Power Platform группы команд CLI
Обзор Microsoft Power Platform CLI