Создание и редактирование тем

Типы тем

Агент может содержать два типа тем, системные и пользовательские темы. Каждый новый агент начинает работу с набором предопределенных системных и пользовательских тем.

• Системные темы поддерживают основные поведения, такие как пользовательский запрос на разговор с человеком или завершение разговора. В некоторых системных темах есть фразы-триггеры, которые вы можете настроить в соответствии с потребностями вашего агента.

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

  Дополнительные сведения см. в разделе Использование системных тем.

• Предопределенные пользовательские темы охватывают распространенные действия, такие как приветствие клиента, завершение разговора или возобновление разговора.

  • Вы можете вносить изменения в предопределенные пользовательские темы или полностью удалить их из агента.
  • Все темы, которые вы создаете, являются пользовательскими темами.

Типы узлов

Доступны следующие типы узлов:

Создание темы

1. Перейдите на страницу Темы для вашего агента. Для лучшей видимости пока закройте тестовую панель.

2. Выберите Добавить тему и выберите С нуля.

   Узел Триггер появляется на в остальном пустом холсте темы.

3. Выберите значок Дополнительно (…) узла Триггер, а затем выберите Свойства. Появится панель Свойства при распознанном намерении.

4. В свойствах При распознанном намерении выберите область Фразы. Появится дополнительная панель Фразы.

5. В разделе Добавить фразы введите фразу-триггер для вашей темы.

   Вашему агенту нужно от 5 до 10 фраз-триггеров, чтобы научить ИИ понимать ответы ваших клиентов. Чтобы добавить больше триггерных фраз, вы можете:

   • Выберите значок Добавить рядом с текстовым полем и введите нужную фразу.
   • Вставьте набор фраз-триггеров, каждую в отдельной строке, и нажмите Enter.
   • Введите набор фраз-триггеров, нажимая Shift+Enter после каждой из них, чтобы разместить их на отдельной строке, и выберите Enter.
   • Отправьте файл со списком фраз-триггеров, которые вы хотите добавить для этой темы.

   Вы можете включать знаки препинания в триггерную фразу, но лучше использовать короткие фразы, а не длинные предложения.

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

7. Добавьте сведения по теме:

   • Введите имя, чтобы идентифицировать тему, например "Часы работы магазина". На странице Темы перечислены все темы, определенные в вашем агенте, под этим именем.
   • При необходимости введите отображаемое имя, которое будет показываться клиенту, если агент не может определить, какая тема соответствует сообщению клиента.
   • Если нужно, используйте поле Описание, чтобы описать назначение темы для себе и других создателей агентов в вашей рабочей группе. Клиенты никогда не видят описания тем.

8. Чтобы сохранить тему, в верхней строке меню выберите Сохранить.

Отправка фраз-триггеров для темы

На панели Фразы узла Триггер темы можно добавить или заменить набор фраз-триггеров, связанных с темой.

1. Подготовьте текстовый файл (максимум 3 МБ) со списком всех фраз-триггеров, которые вы хотите добавить в свою тему, с каждой фразой в отдельной строке.

2. В разделе Добавить фразы выберите отправить файл.

3. В разделе Отправить файл выберите нужный вариант:

   • Если вы хотите добавить новые фразы-триггеры для темы, выберите Добавить.
   • Чтобы заменить все существующие фразы-триггеры списком из файла, выберите Заменить.

4. Перетащите файл в окно. Кроме того, можно выбрать нажмите, чтобы просмотреть, перейти к файлу и выбрать его.

5. Просмотрите отображаемые фразы-триггеры и выберите Добавить.

6. Сохраните тему.

Загрузка фраз-триггеров для темы

На панели Фразы узла Триггер темы можно скачать набор фраз-триггеров, связанных с темой.

1. В разделе Добавить фразы выберите скачать.

2. Сохраните получившийся текстовый файл или откройте его в текстовом редакторе, чтобы просмотреть его содержимое. Каждая фраза-триггер отображается в отдельной строке.

Разработка пути разговора темы

Когда вы создаете тему, узел Триггер автоматически появляется на холсте разработки. Затем вы можете добавить различные типы узлов для достижения желаемого пути разговора для вашей темы.

Чтобы добавить узел после другого узла или между двумя узлами на холсте разработки темы:

1. Выберите значок Добавить узел под узлом, в который вы хотите добавить новый узел.

2. Выберите желаемый тип узла из появившегося списка.

   

Удаление узла

Выберите значок Еще (...) в узле, который вы хотите удалить, затем выберите Удалить.

Элементы управления для редактирования узлов на холсте

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

На панели инструментов также есть элемент управления для отмены редактирования. Откройте меню Отменить, чтобы вернуть все действия к последнему сохранению или повторить предыдущее действие.

Вставить узлы

