Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Средства и служебные программы для управления 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