Обзор соединителей и действий помощников (предварительная версия)

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

Как это работает?

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

Создатель начинает с выбора помощника, функции которого он хочет расширить:

• Таможенные агенты
• Microsoft 365 Copilot и агенты Copilot
• Другие помощники, к которым у них есть доступ создателя в их организации

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

Просмотреть существующие действия для агент

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

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

Отобразится список доступных действий.

Создание собственного нового действия

Вы также можете создавать свои собственные новые действия.

Шаги зависят от типа агент:

• Пользовательский агент: Выберите + Добавить действие.
• агент Copilot: Выберите + Добавить действие.

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

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

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

Copilot Studio предлагает несколько способов сделать процесс расширения простым и всеобъемлющими, в том числе:

• Создание: создание расширения для агент, которое приведет к созданию действия.
• Тестирование: проверьте, работает ли действие с вашим агент, протестировав его во время или после процесса публикации.
• Редактирование: сохраняйте проекты выполняемых действий или редактируйте действия и публикуйте результаты для использования.
• Экспорт/импорт: возьмите существующие завершенные действия и распространите их среди других организаций внутри вашей компании или среди своих клиентов, если вы являетесь независимым поставщиком программного обеспечения. Вы также можете экспортировать пакет, который будет отправлен на сертификацию в Microsoft, чтобы сделать ваше действие доступным в онлайн-каталоге.
• Обратная связь: Сообщите пользователям, что они собираются внести изменения в данные, и спросите разрешение, прежде чем предпринимать какие-либо действия, предоставьте хэштег карточка для удобного отображения результатов, предоставьте примеры вопросов, которые пользователи могут задать, агент.
• Фирменная символика: предоставьте значки и информацию о фирменной символике вашего действия в целях его распространения.

Заметка

Microsoft 365 Copilot также можно расширить с помощью агентовCopilot.

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

После публикации действия ваш агент Администратор должен рассмотреть и разрешить использование плагина. Когда Администратор включает агент, необходимо также определить, какие группы пользователей имеют разрешение на его использование. Расположение управления разрешениями может отличаться в зависимости от агент. Дополнительную информацию можно найти в документации по администрированию. После активации подключаемый модуль появляется в среде, в которой он был создан. Плагин также можно экспортировать для использования в других агентах. При экспорте создается пакет, который можно развернуть в других средах. Таким образом, вам не нужно повторно создавать действие для каждой среды, в которой вы хотите его использовать.

Более подробную информацию об импорте и экспорте действий можно найти в разделе Экспорт решений.

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

Дополнительные сведения о сертификации см. в следующих документах:

• Процесс сертификации проверенных издателей
• Отправка соединителя на сертификацию Майкрософт

Расширьте пользовательский агент с помощью действия

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

Расширьте агент Copilot с помощью действия

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

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

Мастер просит вас:

• Выберите тип обработчика/источника, который нужно использовать
• При необходимости укажите данные аутентификации для выбранного вами типа обработчика/источника
• Выберите действия компонента, которые вы хотите добавить в действие
• Определите входные и выходные параметры для каждого действия компонента
• Предоставьте другие расширенные возможности, такие как:
  • Диалоги согласия пользователей
  • Адаптивные карточки для отображения ваших результатов и начальных вопросов для разговора
  • Информация о фирменной символике для сертификации

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

Компоненты действия

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

• Обработчики и источники контента
• Аутентификация
• Действия компонента
• Входные и выходные данные
• Расширенные функции (согласие пользователя, начало разговора, адаптивные карты, фирменная символика, управление решениями)

Обработчики и источники контента — типы действий

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

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

• Соединители: действия соединителя используются внутри Microsoft Dataverse для подключения к другим источникам данных. При создании соединитель включает в себя определенные действия компонента, которые можно использовать с соединителем. Можно использовать соединители, сертифицированные Microsoft, или пользовательские соединители, созданные в организации или клиенте. Пользовательские соединители позволяют вашему подключаемому модулю получать и обновлять данные из внешних источников, доступных через API-интерфейсы. Соединители позволяют получать доступ к данным из популярных корпоративных систем, таких как Salesforce, Zendesk, MailChimp и GitHub. Соединители регулярно используются создателями в их Power Apps и потоках.