Если вы используете инструменты Вырезать или Копировать, чтобы поместить один или несколько узлов в буфер обмена, есть два способа, чтобы вставить их на холст:

• Если вы выберете узел, а затем выберите Вставить, узлы из буфера обмена вставляются после выбранного узла.

• Если вы выберете «+», чтобы увидеть меню Добавить узел, затем выберите Вставить, узел в буфере обмена вставляется в это место.

Добавление входных и выходных параметров для темы

Темы могут иметь входные и выходные параметры. Когда тема перенаправляется на другую тему, вы можете использовать эти параметры для передачи информации между темами.

Кроме того, если ваш агент использует генеративный режим, он может автоматически заполнять входные данные темы из контекста разговора или после создания вопросов для сбора значений от пользователей. Это поведение похоже на то, как генеративное заполнение слотов работает для действий.

Дополнительные сведения о входных и выходных параметрах для тем см. в разделе Управление входными и выходными данными тем.

Изменение тем с помощью редактора кода

Редактор кода показывает тему в YAML — языке разметки, который легко читать и понимать. Используйте редактор кода для копирования и вставки тем из других ботов, — даже созданных другими авторами.

В этом примере вы копируете и вставляете YAML в редактор кода, чтобы быстро добавить тему, которая запрашивает у клиента информацию о доставке.

1. На странице Темы выберите Создать>С нуля.

2. В правом верхнем углу холста разработки выберите Еще, затем выберите Открыть редактор кода.

   

3. Выберите и удалите содержимое редактора кода. Затем скопируйте и вставьте следующий код YAML:

   kind: AdaptiveDialog
   beginDialog:
     kind: OnRecognizedIntent
     id: main
     intent:
       displayName: Lesson 3 - A topic with a condition, variables and a prebuilt entity
       triggerQueries:
         - Buy items
         - Buy online
         - Buy product
         - Purchase item
         - Order product
   
     actions:
       - kind: SendMessage
         id: Sjghab
         message: I am happy to help you place your order.
   
       - kind: Question
         id: eRH3BJ
         alwaysPrompt: false
         variable: init:Topic.State
         prompt: To what state will you be shipping?
         entity: StatePrebuiltEntity
   
       - kind: ConditionGroup
         id: sEzulE
         conditions:
           - id: pbR5LO
             condition: =Topic.State = "California" || Topic.State = "Washington" || Topic.State     = "Oregon"
   
         elseActions:
           - kind: SendMessage
             id: X7BFUC
             message: There will be an additional shipping charge of $27.50.
   
           - kind: Question
             id: 6lyBi8
             alwaysPrompt: false
             variable: init:Topic.ShippingRateAccepted
             prompt: Is that acceptable?
             entity: BooleanPrebuiltEntity
   
           - kind: ConditionGroup
             id: 9BR57P
             conditions:
               - id: BW47C4
                 condition: =Topic.ShippingRateAccepted = true
   
             elseActions:
               - kind: SendMessage
                 id: LMwySU
                 message: Thank you and please come again.
   

4. Выберите Сохранить, затем выберите Закрыть редактор кода. Узел Вопрос теперь содержит множество условий для вопроса о доставке.

   

Тестирование и публикация агента

Проверьте свой агент, когда вы вносите изменения в свои темы, чтобы убедиться, что все работает как положено.

После того, как вы разработали и протестировали свой агент, опубликуйте его в Интернете, в мобильных или собственных приложениях или каналах Microsoft Bot Framework.

Использование системных тем и примеров тем

Когда вы создаете бота, для вас создается несколько тем.

Такие автоматически создаваемый темы можно разделить на две категории:

• Темы уроков помогают понять простые и сложные способы использования узлов для создания разговоров ботов.

  Вы можете редактировать темы уроков или удалять их полностью.

• Системные темы — это темы, которые вам, скорее всего, понадобятся во время разговора с ботом.

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

Создание темы

1. В меню навигации выберите Темы, затем Создать тему, затем С нуля.

   Откроется область Фразы-триггеры.

2. Добавьте несколько триггерных фраз для вашей темы в разделе Добавить фразы.

   

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

3. На верхней панели измените заголовок вашей темы, чтобы дать ему имя.

   

4. Нажмите Ввод или выберите значок Сохранить, чтобы сохранить изменения.

5. Выберите значок Сведения. Здесь вы также можете отредактировать Имя и добавить Отображаемое имя и Описание.

   Отображаемое имя сообщает боту, о какой теме спрашивает человек.

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

   

6. Выберите Сохранить, чтобы добавить тему в список тем.

Разработка пути разговора темы

1. В списке тем выберите тему, которую требуется изменить. Вы видите триггерные фразы темы. Здесь вы определяете путь разговора между клиентом и агентом.

   Для существующих или системных тем несколько узлов создаются автоматически. Вы можете редактировать эти узлы так же, как и другие узлы.

   Когда вы создаете новую тему, узел Триггер и пустой узел Сообщение вставляются для вас.

