Поделиться через

Отображение формы с кнопкой "Отправить" в 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.

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

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

  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?, чтобы начать разговор.