• Потоки: Microsoft Power Automate облачные потоки можно вызывать из агент для выполнения действий, извлечения информации и автоматизации процессов в других приложениях и источниках данных с помощью коннекторов. Потоки можно вызывать из чата Microsoft 365 Copilot для выполнения действий или получения информации в среде конечного пользователя.

• Запросы: запросы — это шаблоны запросов искусственного интеллекта, созданные для настройки генерации текстового содержимого в соответствии с вводом пользователя. Эти шаблоны можно использовать для различных сценариев, таких как обобщение, элементы действий, извлечение настроений или сущностей, перевод текста и многое другое. Кроме того, вы можете добавлять свои собственные данные Dataverse, чтобы дополнить источники знаний и получить ответы, специфичные для бизнеса. Запросы позволяют пользователям использовать естественный, простой язык для получения ответов и выполнения действий с помощью Microsoft Copilot. Они используют понимание естественного языка (NLU), чтобы понять намерения пользователя и сопоставить их с соответствующим фрагментом информации, данными или действием.

Не все типы действий доступны для каждого агент Copilot под брендом Microsoft:

Функция	Microsoft 365 Copilot	Microsoft 365 Copilot для продаж	Microsoft 365 Copilot для обслуживания клиентов
Разговорный	На месте	Недоступно	Недоступно
Connector	На месте	На месте	На месте
Приглашение	На месте	Недоступно	На месте
Поток	На месте	Недоступно	Недоступно

Вы создаете и настраиваете действия в Copilot Studio. Вы также можете создавать и редактировать некоторые типы действий в Power Apps. Подробнее см. в разделе Создание подсказки (предварительная версия) в Power Automate или Power Apps.

Аутентификация

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

Ниже приведено несколько примеров:

• Без аутентификации: соединитель MSN Weather. Это действие соединителя получает только общедоступные данные о погоде и не имеет защищенного контента. В результате соединитель погоды можно использовать без предоставления учетных данных.
• Действия потока: облачные потоки используют подключение и параметры подключения, настроенные во время создания.
• Действия соединителя: если вы используете соединитель для доступа к вашему источнику данных, в соединитель встроен способ проверки подлинности. Вам не требуется настраивать его при установке, но вам нужно будет обаятельно предоставить учетные данные перед тестированием или использованием соединения.
• Действие запроса: использует ваши личные данные Teams или Power Apps. Обязательно поделитесь запросом с соответствующими пользователями или группами.
• Разговорные действия: разговорные действия не требуют собственной аутентификации. Однако разговорное действие можно использовать для вызова действия соединителя, и в этом случае запускается механизм аутентификации соединителя.

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

• Извлечь список пользователей
• Добавить нового пользователя
• Обновить данные пользователя
• Удаление пользователя

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

Заметка

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

Входные и выходные данные

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

Улучшенные функции

Расширенные функции доступны при настройке расширений для некоторых типов агент.

Улучшенные функции включают:

• Решения
• Согласие пользователя
• Варианты начала разговора
• Адаптивные карточки
• Тестирование

Не все расширенные функции доступны в каждом типе агент.

Решения

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

Узнайте больше о решениях в разделе Основы управления жизненным циклом приложений (ALM) с Microsoft Power Platform.

Согласие пользователя

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

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

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

Варианты начала разговора

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

Адаптивные карточки

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

Адаптивные карточки бывают двух типов:

• По умолчанию: базовая адаптивная карточка, которая может иметь заголовок, подзаголовок, текст и кнопку, которая направляет пользователя на URL-адрес. Это обеспечивает более стилизованный вид и призыв к действию.
• Пользовательские: пользовательские адаптивные карты создаются вне мастера и могут быть отправлены для включения в подключаемый модуль. Эти карточки более настраиваемы и могут иметь несколько полей, несколько кнопок и другие параметры. Вы можете создать пользовательскую карточку в конструкторе адаптивных карточек и экспортировать ее в виде файла для отправки.

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

