pac copilot

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

Команды init, и pullclonepushpack команды позволяют хранить агент Copilot Studio в виде набора файлов на диске, изменять его локально и синхронизировать с средой Dataverse.

Типичный цикл выглядит следующим образом:

1. Запустите рабочую область. Создание шаблонов для нового агента с pac copilot initпомощью или скачивание существующего агента с pac copilot cloneпомощью . В любом случае вы получите локальную рабочую область, которая содержит метаданные синхронизации, от других команд зависят.
2. Вытягивание перед изменением. pac copilot pull приводит удаленные изменения и объединяет их в локальные файлы, поэтому вы начинаете работу с текущего состояния сервера.
3. Нажать, когда вы закончите. pac copilot push отправляет локальные изменения обратно. Если один и тот же элемент изменился на сервере в то же время, отправьте остановку и попросит вас сначала извлечь.
4. Пакет для развертывания. pac copilot pack преобразует рабочую область в решение .zip , с помощью pac solution importкоторое можно развернуть.

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

Commands

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

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

--component-collection -cc

Идентификатор коллекции компонентов для клонирования. Повторите для нескольких.

--display-name -dn

Отображаемое имя агента (используется для именования папок).

--environment -env

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

--output-dir -od

Корневая папка для клонирования выходных данных. По умолчанию используется текущий каталог.

Remarks

• --botпринимает имя Copilot идентификатора или схемы. Передайте идентификатор Copilot (GUID) или имя схемы агента. Команда разрешает имя схемы в целевой среде.
• Вложенная папка назначения должна быть пустой. Клон записывается в папку с именем в соответствии с отображаемым именем --output-dirагента (sanitized). Если эта папка уже содержит файлы, клон останавливается, а не перезаписывает их. Используется --display-name для выбора другого имени папки.
• Клонирование коллекций компонентов. Чтобы привести коллекции компонентов вниз вместе с агентом, передайте один или несколько идентификаторов коллекций с --component-collectionразделителями с запятой.
• Для клонирования требуется профиль с проверкой подлинности (pac auth create) и разрешает среду из --environmentорганизации активного профиля или из нее.

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 delete

Удаление пользовательского Copilot.

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

--bot -id

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

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

--confirm -y

Требуется подтвердить удаление copilot.

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

--environment -env

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

pac copilot extract-template

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

Пример

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

Извлекает файл, содержащий локализованное содержимое для одного или нескольких ботов.

Пример

Эта команда извлекает файл, содержащий локализованное содержимое для одного или нескольких копилот.

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

Создайте новую рабочую область агента 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

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

--environment -env

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

--instructions -ins

Инструкции по системе агента.

--project-dir -pd

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

--schema-name -sn

Полное имя схемы агента. Переопределяет производность по умолчанию ({publisher-prefix}_{sanitized-name}). Используется as-is без изменений.

--template -t

Имя профиля шаблона (по умолчанию, минимальное). По умолчанию используется значение default.

Remarks

• Каталог проекта должен быть пустым. 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 .
• Bootstrap создает серверные объекты. В режиме init начальной загрузки импортирует решение и создает агент в целевой среде. Если агент с тем же именем схемы уже существует, init останавливается и указывает на pac copilot clone подключение к существующему агенту.
• Новая среда может быть медленной, чтобы принять первый импорт. Недавно созданная среда может занять минуту или две, чтобы прогреться. Ранняя начальная загрузка может завершиться сбоем с "Асинхронные операции в настоящее время отключены для этой организации". Подождите минуту и снова запустите его.
• --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 или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

pac copilot mcp

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

Пример

pac copilot mcp --run

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

--run -r

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

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

Remarks

Узнайте, как использовать интерфейс командной строки 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 или абсолютным 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 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 или абсолютным 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 pack

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

pac copilot pack упаковывать рабочую область агента в решение .zip Dataverse, с помощью которое можно развернуть pac solution import. Это автономная форма шага упаковки, которая pac copilot init --environment выполняется для вас, поэтому вы можете создать развертываемое решение как отдельный шаг, например, в конвейере сборки. Он работает как для классических, так и для рабочих областей агента 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

Уникальное имя решения. Если опущен, производный от имени схемы агента.

Remarks

• Это локальная операция. Пакет считывает рабочую область и записывает решение .zip. Для нее не требуется проверка подлинности и нет среды, поэтому она безопасна для запуска в конвейере сборки.
• Префикс издателя должен быть допустимым. --publisher-prefix должен быть хорошо сформированный префикс настройки или пакет останавливается, прежде чем писать что-либо.
• Имя и выходные данные решения. Если не указано --solution-name, уникальное имя решения является производным от имени схемы агента. Записывается .zip в текущий каталог, если не задано.--output-path
• Пакет не развертывается. Он создает решение, но не импортирует его. Следуйте инструкциям, pac solution import чтобы развернуть агент, а затем pac copilot clone , если для него требуется рабочая область, подключенная к синхронизации.

pac copilot publish

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

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

--bot -id

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

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

--environment -env

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

pac copilot pull

Извлечение удаленных изменений из Copilot Studio и слияние с локальной рабочей областью.

Команда pac copilot pull получает текущее состояние сервера агента и объединяет его в локальную рабочую область с помощью трехстороннего слияния. Этот процесс гарантирует, что изменения на стороне сервера и нетронутые локальные файлы остаются неизменными. Запустите его перед началом редактирования и снова запустите его перед отправкой изменений.

Пример

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

pac copilot pull

Или наведите указатель на рабочую область в другом месте на диске:

pac copilot pull --project-dir contoso-support

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

--project-dir -pd

Путь к каталогу проекта. По умолчанию используется текущий рабочий каталог.

Remarks

• Запустите его в рабочей области синхронизации. Команда pull работает только в папке, созданной pac copilot clone или pac copilot init. Он считывает целевую среду и агент из метаданных синхронизации рабочей области, поэтому аргумент не --environment существует. Если вы запускаете его в любом месте, он завершается ошибкой "рабочая область не найдена".
• Он записывает данные в локальные файлы. Извлекает удаленные изменения в рабочую область и загружает файлы знаний. Зафиксируйте или создайте резервную копию локальной работы перед извлечением.
• Сначала войдите в систему с 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

Путь к каталогу проекта. По умолчанию используется текущий рабочий каталог.

Remarks

• Запустите его в рабочей области синхронизации. Например pull, работает только в папке, push созданной pac copilot clone или pac copilot init. Он считывает целевую среду из метаданных синхронизации рабочей области. --environment Нет аргумента.
• Сначала потяните, если есть конфликт. Если один и тот же элемент изменился как локально, так и на сервере, принудительно останавливается и запрашивает выполнение 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

Опрос состояния развертывания указанного copilot в текущей или целевой среде 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 (Chatbot).

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

--environment -env

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

Проверка подлинности и среда для команд синхронизации

Команды clonepullpush, и 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