Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Средства и служебные программы для управления copilot
Commands
| Command | Description |
|---|---|
| pac copilot create | Создает новый copilot с помощью существующего файла шаблона в качестве ссылки. |
| pac copilot extract-template | Извлекает файл шаблона из существующего copilot в среде. |
| pac copilot extract-translation | Извлекает файл, содержащий локализованное содержимое для одного или нескольких ботов. |
| список pac copilot | Список копилотов в текущей или целевой среде Dataverse. |
| pac copilot mcp | Сведения о локальном сервере MCP (протокол контекста модели). |
| pac copilot merge-translation | Слияние файлов, содержащих локализованное содержимое для одного или нескольких ботов. |
| Список моделей pac copilot | Модели AI Builder в текущей среде. |
| Прогноз модели pac copilot | Отправляет текст или запрос в модель ИИ |
| pac copilot model prepare-fetch | Принимает файл FetchXML из модели большого языка ИИ (LLM) и подготавливает его к выполнению в текущей среде. |
| публикация pac copilot | Публикация пользовательского copilot |
| состояние pac copilot | Опрос состояния развертывания указанного copilot в текущей или целевой среде Dataverse. |
pac copilot create
Создает новый copilot с помощью существующего файла шаблона в качестве ссылки.
Обязательные параметры для создания copilot
--displayName
Отображаемое имя нового copilot
--schemaName
Имя схемы (уникальное имя) нового copilot.
--solution
-s
Имя решения.
--templateFileName
Исходный файл yaml, содержащий шаблон copilot, извлеченный с помощью команды extract-template.
Необязательные параметры для создания copilot
--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
--bot
-id
Идентификатор Copilot или имя схемы (уникальное имя, найденное в bot Details или имя файла в обозревателе решений).
--templateFileName
Расположение yaml-файла для записи шаблона copilot в.
Необязательные параметры для извлечения-шаблона copilot
--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
--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
Список копилотов в текущей или целевой среде 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
--environment
-env
Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.
pac copilot mcp
Сведения о локальном сервере MCP (протокол контекста модели).
Example
pac copilot mcp --run
Необязательные параметры для copilot mcp
--run
-r
Запустите локальный сервер MCP (протокол контекста модели).
Этот параметр не требует значения. Это переключатель.
Замечания
Узнайте, как использовать интерфейс командной строки 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
--environment
-env
Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.
--file
-f
Список файлов, содержащих переводы. Поддерживаются шаблоны glob.
--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
Модели 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
--environment
-env
Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.
Прогноз модели pac copilot
Отправляет текст или запрос в модель ИИ
Необязательные параметры для прогноза модели copilot
--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) и подготавливает его к выполнению в текущей среде.
Обязательные параметры для модели подготовки копилота
--inputFile
-i
Входной файл FetchXML, который обычно поставляется из ИИ LLM.
--outputFile
-o
Выходной файл FetchXML, готовый к выполнению в текущей среде.
Необязательные параметры для модели подготовки копилота
--environment
-env
Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.
публикация pac copilot
Публикация пользовательского copilot
Обязательные параметры для публикации copilot
--bot
-id
Идентификатор Copilot или имя схемы (уникальное имя, найденное в bot Details или имя файла в обозревателе решений).
Необязательные параметры для публикации copilot
--environment
-env
Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.
состояние pac copilot
Опрос состояния развертывания указанного 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
--bot-id
-id
Идентификатор copilot (Chatbot).
Необязательные параметры для состояния copilot
--environment
-env
Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.
См. также
Группы команд Командной строки Microsoft Power Platform
Обзор интерфейса командной строки Microsoft Power Platform