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

В Copilot Studio тема определяет, как происходит разговор с агентом.

Чтобы создавать темы, вы можете описать, что вы хотите, и поручить ИИ создать тему за вас или можете создавать темы с нуля.

Дополнительную информацию об ограничениях для агентов и тем см. в теме Значения квот, лимитов, регистрации приложения, сертификатов и конфигурации.

Выбор правильной темы для ответа пользователю

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

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

В агентах, настроенных на классическую оркестрацию, каждая тема содержит набор триггерных фраз — фраз, ключевые слова и вопросы, которые клиент, скорее всего, будет использовать для запросов, связанных с конкретной проблемой. Эти агенты используют понимание естественного языка, сообщение клиента и триггерные фразы темы, чтобы найти лучшую тему. Ввод клиента не обязан точно совпадать с фразой-триггером темы, чтобы запустить тему. Например, тема о часах магазина может содержать триггерную фразу «проверьте часы магазина». Если покупатель вводит «смотреть часы работы магазина», эта фраза запускает вашу тему часов магазина. Узнайте больше о написании триггерных фраз.

Темы в Copilot Studio

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

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

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

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

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

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

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

Типы узлов

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

Тип узла Description
Узел сообщения Отправьте клиенту сообщение.
Узел вопроса Задайте вопрос клиенту.
Узел адаптивной карты Покажите интерактивную карту с одной или несколькими кнопками ответа или полями ввода.
Узел состояния Ветвление разговора на основе условия.
Узлы управления переменными Установить значение — парсировать значение или очистить переменные (включая возможность очищать историю разговоров, используемую агентом).
Управление темами Перенаправьте разговор, переведите пользователя или завершите тему или беседу.
Узлы инструментов Вызовите поток, например Power Automate или Excel Online, или используйте разъём или другой инструмент.
Расширенные Отправляйте генеративные ответы, HTTP-запросы, события и многое другое.

Совет

Переименуйте узлы, чтобы их было легче идентифицировать. Выберите поле имени узла для прямого обновления имени или выберите три точки (...) узла и выберите « Переименовать » в меню. Можно также переименовывать узлы в редакторе кода.

Невозможно переименовать узлы Триггер и Перейти на шаг.

Имена узлов могут иметь длину до 500 символов.

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

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

  2. Выберите «Добавить тему», затем выберите «Из пустого».

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

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

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

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

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

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

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

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

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

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

Важно

Избегайте использования точек (.) в названиях тем. Невозможно экспортировать решение, содержащее агент с точками в названии любой из его тем.

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

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

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

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

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

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

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

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

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

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

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

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

Редактировать тему

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

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

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

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

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

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

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

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

На панели инструментов также есть возможность отменить правки. Выберите значок отмены и выберете:

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

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

После того как вы с помощью инструментов Cut or Copy разместите один или несколько узлов в буфере обмена, вы можете вставить их на холст двумя способами:

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

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

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

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

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

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

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

Редактор кода показывает тему в 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. Выберите «Сохранить», затем «Закрыть редактор кода». Обратите внимание на условную логику, которая следует за некоторыми узлами Вопроса .

    Снимок экрана: разговор, созданный из YAML в редакторе кода Copilot Studio.

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

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

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