Использование действий с настраиваемыми помощниками (предварительная версия)
Вы можете расширить возможности своего помощника, добавив одно или несколько действий. Действия используются вашим помощником для автоматического ответа пользователям, используя генеративные действия, или вы можете вызвать их явно из темы.
[Данная статья посвящена предварительному выпуску и может быть изменена.]
Основные типы действий
Если вы включите генеративный режим, ваш помощник может автоматически выбрать наиболее подходящее действие или тему, чтобы ответить пользователю во время выполнения.
В классическом режиме помощник может использовать темы только для ответа пользователю. Однако вы все равно можете спроектировать свой помощник так, чтобы он вызывал действия явно из тем.
Действия основаны на одном из следующих основных типов действий:
- Действие готового соединителя
- Действие настраиваемого соединителя
- Облачный поток Power Automate
- Запросы AI Builder
- Навык Bot Framework
Важно
Вы не можете использовать разговорные действия, созданные в Copilot Studio, как действия с настраиваемыми помощниками.
Каждое основное действие имеет дополнительную информацию, описывающую его цель, что позволяет помощнику использовать генеративный ИИ для генерации вопросов. Эти вопросы необходимы для заполнения элементов входных данных, необходимых для выполнения действия. Следовательно, вам не нужно вручную создавать узлы вопросов для сбора всех необходимых входных данных, таких как входные данные потока. Входные данные обрабатываются за вас во время выполнения.
Действия могут генерировать контекстный ответ на запрос пользователя, используя результаты действия. Альтернативно, вы можете явно создать ответ на действие.
Совет
При использовании вопросов, сгенерированных в результате действия, сообщите пользователям, что часть разговора генерируется искусственным интеллектом.
Например, добавьте дополнительное сообщение в системную тему Начало разговора. Этот тема определяет сообщение, которое будет показано пользователям при начале нового разговора.
Добавление действия
Откройте свой собственный помощник, выбрав Помощники на левой панели навигации и выбрав помощник из списка.
Выберите Действия, чтобы просмотреть действия помощника.
Выберите + Добавить действие.
В мастере Выбор действия (предварительная версия) найдите действие, которое хотите использовать, и выберите его.
Отображаемый по умолчанию список содержит потоки Power Automate и пользовательские соединители, доступные в вашей среде. В этот список входят часто используемые готовые соединители и навыки Bot Framework, зарегистрированные в вашем помощнике.
Важно
Некоторые действия, созданные с помощью подключаемых модулей ИИ, такие как динамические запросы и действия на основе API-интерфейсов Dataverse, требуют аутентификации.
В зависимости от действия ваше соединение настраивается автоматически, как показано в примере. Альтернативно вам необходимо настроить подключение, если инструкции приведены в мастере. После успешной настройки подключения выберите Далее.
Проверьте и, при необходимости, внесите изменения в конфигурацию действий подключаемого модуля. Выберите Готово, чтобы добавить действие в свой помощник.
Выберите Далее.
Вызвать действие
Если вы включили генеративные действия, ваше действие вызывается автоматически в ответ на соответствующий запрос пользователя.
Альтернативно, вы можете явно вызвать действие из темы.
Протестируйте свое действие
Вызов действия
Ваш помощник выбирает и запускает ваше действие на основе имени и описания. Вы можете создавать высококачественные описания, используя специальный режим трассировки, чтобы увидеть, какие действия выбрал ваш помощник на странице генеративных действий.
Альтернативно, если вы добавили к теме, вы можете проверить его, введя сообщение, похожее на одну из триггерных фраз для этой темы.
На этом снимке экрана вы можете увидеть тестируемое погодное действие:
Альтернативно, если вы добавили действие в тему, вы можете протестировать его, запустив тему с подходящей триггерной фразой.
Настройка входных и выходных данных для действия
Внесение изменений в конфигурацию действий
Настроить действие можно разными способами. На последнем этапе мастера действий, который называется Просмотр и завершение, вы можете внести изменения в конфигурацию действия, нажав Изменить рядом с соответствующим разделом.
Сведения о действии
Здесь вы можете настроить подробную информацию о своем действии, включая Отображаемое имя модели и Описание модели для вашего действия. Обычно имя и описание заполняются автоматически в соответствии с выбранным действием.
Свойства Отображаемое имя и Описание для каждого ввода помогают помощнику понять цель ввода, чтобы сгенерировать подходящий вопрос для пользователя и распознавать правильное значение в ответе пользователя. Например, ниже приведены имя и описание входного параметра местоположения по умолчанию для соединителя MSN Weather.
- Имя: Местоположение
- Описание: Местоположение поискового запроса. Допустимые входные данные: город, регион, район, страна, достопримечательность, почтовый индекс, широта и долгота
Запрашивая у пользователя местоположение, помощник генерирует вопрос, похожий на: В каком месте вы хотели бы узнать погоду? Вы можете ввести город, регион, штат, страну, достопримечательность или почтовый индекс.
Вы можете изменить значение параметра Определить как на конкретный тип сущности в зависимости от собираемых входных данных, чтобы помочь помощнику точно извлекать значение из ответа пользователя.
По умолчанию для каждого ввода установлено значение Динамическое заполнение лучшим вариантом. Помощник пытается заполнить значение из доступного контекста, например, извлекая значение из сообщения пользователя. Если подходящее значение не найдено, он генерирует вопрос для запроса значения у пользователя. Вы можете переопределить ввод значением вместо того, чтобы спрашивать пользователя. Для переопределения измените значение в раскрывающемся списке Как помощник будет заполнять этот элемент входных данных? на Установите значение, затем введите значение, которое вы хотите использовать. Это значение может быть литеральным значением, существующей переменной или формулой Power Fx.
Чтобы контролировать поведение помощника при запросе значения или проверке ответа пользователя, вы можете настроить дополнительные настройки для входных данных.
Выходные данные
По умолчанию ваше действие настроено на автоматическое создание контекстного ответа для пользователя на основе его запроса и результата действия. Например, если пользователь спрашивает: «Какова текущая температура в Лондоне?», генерируется контекстный ответ с использованием GPT, например: «Текущая температура в Лондоне — 9 градусов по Цельсию».
Кроме того, вы можете создать конкретный ответ для возврата вашим действием. Как и в редакторе подтверждений, вы можете вставлять ссылки на выходные переменные из действия, используя средство выбора переменных, как показано в этом примере.
Вызов действия из темы
Вы можете вызвать действие явно из тема, аналогично вызову других типов действий, таких как потоки Power Automate. В зависимости от вашего варианта использования вы можете использовать свой поток как часть более широкой темы, которая использует больше узлов. Или, как в примере с погодой, все, что нужно сделать, это добавить один узел действия в тему.
Чтобы вызвать действие из темы:
В Copilot Studio перейдите на страницу Темы для помощника, которого вы хотите редактировать.
Создайте новую тему и назовите ее Получить погоду.
Добавьте следующие триггерные фразы:
- будет ли дождь
- прогноз на сегодня
- получить погоду
- какая погода
Выберите Добавить узел (+), затем выберите Вызвать действие. Перейдите на вкладку Действия подключаемого модуля (предварительная версия), затем выберите действие, созданное вами ранее, Получить прогноз погоды.
Ваш узел Действие подключаемого модуля (предварительная версия) теперь добавлен в вашу тему.
Выберите Сохранить.
Переопределение входных данных при вызове действия из темы
По умолчанию, когда ваше действие выполняется, ваш помощник генерирует вопросы для пользователя, чтобы заполнить необходимые входные данные. Однако вам может потребоваться переопределить один или несколько элементов входных данных и указать явное значение, а не спрашивать его у пользователя. Вы можете переопределить конфигурацию действия подключаемого модуля в разделе Входные данные. Или вы можете переопределить значения только тогда, когда ваше действие используется из определенной темы:
Выберите Установить значение на узле и выберите входные данные, которые вы хотите переопределить.
Введите значение для ввода, введя значение, выбрав переменную или используя формулу.
Теперь, когда этот элемент входных данных переопределен, помощник не запрашивает значение у пользователя.
Включение проверки подлинности для действий ИИ
Некоторые действия, созданные на основе действий ИИ, для правильной работы требуют аутентификации, например динамический запрос или другие, которые вызывают API Dataverse.
Действия всегда выполняются во время выполнения Microsoft Copilot в контексте конечного пользователя и не могут быть выполнены, если не включена аутентификация. Поддерживается два типа способов проверки подлинности:
Перейдите в свойства действия соединителя.
В разделе Аутентификация конечного пользователя выберите Аутентификация автора помощника.
Опубликуйте и протестируйте интерфейс на панели тестирования помощника или в нужном канале.
Использование действий потока с учетными данными конечного пользователя
Действия потока можно настроить на использование учетных данных конечного пользователя. Если вы используете поток в поддерживаемом канале, это не требует специальной настройки в диалоговом окне помощника, и конечные пользователи могут управлять своими подключениями для данного потока в предоставленном интерфейсе.
Аутентификация для действий на основе подключаемых модулей в вашей библиотеке
При создании на основе подключаемых модулей ИИ для корректной работы действий требуется аутентификация. Чаще всего это наблюдается при действиях, основанных на запросах или других действиях, вызывающих API-интерфейсы Dataverse. Действия, основанные на подключаемых модулях, всегда выполняются в контексте конечного пользователя и не могут быть выполнены, если не включена аутентификация. Поддерживается два типа способов проверки подлинности:
Встроенная аутентификация (Teams и Power Apps): вы можете использовать этот метод аутентификации, если хотите опубликовать своего помощника в канале Teams. Этот метод также работает для помощников, встроенных в любое приложение Power Platform, использующее токены, созданные по стандарту PPAPI.
Ручная аутентификация (сторонние помощники): этот метод аутентификации включает в себя настройку подключения Microsoft Entra ID.
Чтобы создать подключение для проверки подлинности вручную:
Настройка приложения Microsoft Entra ID.
Настройка аутентификации вручную для вашего помощника Copilot Studio.
Разрешите своему приложению использовать делегирование для получения токена от имени пользователя. Не забудьте добавить области видимости, если они необходимы.
