pac copilot

Інструменти та утиліти для управління копілотом.

Команди init, clone, pull, pushі pack команди дають змогу зберігати Copilot Studio агента як набір файлів на диску, редагувати їх локально та синхронізувати з середовищем Dataverse.

Типовий цикл має такий вигляд:

  1. Запустіть робочу область. Риштування нового агента з pac copilot init, або завантажити наявний з pac copilot clone. У будь-якому випадку ви отримаєте локальну робочу область, яка містить метадані синхронізації, від яких залежать інші команди.
  2. Потягніть перед редагуванням. pac copilot pull видаляє віддалені зміни та об'єднує їх у локальні файли, тому ви починаєте з поточного стану сервера.
  3. Натисніть, коли все буде готово. pac copilot push надішле локальні зміни назад. Якщо той самий елемент змінився на сервері в той же час, push-зупинки та попросити вас спочатку витягнути.
  4. Пакет для розгортання. pac copilot pack перетворює робочу область на рішення .zip , які можна розгорнути за допомогою pac solution import.

Щоб перейти від нічого до динамічного агента за один крок, pac copilot init --environment риштування, пакети, імпорт і підключення робочої області для вас. Окремі команди дають змогу самостійно керувати кожною частиною циклу.

Команди

Команда Опис
pac copilot clone Клонування агента Copilot Studio до локального каталогу робочої області.
pac copilot create Створює новий copilot, використовуючи наявний файл шаблону як посилання.
pac copilot delete Видалення настроюваного Copilot.
pac copilot extract-template Видобуває файл шаблону з наявного копілоту в середовищі.
pac copilot extract-translation Видобуває файл із локалізованим вмістом для одного або кількох ботів.
pac copilot init Створіть нову робочу область агента Copilot Studio на основі шаблону.
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 pack Упакуйте робочу область Copilot Studio агента в zip-файл рішення.
pac copilot publish Опублікувати настроюваний Copilot
pac copilot pull Витягніть віддалені зміни з Copilot Studio та об'єднайте їх із локальною робочою областю.
pac copilot push Застосування змін до локальної робочої області до Copilot Studio.
pac copilot quarantine Карантинний статус агента другого пілота.
pac copilot status Опитуйте стан розгортання вказаного копілоту в поточному або цільовому середовищі Dataverse.

pac copilot clone

Клонування агента Copilot Studio до локального каталогу робочої області.

pac copilot cloneзавантажує наявного агента Copilot Studio до локального каталогу робочої області разом із метаданими синхронізації, на які pac copilot pull вони pac copilot push залежать. Файли агента записуються у вкладену папку з іменем короткого імені.

Приклад

pac copilot clone `
   --bot 11111111-1111-1111-1111-111111111111 `
   --environment 22222222-2222-2222-2222-222222222222 `
   --output-dir contoso-support

Обов'язкові параметри для copilot clone

--bot на -id

Ідентифікатор або ім'я схеми Copilot (унікальне ім'я, знайдене в розділі "Відомості про бота" або ім'я файлу в провіднику рішень).

Необов'язкові параметри для copilot clone

--component-collection на -cc

Ідентифікатор колекції компонентів для клонування. Повторіть ці дії для кількох.

--display-name на -dn

Коротке ім'я агента (використовується для іменування папок).

--environment на -env

Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

--output-dir на -od

Коренева папка для виведення клонів. За замовчуванням для поточного каталогу.

Примітки

  • --botприймає ідентифікатор Copilot або ім'я схеми. Передайте ідентифікатор Copilot (GUID) або ім'я схеми агента. Команда усуває ім'я схеми в цільовому середовищі.
  • Кінцева вкладена папка має бути пустою. Clone записує в папку, названу на честь (дезінфікованого) короткого імені агента в розділі --output-dir. Якщо ця папка вже містить файли, клон зупиняється, а не перезаписує їх. Використовується --display-name для вибору іншого імені папки.
  • Колекції компонентів клонування. Щоб перенести колекції компонентів разом із агентом, передайте один або кілька ідентифікаторів колекції, розділяючи їх крапкою з --component-collectionкомою.
  • Clone потребує автентифікованого профілю (pac auth create) і усуває середовище з --environmentорганізації активного профілю, коли ви не пропускаєте його.

pac copilot create

Створює новий copilot, використовуючи наявний файл шаблону як посилання.

Обов'язкові параметри для copilot create

--displayName

Коротке ім'я нового копілота

--schemaName

Ім'я схеми (унікальне ім'я) нового copilot.

--solution на -s

Ім'я рішення.

--templateFileName

Вихідний yaml-файл, що містить шаблон copilot, який був витягнутий за допомогою команди extract-template.

Необов'язкові параметри для copilot create

--environment на -env

Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

pac copilot delete

Видалення настроюваного Copilot.

Обов'язкові параметри для copilot delete

--bot на -id

Ідентифікатор або ім'я схеми Copilot (унікальне ім'я, знайдене в розділі "Відомості про бота" або ім'я файлу в провіднику рішень).

Необов'язкові параметри для copilot delete

--confirm на -y

Необхідно підтвердити видалення копілота.

Для цього параметра не потрібне значення. Це перемикач.

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

Створіть нову робочу область агента Copilot Studio на основі шаблону.

pac copilot initстворює нову робочу область агента Copilot Studio із шаблону. Він працює в одному з двох режимів, і наявність --environment вирішує, який режим слід використовувати:

  • Локальне риштування – ні --environment. Записує файли шаблонів до каталогу проектів і зупиняється. Команда не створює нічого в Dataverse і не вимагає входу. Використовуйте цей режим, коли пізніше потрібно створити локальний режим і підключитися до середовища.
  • Завантажувач — --environment постачається. Ришує файли, упаковує їх у рішення, імпортує це рішення до середовища та підключає робочу область до новоствореного агента. Цей режим – це однокроковий шлях від нічого до динамічного агента, готового до синхронізації, і для нього потрібен автентифікований профіль.

Приклади

Локально риштування робочої області:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso

Риштування та завантаження динамічного агента в середовищі на одному кроці:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --environment 22222222-2222-2222-2222-222222222222

Убудуйте агент CLI(CliCopilot) у певну папку:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --authoring-mode cli-copilot `
   --project-dir contoso-support

