Экспорт и импорт помощников с использованием решений
Важно
Возможности и функции Power Virtual Agents теперь являются частью Microsoft Copilot Studio после значительных инвестиций в генеративный искусственный интеллект и расширенную интеграцию с Microsoft Copilot.
Некоторые статьи и снимки экрана могут ссылаться на Power Virtual Agents, пока мы обновляем документацию и учебные материалы.
Вы можете экспортировать и импортировать помощники, используя решения, так что вы можете перемещать своих помощников между несколькими средами.
Это может быть полезно, если вы используете разные среды для разных целей или применяете методологии развертывания кольца. Например, у вас может быть определенная среда, в которой вы внутренне тестируете и проверяете помощников, другую среду, в которой вы тестируете помощников только для подгруппы пользователей, и конечную производственную среду, в которой вы делитесь помощниками с клиентами и конечными пользователями.
Заметка
Вы не можете экспортировать комментарии на уровне темы или на уровне узла при экспорте помощника.
Предварительные условия
- Для использования этой функции разработчику потребуются минимальные роли безопасности настройщика системы. См. дополнительные сведения о настройке безопасности пользователей в среде.
Важно
Эта статья содержит документацию по предварительной версии Microsoft Copilot Studio и может быть изменена.
Предварительные версии функций не предназначены для использования в производственной среде, а их функциональность может быть ограничена. Они доступны перед официальным выпуском, чтобы вы могли досрочно получить доступ и предоставить отзывы.
Если вы создаете готового к рабочей среде помощника, см. раздел Обзор Microsoft Copilot Studio.
Перемещайте своих помощников между средами, экспортируя и импортируя их с помощью решений. Экспортирование и импортирование помощников может быть полезно, если вы используете разные среды для разных целей или если применяете методологии развертывания кольца. Например, у вас может быть одна среда, в которой вы внутренне тестируете и проверяете помощников, другая среда, в которой вы тестируете помощников только для подгруппы пользователей, и конечная производственная среда, в которой вы делитесь помощниками с клиентами и конечными пользователями.
Полезная информация
Вы не можете экспортировать комментарии на уровне темы или на уровне узла при экспорте помощника.
Удаление помощника из решения не удаляет его компоненты из решения. Вы должны удалить компоненты отдельно.
Предупреждение
Не удаляйте неуправляемые компоненты помощников (например, темы помощника) непосредственно с портала Power Apps, если только вы не удалили сам помощник из решения.
Вы должны вносить изменения в темы только из Microsoft Copilot Studio. Удаление или изменение компонентов помощника из Power Apps приведет к сбою экспорта и импорта.
Экспортировать управляемые решения невозможно. Когда вы создаете решение, оно по умолчанию будет неуправляемым. Если вы измените его на управляемое решение, вы не сможете его экспортировать. Вам нужно будет создать новое решение.
Если у вашего помощника большое количество компонентов (например, более 250 тем или более 100 сущностей), экспортируйте его, используя классический портал Power Apps вместо этого.
Заметка
Вам потребуются минимальные роли безопасности настройщика системы для экспорта и импорта помощников с помощью решений. См. дополнительные сведения о настройке безопасности пользователей для ресурсов в среде.
Создание решения для управления экспортом и импортом
Вы используете решения для экспорта помощников из одной среды и их импорта в другую. Решение действует как «носитель» для помощников. Вы можете экспортировать и импортировать несколько ботов в одном решении.
В Microsoft Copilot Studio откройте бот, который хотите экспортировать.
Заметка
Если вы используете Классический чат-бот, в меню навигации выберите Чат-боты, чтобы открыть страницу Чат-боты и просмотреть всех ботов, к которым у вас есть доступ в этой среде.
В меню навигации в разделе «Настройки» выберите Сведения о помощнике, затем выберите Экспорт.
Заметка
Если вы используете Классический бот, выберите бот, которого хотите экспортировать, затем выберите Экспорт чат-бота.
Альтернативно вы можете открыть страницу Помощники, выбрать помощник, который хотите экспортировать, затем выбрать Экспорт помощника.
Выберите Перейти к решениям Power Apps.
В Power Apps на вкладке Решения выберите Создать решение.
Введите указанные ниже сведения для нового решения:
Поле Описание: Показать имя Имя, отображаемое в списке решений. Его можно будет изменить впоследствии. Полное имя Уникальное имя решения, созданное из отображаемого имени. Его можно отредактировать до сохранения решения, однако после сохранения решения его изменить нельзя. Издатель Выберите издателя по умолчанию или создайте нового. Мы рекомендуем вам создать издателя, которого вы можете использовать последовательно во всех средах, где вы будете использовать это решение. Подробнее об издателях решений. Версия Введите номер версии своего решения. Номер версии включается в имя файла при экспорте решения. Выберите Создать.
Добавление помощника в решение
Созданное вами решение должно быть открыто. Если это не так, выберите его в списке решений.
Выберите Добавить существующий, и затем выберите Чат-бот.
В списке Добавить существующие чат-боты выберите помощник или помощников, которых хотите экспортировать, затем выберите Добавить.
Заметка
Следующее относится к Классическим чат-ботам.
Если вы используете навыки, удалите переменные среды навыка Текущее значение выбрав Удалить из этого решения.
Заметка
Удаление помощника из решения не удаляет его компоненты из решения. Удаление компонентов должно быть сделано отдельно.
Предупреждение
Не удаляйте неуправляемые подкомпоненты помощников (например, темы помощника) непосредственно с портала Power Apps, если только вы не удалили сам помощник из решения.
Вы должны вносить изменения в темы только на портале Microsoft Copilot Studio.
Удаление или изменение подкомпонентов помощника из Power Apps приведет к сбою экспорта и импорта.
Экспорт решения с помощником
Вы экспортируете и импортируете помощников, экспортируя и импортируя содержащие их решения из одной среды в другую.
Важно
Если у вашего помощника большое количество компонентов (например, более 250 тем или более 100 сущностей), см. раздел Экспорт с помощью классического интерфейса.
На странице Power Apps Решения выберите решение, содержащее ваш помощник, затем выберите Экспортировать решение.
В области Перед экспортом выберите Далее.
Введите или выберите следующие параметры:
Вариант Описание: Номер версии Microsoft Copilot Studio автоматически увеличивает версию вашего решения. Вы можете принять значение по умолчанию или ввести свое собственное. Экспортировать как Выберите тип пакета, Управляемый или Неуправляемый. Дополнительные сведения об управляемых и неуправляемых решениях. Выберите Экспорт.
Экспорт может занять несколько минут. Просмотрите сообщение о состоянии в верхней части страницы Решения. Когда экспорт завершится, ваш браузер загрузит ZIP-файл. Имя файла имеет формат SolutionName_Version_ManagementType.zip; например, MyBotPublisher_1.0.0.0.1_Unmanaged.zip.
Импорт решения с помощником
В Power Apps выберите среду, в которую вы хотите импортировать помощник.
На странице Решения убедитесь, что никакие решения не выбраны, и выберите Импортировать решение.
На панели Импорт решения выберите Обзор, выберите ZIP-файл, содержащий решение с вашим помощником, затем выберите Далее.
Выберите Импорт.
Подождите несколько секунд, пока не будет завершен импорт. Просмотрите результаты, затем выберите Закрыть.
Если импорт завершился неудачно, выберите Загрузить файл журнала, чтобы загрузить XML-файл, содержащий сведения о причинах сбоя импорта. Чаще всего импорт заканчивается сбоем из-за того, что решение не содержит некоторых требуемых компонентов.
Если в вашем помощнике включена аутентификация пользователей, вам потребуется настроить ее заново.
На панели Объекты выберите Чат-бот. Затем выберите имя помощника, чтобы открыть помощник на портале Microsoft Copilot Studio.
Вы также можете напрямую открыть Microsoft Copilot Studio, а затем открыть свой помощник в среде, в которую вы его импортировали.
Важно
- Вы должны опубликовать свой недавно импортированный помощник, прежде чем им можно будет поделиться.
- Может пройти до 24 часов, прежде чем значок вашего помощника появится везде.
Добавление компонентов помощник в пользовательском решении
Если вы добавляете новые компоненты, например темы или потоки, в свой помощник в Microsoft Copilot Studio, вам также потребуется добавить их в помощник в неуправляемом решении.
Откройте решение на портале Power Apps.
Выберите Чат-боты, затем выберите свой помощник в списке.
Выберите Команды (⋮), выберите Расширенный, затем выберите +Добавить необходимые объекты.
Обновление решения с помощником
Узнайте, как обновить или модернизировать решение.
Удаление неуправляемого слоя из управляемого помощника
Управляемые и неуправляемые решения существуют на разных уровнях в среде Microsoft Dataverse. Чтобы узнать больше, см. раздел Слои решения.
При редактировании управляемого компонента, такого как тема или поток, он получает неуправляемый слой «Активный». Чтобы показать последние обновления, после развертывания решения вам нужно удалить этот уровень.
Используйте параметр Показать слои решений, чтобы открыть все решения, частью которых является компонент. Вы можете увидеть одно "Активное" решение поверх всех решений, если вы изменили что-то напрямую.
Откройте решение на портале Power Apps.
Выберите Чат-боты, затем выберите свой помощник в списке.
Выберите Команды (⋮), выберите Расширенный, затем выберите Показать слои решений.
На странице Слои решения выберите неуправляемый слой, затем выберите Удалить неуправляемый слой.