Экспорт и импорт ботов с использованием решений
Заметка
Имеется дополнительная информация для пользователей, работающих с Power Virtual Agents (предварительная версия).
Выберите версию Power Virtual Agents, которую вы используете, здесь:
Вы можете экспортировать и импортировать ботов, используя решения, так что вы можете перемещать своих ботов между несколькими средами.
Это может быть полезно, если вы используете разные среды для разных целей или применяете методологии развертывания кольца. Например, у вас может быть определенная среда, в которой вы внутренне тестируете и проверяете ботов, другую среду, в которой вы тестируете ботов только для подгруппы пользователей, и конечную производственную среду, в которой вы делитесь ботами с клиентами и конечными пользователями.
Заметка
Вы не можете экспортировать комментарии на уровне темы или на уровне узла при экспорте бота.
Предварительные условия
- Подробнее о возможностях Power Virtual Agents.
- Для использования этой функции разработчику потребуются минимальные роли безопасности настройщика систем. См. дополнительные сведения о настройке безопасности пользователей для ресурсов в среде.
Создание решения для управления экспортом и импортом
Вы используете решения для экспорта ботов из одной среды и их импорта в другую. Решение выступает в роли носителя для ботов, и вы можете импортировать несколько ботов в одном решении.
Войдите в бот Power Virtual Agents, который требуется экспортировать.
В меню навигации в разделе Параметры выберите Общие. Затем выберите Экспорт.
Выберите Перейти к решениям Power Apps.
Войдите в Power Apps, перейдите на вкладку Решения и выберите Создать решение.
Введите информацию для каждого из полей, как описано в следующей таблице:
Поле Description Показать имя Имя, отображаемое в списке решений. Это имя можно будет изменить впоследствии. Имя (название) Уникальное имя решения. Это имя создается с использованием значения, введенного в поле Отображаемое имя. Его можно отредактировать до сохранения решения, однако после сохранения решения его изменить нельзя. Издатель Можно выбрать издателя по умолчанию или создать нового издателя. Мы рекомендуем вам создать издателя, которого вы можете использовать последовательно во всех средах, где вы будете использовать это решение. Для получения дополнительной информации перейдите к обзору издателя решения. Версия Введите номер версии своего решения. Это важно только при экспорте решения. Номер версии будет включен в имя файла при экспорте решения. Выберите Создать.
Добавление бота в решение
Выберите только что созданное решение.
Выберите Добавить существующий и выберите Чат-бот.
На панели Добавить существующие чат-боты выберите бота (или ботов), которого хотите экспортировать. Выберите Добавить.
Если вы используете навыки, удалите переменные среды навыка Текущее значение выбрав Удалить из этого решения.
Заметка
Удаление бота из решения не удаляет его компоненты из решения. Удаление компонентов должно быть сделано отдельно.
Предупреждение
Не удаляйте неуправляемые подкомпоненты чат-ботов (например, темы бота) непосредственно с портала Power Apps, если только вы не удалили сам бот из решения.
Вы должны вносить изменения в темы только на портале Power Virtual Agents.
Удаление или изменение подкомпонентов чат-бота из Power Apps приведет к сбою экспорта и импорта.
Экспорт решения с ботом
Экспортировать можно только неуправляемые решения. По умолчанию новое решение создается как неуправляемое. Если затем вы измените его на управляемое решение, вы не сможете его экспортировать.
Внимание
Если у вашего бота большое количество компонентов (например, более 250 тем или более 100 сущностей), см. раздел Экспорт с помощью классического интерфейса.
В списке решений выберите решение, содержащее бот, который требуется экспортировать. Выберите Экспорт решения.
Выберите Далее в области Перед экспортом.
Появится область Экспорт этого решения. Введите или выберите один из следующих параметров, затем выберите Экспорт:
Вариант Описание Номер версии Power Virtual Agents автоматически увеличивает версию вашего решения при отображении текущей версии. Вы можете принять версию по умолчанию или ввести свою собственную. Экспортировать как Выберите тип пакета, Управляемый или Неуправляемый. Дополнительные сведения об управляемых и неуправляемых решениях.
Экспорт может занять несколько минут. После завершения файл .zip будет загружен вашим веб-браузером. Файл будет в формате SolutionName_Version_ManagementType.zip.
Импорт решения с ботом
В верхнем меню выберите имя среды и выберите среду, в которую вы хотите импортировать своего бота.
Перейдите на вкладку Решения и на панели команд выберите Импорт.
В окне Выберите пакет решений выберите Выбрать файл и найдите файл .zip, содержащий решение с ботом, который вы хотите импортировать.
Выберите Далее.
Отображаются сведения о решении. Выберите Импорт.
Может потребоваться подождать несколько секунд, пока не будет завершен импорт. Просмотрите результаты и выберите Закрыть.
Если импорт не завершился успешно, появится отчет со всеми зафиксированными ошибками или предупреждениями. Выберите Загрузить файл журнала для получения сведений о том, что вызвало ошибку импорта, в файле XML.
Чаще всего импорт заканчивается ошибкой из-за того, что решение не содержит некоторых требуемых компонентов. Например, у вас может не быть обновленных ботов в среде.
Если у вашего бота есть что-либо из следующего, вам необходимо настроить это после первого импорта:
Аутентификация конечного пользователя: настройте аутентификацию конечного пользователя в боте, чтобы он мог выполнять действия от имени пользователя. Бот может быть настроен с любым поставщиком удостоверений OAuth2, таким как Azure Active Directory (Azure AD), учетная запись Microsoft или Facebook.
Передача в службу поддержки клиентов: настройте внешние службы, в которые передаются эскалации ботов агенту-человеку.
Многоканальность: настройка внешних каналов, например Facebook и Microsoft Teams:
На панели Объекты выберите Чат-бот. Затем выберите имя бота, чтобы открыть его на портале Power Virtual Agents.
Вы также можете перейти к веб-приложение Power Virtual Agents и откройте импортированного бота в среде, в которую вы импортировали.
Внимание
- Вы должны опубликовать своего недавно импортированного бота, прежде чем им можно будет поделиться.
- Может пройти до 24 часов, прежде чем значок вашего бота появится везде.
Добавьте новые компоненты в чат-бот в настраиваемом решении
Если вы добавляете новые компоненты бота (например, новые темы или потоки) в своего бота в Power Virtual Agents, вам также потребуется добавить эти компоненты в бот в неуправляемом решении.
Перейдите к своему неуправляемому решению на портале Power Apps.
Выберите Чат-боты и найдите своего бота в списке.
Выберите Команды (⋮), затем выберите Добавить необходимые объекты.
Обновление решения с чат-ботом
Чтобы обновить или обновить существующее управляемое решение, перейдите по ссылке Обновление решения.
Удаление неуправляемого слоя из управляемого чат-бота
Управляемые и неуправляемые решения существуют на разных уровнях внутри среды Microsoft Dataverse. Чтобы узнать больше, см. раздел Слои решения.
Управляемый компонент (например, тема или поток) получает неуправляемый «Активный» уровень при его редактировании, что означает, что вы не увидите последних изменений после развертывания решения.
Чтобы показать последние обновления, вам нужно удалить неуправляемый уровень «Активный».
Используйте параметр Показать слои решений, чтобы открыть все решения, частью которых является компонент. Вы можете увидеть одно "Активное" решение поверх всех решений, если бы вы изменили что-то напрямую.
Выберите Команды (три вертикальные точки), выберите Расширенный, затем выберите Показать слои решений.
На странице слоя решения выберите неуправляемый слой, затем выберите Удалить неуправляемый слой, чтобы удалить слой.