Обов'язкові параметри для copilot init

--name на -n

Коротке ім'я агента.

--publisher-prefix на -pp

Publisher префікс настроювання рішення.

Необов'язкові параметри для copilot init

--authoring-mode на -am

Форма створення агента для риштування (за замовчуванням: "classic"). Використовуйте "cli-copilot", щоб ридати агента CliCopilot, створеного CliCopilot.

--environment на -env

Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

--instructions на -ins

Інструкції з роботи з системою агента.

--project-dir на -pd

Цільовий каталог для робочої області агента. За замовчуванням для поточного каталогу.

--schema-name на -sn

Повне ім'я схеми агента. Перевизначає похідну за промовчанням ({publisher-prefix}_{sanitized-name}). Використовується as-is без змінення.

--template на -t

Ім'я профілю шаблону (стандартне, мінімальне). За замовчуванням використовується значення "за замовчуванням".

Примітки

  • Каталог проекту має бути пустим. init не стисне дані над наявними файлами, тому наведіть вказівник --project-dir миші на нову або пусту папку.
  • Похідне ім'я схеми. Якщо пропустити --schema-name, ім'я схеми агента буде побудовано як {publisher-prefix}_{sanitized-name}. Передати --schema-name , щоб установити його явно; значення використовується as-is.
  • Завантажувач працює в обох режимах створення. init --environment завантажує динамічного агента на одному кроці для класичного режиму за замовчуванням і для --authoring-mode cli-copilot. Як альтернативу агенту CliCopilot ви можете риштування локально (ні --environment), а потім запустити pac copilot pack після цього pac solution import , щоб розгорнути його самостійно.
  • Завантажувач створює об'єкти на сервері. У режимі init завантаження імпортує рішення та створює агента в цільовому середовищі. Якщо агент з таким іменем схеми вже існує, init зупиняється та вказує на pac copilot clone підключення до наявного агента.
  • Нове середовище може бути повільним, щоб прийняти перший імпорт. Для розігріву щойно створеного середовища може знадобитися хвилина-дві. Рання завантажувач може не вдатися, якщо для цієї організації вимкнуто операції Async. Зачекайте та запустіть його знову.
  • --template (default або minimal) застосовується лише до класичного режиму створення.

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 pack

Упакуйте робочу область Copilot Studio агента в zip-файл рішення.

pac copilot pack пакування робочої області агента в рішення .zip Dataverse, яке можна розгорнути за допомогою pac solution import. Це автономна форма етапу пакування, яка pac copilot init --environment запускається для вас, тому ви можете створити розгорнуте рішення як окремий крок, наприклад, у конвеєрі збірки. Він працює як для класичних, так і для робочих областей агентів, створених CLI (CliCopilot).

Приклад