2. Чтобы добавить узел, выберите «+», Добавить узел, расположенный между узлами или после них.

   

3. Чтобы изменить пути между узлами, перетащите маленький кружок вверху узла — это якорь узла — в новое место на холсте. Пунктирная линия представляет исходный путь.

   

Вставка узлов

Когда вы добавляете узел после узла Триггерные фразы или между узлами Сообщение, вы можете следующее:

• Задать вопрос
• Вызвать действие
• Показать сообщение
• Перенаправьте разговор на другую тему
• Завершить разговор

Задать вопрос

1. Чтобы добавить узел, выберите параметр Задать вопрос в меню «+» Добавить узел, чтобы добавить новый узел Вопрос. Появится узел вопроса.

   

2. Введите фразу вопроса в поле Задать вопрос.

   Например, если пользователь хочет узнать часы работы магазина, вопрос бота может быть таким: Какой адрес магазина вам нужен?

3. В разделе Идентифицировать выберите вариант ответа пользователя, например Несколько вариантов выбора.

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

4. В разделе Варианты для пользователя введите ожидаемые ответы на вопрос бота.

   Например, если вы выбрали Несколько вариантов выбора в пункте Идентифицировать, варианты могут включать адреса магазинов, например Сиэтл, Бельвью или Киркленд.

   

   Каждый вариант представлен пользователю в виде кнопки множественного выбора в чате, но пользователи также могут ввести свой ответ.

5. (Необязательно) Сохраните ответ пользователя в переменной для использования позже.

Редактор беседы создает отдельные пути в беседе, в зависимости от ответа клиента. Путь разговора приводит клиента к соответствующему решению для каждого ответа. Вы можете добавить узлы для создания логики ветвления и указать, что бот должен отвечать для каждого пути или переменной.

Вызвать действие

Чтобы вызвать потоки Power Automate и вставить узлы аутентификации, выберите Вызвать действие в меню «+» Добавить узел.

Если для вашего бота включены голосовые возможности, вы увидите больше действий.

Показать сообщение

1. Чтобы задать ответ от бота, выберите «+» Добавить узел, чтобы добавить узел, а затем выберите Показать сообщение, чтобы добавить новый узел Сообщение.

2. Введите в текстовом поле сообщение, которое вы хотите, чтобы сказал бот.

   Вы можете применить некоторое базовое форматирование, такие как жирный шрифт, курсив и нумерованные и маркированные списки и гиперссылки. Вы также можете использовать переменные, которые вы определили в другом месте в диалоге с ботом.

Перенаправление на другую тему

1. Чтобы бот перемещался в другую тему, выберите «+» Добавить узел, чтобы добавить узел, а затем выберите Перенаправление на другую тему. Появится список тем.

2. Выберите тему, в которую перенаправляется бот. Например, вы можете отправить пользователя в тему по поводу закрытия магазина, если он спросит о времени работы магазина.

   

Перенаправленная тема является подтемой.

Вы можете вставить дополнительные узлы в узел подтемы.

Когда путь разговора будет завершен, бот возвращается к исходной теме. Затем бот следит за узлами, находящимися под узлом подтемы.

Однако если вы перенаправляете в любую из следующих системных тем, весь разговор заканчивается:

• Конец разговора
• Подтвержденный успех
• Подтвержденная неудача
• До свидания
• Эскалация
• Начать сначала (также обнуляет все глобальные переменные)

Завершить разговор

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

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

В конце ответа, который решает проблему пользователя или отвечает на вопрос, добавьте узел Закончить разговор.

• Чтобы завершить с опросом удовлетворенности клиента, выберите Завершить с опросом.

• Чтобы вставить узел передачи, который будет связан с вашим сконфигурированным продуктом передачи, выберите Передать агенту.

  (Необязательно) Введите для агента личное сообщение.

  

Добавить условие

1. Чтобы добавить логику ветвления на основе переменных, выберите «+» Добавить узел, чтобы добавить узел.

2. Выберите Добавить условие.

3. Выберите Ветвление на основе условия.

4. Выберите переменную, которая определяет, должен ли разговор с ботом разветвляться в этот момент.

   Например, если вы настроили аутентификацию пользователя, вам может потребоваться другое сообщение, если пользователь вошел в систему.

Удаление узлов

Выберите значок меню (⋮) в узле, который вы хотите удалить, а затем выберите Удалить.

Тестирование и публикация бота

Проверьте свой агент, когда вы вносите изменения в свои темы, чтобы убедиться, что все работает как положено.

После того, как вы создали и протестировали свой бот, опубликуйте его в Интернете, в мобильных или собственных приложениях или каналах Microsoft Bot Framework.

