Нотатка
Доступ до цієї сторінки потребує авторизації. Можна спробувати ввійти або змінити каталоги.
Доступ до цієї сторінки потребує авторизації. Можна спробувати змінити каталоги.
Інструменти та утиліти для управління copilot
Команди
| Команда | Опис |
|---|---|
| pac copilot create | Створює новий copilot, використовуючи наявний файл шаблону як посилання. |
| pac copilot extract-template | Видобуває файл шаблону з наявного копілоту в середовищі. |
| pac copilot extract-translation | Видобуває файл із локалізованим вмістом для одного або кількох ботів. |
| 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 (LLM) і готує його до виконання з поточним середовищем. |
| pac copilot publish | Опублікувати настроюваний Copilot |
| pac copilot status | Опитуйте стан розгортання вказаного копілоту в поточному або цільовому середовищі Dataverse. |
pac copilot create
Створює новий copilot, використовуючи наявний файл шаблону як посилання.
Обов'язкові параметри для copilot create
--displayName
Коротке ім'я нового копілота
--schemaName
Ім'я схеми (унікальне ім'я) нового copilot.
--solution
-s
Ім'я рішення.
--templateFileName
Source yaml file containing the copilot template that was extracted using the extract-template command.
Необов'язкові параметри для copilot create
--environment
-env
Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.
pac copilot extract-template
Видобуває файл шаблону з наявного копілоту в середовищі.
Приклад
Ця команда видобуває файл шаблону з наявного copilot в середовищі.
pac copilot extract-template `
--environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
--bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
--templateFileName NewTestCopilot.yaml
Команда повертає результат, наприклад, для копілоту з використанням англійської та німецької мов:
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. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.
--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
Ідентифікатор або ім'я схеми Copilot (унікальне ім'я, знайдене в розділі "Відомості про бота" або ім'я файлу в провіднику рішень).
--environment
-env
Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.
--format
Формат файлу, у якому потрібно писати локалізовані файли ( "resx" або "json". Стандартне значення – "resx".
--outdir
Каталог виводу для записування.
--overwrite
-o
Дозволити перезаписування файлу вихідних даних, якщо він уже існує.
Для цього параметра не потрібне значення. Це перемикач.
--sourcedir
-src
Каталог вихідних рішень. Якщо вказано, під час пошуку ботів підключене середовище ігноруватиметься, а натомість шукатиме вміст у папці рішення.
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
Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.
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
Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним 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 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
Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.
pac copilot model predict
Надсилання тексту або запиту до моделі AI
Необов'язкові параметри для copilot model predict
--environment
-env
Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.
--model-id
-id
Ідентифікатор моделі побудовника AI
--model-name
-n
Повне або часткове ім'я моделі AI
--prompt
-p
Запит на надсилання до моделі AI
--text
-t
Текст для надсилання до моделі AI
pac copilot model prepare-fetch
Бере файл FetchXML із моделі великої мови AI (LLM) і готує його до виконання з поточним середовищем.
Обов'язкові параметри для copilot model prepare-fetch
--inputFile
-i
Вхідний файл FetchXML, який зазвичай походить із AI LLM.
--outputFile
-o
Файл FetchXML, готовий до виконання з поточним середовищем.
Необов'язкові параметри для copilot model prepare-fetch
--environment
-env
Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.
pac copilot publish
Опублікувати настроюваний Copilot
Обов'язкові параметри для copilot publish
--bot
-id
Ідентифікатор або ім'я схеми Copilot (унікальне ім'я, знайдене в розділі "Відомості про бота" або ім'я файлу в провіднику рішень).
Необов'язкові параметри для copilot publish
--environment
-env
Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.
pac copilot status
Опитуйте стан розгортання вказаного копілоту в поточному або цільовому середовищі 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
Ідентифікатор копілота (Чатбот).
Необов'язкові параметри для copilot status
--environment
-env
Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.
Див. також
Групи команд CLI платформи Microsoft Power Platform
Огляд CLI платформи Microsoft Power Platform