pac copilot pack `
   --publisher-prefix contoso `
   --project-dir contoso-support `
   --output-path out

Обов'язкові параметри для copilot pack

--publisher-prefix на -pp

Publisher префікс настроювання рішення.

Необов'язкові параметри для copilot pack

--output-path на -op

Шлях виводу zip-файлу рішення. За замовчуванням для поточного каталогу.

--project-dir на -pd

Каталог робочої області агента, який потрібно упакувати. За замовчуванням для поточного каталогу.

--solution-name на -sn

Унікальне ім'я рішення. Якщо не вказано, походить від імені схеми агента.

Примітки

  • Це локальна операція. Пакет читає робочу область і записує рішення .zip. Вона не потребує автентифікації та не має середовища, тому безпечно працювати в конвеєрі збірки.
  • Префікс видавця має бути припустимим. --publisher-prefix має бути належним чином відформатованим префіксом настроювання або припиненням пакування перед написанням будь-яких даних.
  • Ім'я та вивід рішення. Якщо пропустити --solution-name, унікальне ім'я рішення походить від імені схеми агента. Запис .zip записується до поточного каталогу, якщо не встановлено .--output-path
  • Пакет не розгортається. Він створює рішення, але не імпортує його. Дотримуйтеся його pac solution import , щоб розгорнути агент, а потім pac copilot clone , якщо вам потрібна робоча область, підключена до синхронізації.

pac copilot publish

Опублікувати настроюваний Copilot

Обов'язкові параметри для copilot publish

--bot на -id

Ідентифікатор або ім'я схеми Copilot (унікальне ім'я, знайдене в розділі "Відомості про бота" або ім'я файлу в провіднику рішень).

Необов'язкові параметри для copilot publish

--environment на -env

Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

pac copilot pull

Витягніть віддалені зміни з Copilot Studio та об'єднайте їх із локальною робочою областю.

Команда отримує поточний pac copilot pull стан сервера агента та об'єднує його в локальну робочу область за допомогою тристороннього злиття. Цей процес гарантує, що зміни на сервері та ваші недоторкані локальні файли залишаться без змін. Запустіть його, перш ніж почати редагування, і запустіть його знову, перш ніж ви проштовхнете зміни.

Приклад

Виконайте команду з папки робочої області:

pac copilot pull

Або наведіть її на робочу область в іншому місці на диску:

pac copilot pull --project-dir contoso-support

Необов'язкові параметри для copilot pull

--project-dir на -pd

Шлях до каталогу проектів. За замовчуванням для поточного робочого каталогу.

Примітки

  • Запустіть її в робочій області синхронізації. Команда pull працює лише в папці, створеній або pac copilot initpac copilot clone . Вона читає цільове середовище та агента з метаданих синхронізації робочої області, тому немає --environment аргументів. Якщо запустити її в іншому місці, помилка "робоча область не знайдено".
  • Вона записує до локальних файлів. Функція Pull об'єднує віддалені зміни в робочій області та завантажує файли знань. Зробіть або скомітіть локальну роботу, про яку ви дбаєте, перш ніж тягнути.
  • Спочатку ввійдіть за допомогою pac auth create.

pac copilot push

Застосування змін до локальної робочої області до Copilot Studio.

pac copilot push надсилає зміни в локальній робочій області агенту в Dataverse. Він порівнює ваші файли з останнім відомим станом сервера, передає лише те, що змінилося, зокрема файли знань, потоки хмари та посилання на підключення, і повідомляє про те, що воно наштовхнуло.

Приклад

Запустіть його з папки робочої області:

pac copilot push

Або наведіть її на робочу область в іншому місці на диску:

pac copilot push --project-dir contoso-support

Необов'язкові параметри для copilot push

--project-dir на -pd

Шлях до каталогу проектів. За замовчуванням для поточного робочого каталогу.

Примітки

  • Запустіть її в робочій області синхронізації. Like pull, push працює лише в папці, створеній pac copilot clone або pac copilot init. Вона читає цільове середовище з метаданих синхронізації робочої області. Немає аргументів --environment .
  • Потягніть спочатку, якщо виник конфлікт. Якщо один і той самий елемент змінився як локально, так і на сервері, push-зупинки та запит на запуск pac copilot pull перед повторним спробою. Цей процес дає змогу відштовхнутися від автоматичного перезаписування змін на сервері, які ви не бачили.
  • Жодні локальні зміни не є no-op. Якщо push не знаходить нічого для надсилання, він повідомляє, що і виходить, не торкаючись середовища.
  • Успішний поштовх мутує живого агента в цільовому середовищі.
  • Спочатку ввійдіть за допомогою pac auth create.

pac copilot quarantine

Карантинний статус агента другого пілота.

Обов'язкові параметри для copilot quarantine

--bot-id на -id

ID другого пілота для карантину/зняття карантину.

Необов'язкові параметри для copilot quarantine

--environment на -env

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

--status на -s

Значення статусу карантину. true = карантин, false = знятий карантин. За замовчуванням true.

Для цього параметра не потрібне значення. Це перемикач.

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. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

Автентифікація та середовище для команд синхронізації

Усі cloneкоманди , pull, pushі init --environment команди розмовляють із середовищем Dataverse, тому їм потрібен профіль автентифікації. Спочатку ввійдіть за допомогою pac auth create.

  • clone, pullі push потрібен активний профіль. pac copilot init Тільки один потрібен, коли ви проходите --environment; без нього init файли риштування локально і не потребують входу.
  • pull і push прочитайте цільове середовище з метаданих синхронізації робочої області, щоб не брати --environment аргумент. clone і init зробіть це.
  • pac copilot pack є суто локальним. Він читає та записує лише файли, тому йому не потрібна автентифікація та відсутнє середовище.

pull і push працюють лише в робочій області, створеній clone або init. Метадані синхронізації, написані під час створення робочої області, вказують, з яким агентом і середовищем потрібно поговорити, тому запустити їх у будь-якому іншому місці не вдається швидко з помилкою "робоча область не знайдено".

Додаткові відомості

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

  • Last updated on