Создание действий разговоров для Microsoft Copilot

Заметка

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

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

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

Важно

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

Что такое разговорное действие и как оно работает?

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

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

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

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

• Конечные пользователи должны иметь лицензию на использование Copilot для Microsoft 365.
• Ваш арендатор Power Platform должен быть настроен на включение публикации действий, как описано в статье по Copilot для Microsoft 365 Создание подключаемых модулей с помощью бизнес-приложений Microsoft Business Applications.
• Администратору клиента Microsoft 365 необходимо включить категорию "Интегрированные приложения Microsoft Copilot Studio" в Центре администрирования Microsoft.

Заметка

Эта плитка в Центре администрирования Microsoft ранее называлась Dynamics 365 и Microsoft Copilot Studio и была разделена на две части: Dynamics 365 и Microsoft Copilot Studio. Только последняя необходима для работы этой функции.

Важно

В этом выпуске есть некоторые ограничения:

• Ваш тема не сможет взаимодействовать (задавать вопросы) с пользователем, а может только обрабатывать входящий запрос от пользователя (в переменной Действие.Текст) и отправлять ответ.
• Ответы будут ограничены текстом. Мультимедиа или адаптивные карточки поддерживаться не будут.
• В этой предварительной версии Copilot Studio не удается аутентифицировать пользователя, поэтому источники генеративных ответов SharePoint не будут работать.
• Этот выпуск предназначен только для англоязычных помощников.
• Все пользователи Copilot внутри вашей организации смогут взаимодействовать с действием, действие не будет поддерживать авторизацию самого пользователя.
• По умолчанию интеграция Copilot Studio с Copilot включена. Это означает, что действия, созданные в Copilot Studio, будут отображаться для пользователей в «Copilot Studio» или «Power Automate», даже если администраторы арендатора явно не развернули приложение для конечных пользователей. Это может измениться в будущем.

Администратор всегда может заблокировать показ действий для своих пользователей, заблокировав приложение в центре администрирования Microsoft 365.

Создание базового разговорного действия для публикации в Microsoft Copilot

Ваша тема при запуске в чате Copilot использует системную переменную Activity.Text в качестве входных данных. Действие.Текст представляет вопрос пользователя. Чат обрабатывает текст вопроса, — например, передавая его в генеративные ответы, — а затем возвращает результат в виде одного или нескольких сообщений. Эти сообщения могут включать ответ, который приходит из генеративных ответов, или сообщения из узлов сообщений. Несколько сообщений могут быть включены и отправлены отдельно для формирования выходных данных.

Следующие шаги помогут вам создать новое разговорное действие внутри Copilot Studio. Вы создаете базовые возможности и публикуете их в центре администрирования.

1. В боковой области переходов выберите Помощники.

2. Выберите интерфейс Copilot, который вы хотите расширить. Появится страница Обзор для конкретного Copilot.

3. Перейдите на вкладку Действия.

4. Выберите + Добавить действие. Появится меню доступных типов действий.

5. Выберите Создать действие. Вам будет представлено меню доступных типов действий для нового действия.

   

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

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

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

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

Пример уточнения разговорного действия

Давайте рассмотрим пример уточнения разговорного действия.

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

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

Для этого примера давайте воспользуемся узлом генеративных ответов для поиска веб-контента на указанном веб-сайте и предоставления ответа пользователю в Copilot.

1. Выберите Изменить темы в разделе Уточнить для редактирования вашего разговорного действия.

   

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

   

2. Прежде чем продолжить разработку, установите имя темы на верхней панели над холстом разработки. Это имя видно пользователю и администратору в Copilot и центре администрирования Microsoft 365, соответственно.

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

4. Чтобы добавить узел генеративных ответов, выберите плюс на холсте под узлом Триггер, затем выберите Генеративные ответы на вкладке Дополнительно всплывающего меню.

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

6. Выберите системную переменную Действие.Текст, которая представляет последний запрос пользователя к Microsoft 365 Copilot. Этот запрос был тем, что задал пользователь в чате Microsoft 365, и что заставило Copilot вызвать действие.

7. Выберите редактор Источники данных в центре плитки Создать генеративные ответы. Откроется окно настройки Создать свойства генеративных ответов.

8. В разделах Классические данные и Источники данных в поле Общедоступные веб-сайты введите ссылку на общедоступный веб-сайт, на котором есть контент, который вы хотите использовать для своего помощника. Этот веб-контент используется для ответа на вопросы пользователей. Альтернативно, в разделе Источники знаний выберите + Добавить знания, чтобы открыть диалог Добавить доступные источники знаний, чтобы добавить туда общедоступный веб-сайт. Дополнительную информацию по добавлению базы знаний см. в разделе Добавление базы знаний в существующий помощник.

   Заметка

   Источником контента должен быть общедоступный веб-сайт. Убедитесь, что Bing может найти и проиндексировать этот сайт.

9. После добавления ссылки (не забудьте нажать «+» после ввода URL-адреса) закройте панель свойств.

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

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

12. Наконец, выберите Сохранить, чтобы сохранить разговорное действие.

Публикация вашего разговорного действия в Copilot

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

В Copilot ваше разговорное действие помечается как Имя диалогового действия в библиотеке. Учитывая это, обязательно выбирайте название разговорного действия так, чтобы оно было легко читаемым.

Для публикации вашего разговорного действия:

1. Сначала создайте, измените и сохраните разговорное действие, как описано в предыдущих разделах.

2. На странице Обзор действия выберите Опубликовать.

3. Выберите Опубликовать. Появится сообщение с предложением подтвердить свое намерение.

4. Наконец, выберите Опубликовать еще раз. Публикация должна завершиться быстро. Для фактической доступности в центре администрирования Microsoft 365 может потребоваться несколько минут. При возникновении ошибки повторите попытку. Если ошибка не исчезнет, отправьте запрос в службу поддержки в центре администрирования Power Platform.

5. Ваш администратор может найти интегрированное приложение Copilot Studio в Центре администрирования Microsoft 365 в разделе Параметры, затем Интегрированные приложения. Развертывание/блокировка возможны только на уровне этой категории.

   Важно

   В этом выпуске по умолчанию интеграция Copilot Studio с Copilot включена. Это означает, что действия, созданные в Copilot Studio, будут отображаться для пользователей в «Copilot Studio» или «Power Automate», даже если администраторы арендатора явно не развернули приложение для конечных пользователей. Это может измениться в будущем.

   Администратор всегда может отключить показ разговорных действий для своих пользователей, заблокировав приложение в центре администрирования Microsoft 365.

6. После того как администратор вашего клиента одобрит интегрированное приложение, оно должно появиться в списке действий пользователя в его пользовательском интерфейсе Copilot.

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

Заметка

Чтобы удалить диалоговое действие из каталога, в сведениях о диалоговом действии снимите флажок Состояние, сохраните диалоговое действие, затем повторно опубликуйте его, при этом оно будет удален из реестра Dataverse и каталога приложений Microsoft Copilot.

Рекомендации

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

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