Разработка пути разговора темы — Teams

1. В списке тем вашего агента выберите тему, которую требуется изменить. Например, вы можете изменить тему Часы работы магазина.

   

   После открытия вы видите триггерные фразы темы. На этом холсте разработки вы определяете путь разговора между клиентом и ботом.

   Когда вы создаете новую тему, узел Триггерные фразы и пустой узел Сообщение вставляются для вас.

   Для существующих или системных тем несколько узлов создаются автоматически с каждой новой темой. При необходимости можно изменить эти узлы.

2. Вы можете добавить больше узлов, выбрав «+» Добавить узел между узлами или после узла.

   

3. Чтобы изменить пути между узлами, перетащите якорь узла — маленький кружок вверху узла. Вы увидите пунктирную линию, указывающую исходный путь.

   

Вставка узлов — Teams

При добавлении узла в узел триггерных фраз выберите один из пяти различных вариантов:

• Задать вопрос
• Вызвать действие
• Показать сообщение
• Перенаправление на другую тему
• Завершить разговор

Если вы хотите перенаправить тему, вы можете перейти на другую тему.

Задать вопрос — Teams

1. Чтобы добавить узел, выберите параметр Задать вопрос в меню «+» Добавить узел, чтобы добавить новый узел Вопрос. Появится узел вопроса.

   

2. Введите фразу вопроса в поле Задать вопрос.

   Например, если пользователь хочет узнать часы работы магазина, вопрос бота может быть таким: Какой адрес магазина вам нужен?

3. В разделе Идентифицировать выберите вариант ответа пользователя, например Несколько вариантов выбора.

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

4. В разделе Варианты для пользователя введите ожидаемые ответы на вопрос бота.

   Например, если вы выбрали Несколько вариантов выбора в пункте Идентифицировать, варианты могут включать адреса магазинов, например Сиэтл, Бельвью или Киркленд.

   

   Каждый вариант представлен пользователю в виде кнопки множественного выбора в чате, но пользователи также могут ввести свой ответ.

5. (Необязательно) Сохраните ответ пользователя в переменной для использования позже.

Редактор беседы создает отдельные пути в беседе, в зависимости от ответа клиента. Путь разговора приводит клиента к соответствующему решению для каждого ответа. Вы можете добавить дополнительные узлы для создания логики ветвления и указать, что бот должен отвечать для каждого пути или значения.

Добавить условие — Teams

Для некоторых типов узлов вы можете добавить условие.

1. Чтобы добавить логику ветвления на основе переменных, выберите меню «+» Добавить условие, затем выберите Добавить условие, чтобы добавить узел. Появится пара узлов условий.

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

   

Вызвать действие — Teams

Вы можете вызвать потоки Power Automate, выбрав Вызвать действие в меню «+» Добавить узел.

Показать сообщение — Teams

Сообщение может указывать ответ вашего бота пользователю.

1. Выберите меню «+» Добавить узел, затем выберите Показать сообщение, чтобы добавить новый узел Сообщение.

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

   Вы также можете использовать переменные, которые вы определили в другом месте, в диалоге с ботом.

Завершить разговор — Teams

Вы можете выбрать Завершить разговор в качестве конечного узла разговора вашего бота.

Возможны два варианта:

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

  

• Вариант Передать агенту позволяет вам ввести личное сообщение агенту, которое инициирует контакт с пользователем.

Перенаправление на другую тему — Teams

Чтобы бот автоматически перемещался в отдельную тему, выберите Добавить узел (+), чтобы добавить узел, затем Перенаправление на другую тему.

Во всплывающем меню выберите тему, на которую нужно перенаправить бот. Например, вы можете отправить пользователя на конкретную тему о закрытии магазина, если он спросил о времени работы этого магазина.

Когда бот переходит к другой теме, бот проходит путь разговора для этой темы, а затем возвращается к исходной теме — в том месте, где он остановился.

Вы можете рассматривать перенаправленную тему как «подтему».

Однако если вы перенаправляете в любую из следующих системных тем, весь разговор заканчивается:

• Начать сначала (сбрасывает все глобальные переменные)
• Эскалация
• Конец разговора
• Подтвержденная неудача
• Подтвержденный успех
• До свидания

Использование переменных

Вы можете использовать переменные, которые вы определили в другом месте, в диалоге с ботом.

Удаление узлов — Teams

Выберите значок меню (⋮) в узле, который вы хотите удалить, а затем выберите Удалить.

Тестирование и публикация бота — Teams

После внесения изменений в свои темы проверьте свой агент, чтобы убедиться, что все работает как положено.

После того как вы закончите разработку и тестирование своего бота, вы можете опубликовать его, чтобы другие участники рабочей группы могли его использовать.