Отображение формы с кнопкой "Отправить" в Copilot Studio

Заметка

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

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

В этом примере вы узнаете, как отобразить форму с кнопкой Отправить в Copilot Studio с помощью Composer.

Внимание

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

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

• Показать адаптивный карточка в Copilot Studio.
• Отобразить список вариантов множественного выбора в Copilot Studio.
• Используйте поиск Bing в качестве запасного варианта Copilot Studio.

Создание нового триггера

1. В Copilot Studio откройте второго пилота из примера 3. Если вы еще не выполнили пример 3, см. раздел Использование поиска Bing в качестве резервного варианта в Copilot Studio.

2. Откройте своего бота в Composer. Инструкции о том, как это сделать, см. в разделе Начало работы с Bot Framework Composer.

3. В обозреватель ботов перейдите в основной диалог. Выберите Другие параметры (...), а затем — Добавить новый триггер.

4. В окне Создание триггера:

   1. Для Какого типа этот триггер? выберите Намерение распознано.

   2. В поле Как называется этот триггер? введите StartTrial.

   3. Для Фразы-триггеры скопируйте и вставьте следующее:

      - start trial
      - sign up to try
      - register to try service
      

   4. Выберите Отправить.

   

5. Перейдите на страницу Ответы бота, выберите Служба доставки еды Contoso, а затем выберите Показать код.

6. Скопируйте и вставьте следующее в представление кода:

   # adaptivecardjson_StartTrialForm()
   - ```
   {
       "type": "AdaptiveCard",
       "body": [
           {
               "type": "TextBlock",
               "size": "Medium",
               "weight": "Bolder",
               "text": "Register for a meal plan trial:"
           },
           {
               "type": "Input.Text",
               "placeholder": "Please enter your Name",
               "id": "Name"
           },
           {
               "type": "Input.Text",
               "placeholder": "Please enter your Address",
               "id": "Address",
               "isMultiline": true
           },
           {
               "type": "Input.Number",
               "placeholder": "How many weeks",
               "id": "Weeks"
           },
           {
               "type": "ActionSet",
               "actions": [
                   {
                       "type": "Action.Submit",
                       "title": "Submit",
                       "style": "positive"
                   }
               ]
           }
       ],
       "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
       "version": "1.2"
   }
   ```
   

   У каждого поля для ввода данных в этой адаптивной карточке есть уникальный ИД: Имя, Адрес и Недели.

   

7. Скопируйте и вставьте следующий код в то же представление кода:

   # AdaptiveCard_StartTrialForm()
   [Activity
       Attachments = ${json(adaptivecardjson_StartTrialForm())}
   ]
   

   

Логика добавления разговора

1. Перейдите на страницу Создать и выберите триггер StartTrial.

2. На холсте разработки выберите Добавить (+), Задать вопрос и Текст.

3. На панели свойств в разделе Ответы бота выберите Показать код.

   Предупреждение

   Добавление выражения на следующем шаге в редактор ответов вместо редактора кода приведет к тому, что бот ответит необработанным JSON вместо адаптивной карточки.

4. Скопируйте и вставьте следующее выражение:

   - ${AdaptiveCard_StartTrialForm()}
   

   

5. Выберите вкладку Данные, введенные пользователем в области свойств, а затем выполните следующие действия:

   1. В поле Свойство введите user.name.
   2. Для Значение введите =turn.activity.value.Name.

   

6. На холсте разработки выберите Добавить (+), Управление свойствами и Установить свойства.

7. В области свойств выполните следующие действия:

   1. В разделе Назначения выберите Добавить новое, чтобы добавить поле Свойство и поле Значение.
   2. В поле Свойство введите user.address
   3. Для Значение введите =turn.activity.value.Address.
   4. Выберите Добавить новое второй раз, чтобы добавить другое Свойство и Значение.
   5. В поле Свойство введите user.weeks.
   6. Для Значение введите =turn.activity.value.Weeks.

   

8. На холсте разработки выберите Добавить (+), а затем выберите Отправить ответ.

9. В редакторе ответов скопируйте и вставьте следующее:

   ${user.name} - thanks for starting a ${user.weeks} week trial with us! Your meals will be delivered to this address: ${user.address}.
   

   

10. На холсте разработки выберите Добавить (+), а затем выберите Начать тему Microsoft Copilot Studio.

11. В области свойств для Имя диалога выберите Конец разговора.

    

Протестируйте бота

1. Опубликуйте свой контент Composer , чтобы сделать его доступным в вашем Copilot Studio втором пилоте.

   Важно

   Выбор Опубликовать в Composer делает изменения доступными для тестирования, но не публикует автоматически бота.

   Опубликуйте свой бот в Microsoft Copilot Studio , чтобы обновить свой бот на всех каналах, к которым он подключен.

2. Перейдите на страницу Copilot Studio Темы , чтобы увидеть свой новый StartTrial тема.

   

3. Откройте Панель тестирования бота и убедитесь, что параметр Отслеживать смену тем включен. Введите сообщение How do I sign up for a trial?, чтобы начать разговор.