Обзор Bot Framework Composer

Заметка

Эта статья применима только к классическим чат-ботам . Для расширения второго пилота , созданного в Copilot Studio, вам не нужно использовать Bot Framework Composer. Все функции, описанные в этой статье, доступны вторым пилотам непосредственно в приложении Copilot Studio.

Улучшите своего помощника, разработав настраиваемые темы с помощью Bot Framework Composer, затем добавив их в свой помощник Copilot Studio.

Composer интегрирован в Copilot Studio, чтобы разработчики и бизнес-пользователи могли вместе создавать помощников. Composer позволяет расширить возможности вашего помощника с помощью функциональности Bot Framework, в том числе:

• Адаптивные диалоги
• Генерация речи (LG)
• Регулярные выражения (RegEx)
• Адаптивные карточки

Composer с Copilot Studio позволяет получить доступ к разговорной памяти и контексту, включая переменные, определенные в Copilot Studio. Эта память и контекст позволяют создавать темы для обработки прерываний, отмены и переключения контекста. Вы также можете добавить адаптивные карточки для отображения интерактивных элементов, таких как изображения и видео, формы и многое другое в помощнике.

В Composer есть множество готовых функций и выражений, которые вы можете использовать, а также возможность определять несколько вариантов фразы, которые помощник может выбирать случайным образом во время выполнения.

Пользовательские темы, добавленные с помощью Composer, развертываются, размещаются и выполняются вместе с остальным содержимым помощника Copilot Studio и не требуют дополнительного хостинга Azure.

Важно

Интеграция с Composer недоступна для пользователей, у которых есть только лицензия Teams Microsoft Copilot Studio. Вы должны иметь пробную или полную лицензию Microsoft Copilot Studio.

Предварительные условия

• Введение в Bot Framework Composer

Ключевые термины Composer

Composer использует другой набор терминов для описания схожих понятий, используемых в Copilot Studio. Вот несколько ключевых терминов для понимания:

• диалог: Диалоги являются основными шаблон в Composer и служат контейнерами для триггеров. Каждое диалоговое окно представляет собой часть функций бота, содержащую инструкции о том, что делает бот и как он реагирует на ввод пользователя. Чтобы узнать больше о диалогах, см. раздел Диалоги как разговорные стандартные блоки в Composer.

• главный диалог: Главный диалог бот — это первый диалог, который появляется в проводнике бот и создается при импорте вашего Copilot Studio второго пилота в Composer. Основной диалог никогда не следует удалять, так как он соответствует вашему помощнику Copilot Studio.

• триггер: Триггеры являются основным компонентом диалога и позволяют вам улавливать события и реагировать на них. Каждый триггер имеет условие и набор действий, выполняемых при выполнении условия. Триггеры — это эквивалент тем в Copilot Studio. Подробнее о триггерах см. в статье Триггеры.

• действие: Действия — это основные компоненты триггера, которые позволяют отправлять ответ, создавать и назначать значения свойствам, управлять ходом разговора, управлять диалогами и выполнять многие другие действия. Действия — это эквивалент узлов в Copilot Studio.

Функции Composer, которые не поддерживаются с Copilot Studio

Следующие функции Composer не поддерживаются с Copilot Studio:

Неподдерживаемая функция	Дополнительная информация
Распознаватель LUIS (распознавание речи)	Распознаватель по умолчанию в Composer установлен на распознавание естественного языка Microsoft Copilot Studio.
Оркестратор Bot Framework	Оркестратор Bot Framework не поддерживается в Composer для Copilot Studio.
Пользовательский распознаватель	Пользовательский распознаватель не поддерживается в Composer для Copilot Studio.
Навыки ботов	Невозможно вызвать навыки ботов в контенте Composer, предназначенном для Copilot Studio.
QnA Maker	Эта возможность недоступна в Composer для Copilot Studio.
OAuth Вход и выход пользователя	Эти типы действий не поддерживаются в Composer для Copilot Studio.
Входные и выходные данные диалога	Входные и выходные данные диалогов не поддерживаются в Composer для Copilot Studio.
Обнаружение сущностей в триггерных фразах в Composer	Невозможно использовать # getUserName my name is {username=userName} в Composer.
Тестирование в Bot Framework Emulator	Весь контент Composer должен быть опубликован, а затем протестирован в Copilot Studio.

Рекомендации по созданию контента для Copilot Studio в Composer

Есть несколько ключевых рекомендаций, которым нужно следовать при использовании Composer для создания содержимого для Copilot Studio:

• Темы вашего помощника Copilot Studio отображаются в Composer в виде диалоговых окон. Вы не можете редактировать эти диалоги в Composer; их выбор откроет соответствующие темы в Copilot Studio для редактирования.

  

• Доступ к глобальным переменным Copilot Studio в Composer осуществляется с помощью области virtualagent. Эта область не отображается в справочном меню свойств Composer, но вы можете получить к ней доступ, введя выражение напрямую.

• Публикация контента в Composer делает изменения доступными для тестирования, но не публикует автоматически ваш помощник Copilot Studio. Чтобы опубликовать изменения помощника в каналах, используйте функцию Опубликовать в Copilot Studio.

• Используйте действие Начать тему Microsoft Copilot Studio, чтобы вызвать темы Copilot Studio в Composer.

  

• Вы можете добавить новые триггеры Composer любого рода для вашего основного (корневого) диалога.

• Вы можете отправлять сообщения и задавать вопросы с помощью этих триггеров Composer.

• Вы не можете использовать распознаватель регулярных выражений в основном диалоге. Использование распознавателя регулярных выражений в основном диалоге не позволяет вам опубликовать контент Composer в Copilot Studio. Однако вы можете использовать распознаватель регулярных выражений в любых других диалогах Composer.

• Вы можете добавить любые события и триггеры Composer в новые диалоги.

• На странице Ответы бота раздел Общий должен быть пустым. Использование здесь любых активов приведет к ошибкам проверки и не позволит вам опубликовать контент Composer в Copilot Studio.

  

• Каждый диалог Composer имеет собственный ответ бота (.lg) и ресурсы для распознавания речи (.lu). Например, бот, говорящий на английском языке (США) и имеющий диалог с именем dialog1, имеет один файл dialog1.en-us.lg и один файл dialog1.en-us.lu.

• Основной диалог в Composer никогда не следует удалять, так как он соответствует вашему помощнику Copilot Studio. Основной диалог может иметь ноль или больше триггеров.

• Вы можете получать телеметрию в диалогах и триггерах Composer и использовать Application Insights, чтобы анализировать это с Запросами Kusto для адаптивных диалогов. Дополнительные сведения см. в разделе Получение телеметрии с Application Insights.

Подробные сведения о диалогах, событиях и триггерах Composer, а также о порядке создания расширенного контента для ботов с помощью Bot Framework см. в следующих ресурсах:

• Bot Framework Композиторские диалоги
• Bot Framework События и триггеры Composer
• Генерация языка
• Ход разговора и память

Ссылки

Чтобы узнать больше о разработке в Composer, см. следующие ресурсы:

• Bot Framework Композиторская документация
• Тур Композитора
• Учебник: создание нового бот
• Учебник: Добавьте Карточки и кнопки в ваш бот
• Учебник: Добавьте генерацию языка в ваш бот
• Bot Framework Композитор на GitHub

Связанный контент

Начните работу с Bot Framework Composer