На каждой адаптивной карточке отображаются возвращаемые значения, а затем перечисляются ссылки, использованные при компиляции результата. Адаптивные карточки также позволяют пользователю указать макет эталонного представления. Именно так отображаются ссылки, используемые в запросе, для получения дополнительной информации. Может отображаться заголовок, URL-адрес и подзаголовок. Это также раскрывающиеся списки, которые можно заполнить в зависимости от выбора корневого пути.

Заметка

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

Тестирование

Что касается действий соединителя, создатель может протестировать новый подключаемый модуль внутри Microsoft 365, загрузив неопубликованный подключаемый модуль. Этот параметр отображается на экране обзора действия. Пользователю будет предложено выбрать или создать соединение, а затем создать тестовую версию подключаемого модуля с загрузкой неопубликованного приложения, доступную в среде Microsoft 365. Эта тестовая версия не отображается извне и не публикуется для утверждения администратором. Она доступна только автору для проверки того, что подключаемый модуль работает должным образом.

Используйте действия в Microsoft 365 Copilot

Конечные пользователи вашего клиента могут использовать диалоговые действия и действия ИИ в своих чатах с помощью Microsoft 365 Copilot, если:

• Ваш администратор клиента Microsoft 365 развернул приложение Copilot Studio в центре администрирования Microsoft 365.
• Ваш Power Platform администратор среды включил настройку "Microsoft 365 Copilot" в Power Platform центре администрирования
• Конечный пользователь включает соединение из своего чата с Microsoft 365 Copilot.

Развертывание приложения Copilot Studio в центре администрирования Microsoft 365 (администратор)

1. Войдите в центр администрирования Microsoft 365 с учетными данными администратора.
2. Разверните Настройки на боковой панели навигации и выберите Интегрированные приложения.
3. Перейдите на вкладку Доступные приложения и выберите запись Microsoft Copilot Studio. Открывается панель сведений о приложении.
4. Выбирать Развертывать чтобы включить приложение в чатах с Microsoft 365 Copilot.

Администраторы клиента могут включать или отключать:

• Показ действий разговорного ИИ/темы и действий запросов в приложении чата Microsoft 365 с помощью приложения "Copilot Studio".
• Показ действий потока в приложении чата Microsoft 365 с помощью приложения "Power Automate".
• Действия соединителя и действия API в приложении чата Microsoft 365 с использованием связанных приложений (имя приложения будет именем соединителя или действия). Кроме того, в магазине Teams пользователи могут установить настраиваемые действия соединителя.

Включить или отключить Microsoft 365 Copilot в Power Platform центре администрирования (admin)

1. Перейдите в центр администрирования Power Platform и войдите в систему с учетными данными администратора.
2. Перейдите в раздел Среды, а затем выберите среду из списка.
3. Выберите Параметры.
4. В разделе Продукт выберите Функции
5. Найдите параметр для Microsoft 365 Copilot и переведите переключатель в положение Вкл. (или Выкл.), чтобы разрешить интеграцию агентов Copilot из этой среды.
6. Прокрутите вниз и выберите Сохранить.

Важно

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

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

Включение подключения в Microsoft Copilot

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

Они могут попасть на портал, спросив о плагинах в своем чате с помощью Microsoft 365 Copilot. Они получают краткую информацию о подключаемых модулях и ссылку на портал:

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

• Как я могу использовать подключаемый модуль?
• Расскажите мне о подключаемых модулях Copilot в Power Platform
• Как я могу получить данные из внешней системы?
• Как я могу получить данные из Salesforce?

Действия предоставления общего доступа

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

Однако автор действия может поделиться своими подключаемыми модулями на портале, где он их создал. Например, вы можете поделиться запросом AI Builder со страницы Запросы ИИ, выбрав Поделиться для подсказки. То же самое относится к потокам Power Automate (со страницы Потоки в Power Automate) или к пользовательским соединителям со страницы Пользовательские соединители.

Связанный контент

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