Расширение Microsoft 365 Copilot с использованием агентов

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

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

Вы можете добавить агентов в Microsoft 365 Copilot двумя способами:

  • Пользовательские агенты
  • Агенты для Microsoft 365 Copilot

Заметка

Агенты для Microsoft 365 Copilot называются декларативными агентами в Microsoft 365 Copilot. Узнайте больше о Microsoft 365 Copilot расширяемости.

В этой статье рассматриваются следующие вопросы:

  • Разработка пользовательского агента
  • Создание агента для Microsoft 365 Copilot
  • Добавление инструментов и знаний в агента
  • Публикация пользовательского агента в Microsoft 365 Copilot и Microsoft Teams

Что такое агенты для Microsoft 365 Copilot, инструменты, знания и рекомендуемые подсказки?

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

Полное имя Определение
Настраиваемый агент Кастомный агент — это агент, которого вы создаёте с нуля. Пользовательский агент может включать широкий спектр возможностей, включая знания, инструменты и рекомендуемые запросы. Вы создаёте пользовательских агентов в разговорном интерфейсе, который генерирует подсказки для модели Copilot Studio. Вы можете публиковать пользовательские агенты для канала Microsoft 365 Copilot и Teams, но также можете использовать их с другими каналами.
Агент для Microsoft 365 Copilot Вы создаёте агент для использования в Microsoft 365 Copilot, создав запрос для Microsoft 365 Copilot. Этот запрос определяет набор поведения, личностей и правил во время выполнения, регулирующих взаимодействия агента. Copilot agent эквивалентен декларативному агенту, созданному в Microsoft 365 Copilot. Агент Microsoft 365 Copilot расширяет Microsoft 365 Copilot, и вы можете оснастить его инструментами и знаниями. Эти агенты также могут использоваться напрямую в качестве агентов в Microsoft Teams.
инструмент Механизм, позволяющий агенту обращаться к другим системам и извлекать данные или выполнять другие действия. Инструменты — это взаимодействие за один ход. Инструменты могут использовать аутентификацию, а также включать параметры и другие функции. См. Добавить инструменты к пользовательским агентам.
База знаний Под знаниями понимается информация, которая находится внутри вашего клиента Microsoft 365, включая соединители SharePoint и Graph.
Предлагаемый запрос Рекомендуемые подсказки — это промпты, созданные создателем в агенте, которые облегчают клиентам выполнение обычных или сложных действий с агентом.

Обеспечение безопасности агентов

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

Чтобы защитить вашего агента от злоумышленников, используйте элементы управления в Copilot Studio to configure защищённые коннекторы, используемые для знаний и кастомных инструментов.

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

  • Пользователи и создатели должны иметь лицензию на использование Microsoft 365 Copilot.
  • Создатели должны иметь разрешения на создание и доступ к среде Copilot Studio.

Создание и настройка пользовательского агента

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

Создать агент для Microsoft 365 Copilot

Создание агентов для Microsoft 365 Copilot в Copilot Studio похоже на создание кастомных агентов, но отправная точка отличается: вы начинаете со страницы Microsoft 365 Copilot.

Чтобы создать агент для Microsoft 365 Copilot:

  1. В боковой панели выберите Агенты.

  2. Выберите Microsoft 365 Copilot в списке агентов.

  3. Выберите добавить на карту агентов . Появляется форма конфигурации.

  4. Настройте основные функции агента:

    • Замените имя по умолчанию на представительное. Максимальная длина названия — 42 символа. Название не должно включать угловые скобки (< и >).
    • Если хотите, замените иконку по умолчанию. Файл изображения для иконки агента должен быть в формате PNG и иметь размер менее 72 КБ.
    • Введите краткое описание того, что вы хотите, чтобы ваш агент сделал.
    • Дайте более подробные инструкции для поведения вашего агента и перечислите задачи, которые он может выполнить.
  5. По желанию добавьте рекомендуемые запросы и источники знаний.

  6. Включите веб-серфинг , если хотите позволить агенту использовать публичный веб-поиск (через Bing) для получения результатов.

  7. По завершении нажмите Создать. Появляется обзорная страница агента.

Агент теперь создан. Вы можете взаимодействовать с ним в тестовом чате или добавить больше возможностей и знаний.

Вы можете увидеть нового агента во вкладке Agents на странице агента Microsoft 365 Copilot. Поскольку агент не является пользовательским агентом, он не отображается в основном списке агентов.

Добавьте знания агенту для Microsoft 365 Copilot

Вы можете добавить три основных типа знаний агенту для Microsoft 365 Copilot:

Полное имя Определение
SharePoint Пути к ресурсам SharePoint в организации. Microsoft 365 Copilot использует учетные данные пользователя, чтобы гарантировать получение ответов только из имеющейся у него информации.
Соединители для Copilot (Graph) Коннекторы — это источники данных, настроенные администратором арендатора для добавления знаний в Microsoft 365 Copilot и агентов. Узнайте больше в обзоре Microsoft 365 Copilot разъёмов.
Веб-серфинг Агент также может использовать публичный веб-поиск (через Bing) для получения веб-результатов.

Заметка

Веб-серфинг настроен на странице обзора.

Чтобы добавить знания агенту:

  1. Вернитесь на страницу обзора агента.

  2. На карте знаний выберите «Добавить знания».

  3. Выберите источник данных.

    • Если вы используете SharePoint, укажите путь к корню библиотеки или сайта. Указание одной страницы или файла не поддерживается.
    • Если вы используете Copilot connector, а администратор настроил Copilot connector в Microsoft 365, вы можете выбрать Copilot connector из настроенных источников данных.
    • Вы можете предотвратить поиск вашего агента в интернете или разрешить это, включив или отключив веб-сёрфинг на обзорной странице агента.

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

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

Заметка

Если результаты не возвращаются, отправьте отзыв в Microsoft для анализа и улучшения продукта.

Добавьте инструмент в агент для Microsoft 365 Copilot

Используйте инструмент, позволяющий агенту получать информацию или выполнять задачу, например, обновлять запись или выполнять транзакцию. Вы можете создавать инструменты из разъёмов (также известных как разъёмы Power Platform). Типы инструментов включают подсказки, готовые разъёмы и кастомные разъёмы. Дополнительные сведения см. в разделе "Добавление инструментов в настраиваемые агенты".

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

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

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

Чтобы добавить инструмент:

  1. Вернитесь на страницу обзора вашего агента.

  2. На карте «Инструменты » выберите « Добавить инструмент».

  3. Найдите нужный инструмент или выберите нужную опцию в разделе «Создать новое».

    Если вы хотите создать новый инструмент, доступны следующие варианты:

    • Prompt
    • Поток агента
    • Использование компьютера
    • Настраиваемый соединитель
    • Протокол контекста модели
    • REST API

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

Просмотр и обновление конфигураций инструментов

После создания инструмента он появляется в списке инструментов на странице обзора. Выберите инструмент для просмотра и редактирования его конфигурации. Опыт конфигурации инструментов состоит из трёх разделов:

  • Сведения
  • Входные данные
  • Completion

Раздел сведений

Используйте раздел «Детали » для настройки имени инструмента, отображения и описания.

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

Входные данные и разделы завершения

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

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

Протестируйте свой инструмент

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

В первый раз, когда вы запускаете инструмент, агент показывает карту подключения в чате. Эта карта предлагает войти в инструмент с помощью собственных учетных данных или использовать учетные данные Single Sign-on (SSO), если это применимо.

Рекомендуемые запросы

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

Вы можете редактировать предлагаемые задания или создавать свои собственные в любое время из раздела «Рекомендуемые подсказки » на странице обзора.

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

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

Публикация пользовательского агента в канале Teams + Microsoft 365

Вы также можете расширить Microsoft 365 Copilot с помощью пользовательского агента, опубликовав агент в канале Teams + Microsoft 365. Дополнительные сведения см. в подключении и настройке агента для Teams и Microsoft 365.

Публикация агента для Microsoft 365 Copilot

Когда агент работает так, как вы ожидаете в тестовом опыте Copilot Studio, вы готовы к публикации. После публикации агент Microsoft 365 Copilot готов загрузить его в каталог организации. В отличие от отдельного агента, агент для Microsoft 365 Copilot не развёртывается автоматически в Microsoft 365 Copilot и Teams после публикации.

Опубликуйте своего агента для Microsoft 365 Copilot

  1. Вернитесь на страницу обзора агента.

  2. Выберите «Опубликовать » в правом верхнем углу.

    Информация в следующей форме заполняет запись каталога в каталогах Office и Teams вашей организации, а также в списке интегрированных приложений Microsoft Admin Center. Языковая модель Microsoft 365 Copilot не использует эту информацию.

  3. Заполните требуемым образом следующие поля и выберите Опубликовать.

    После завершения операции появляется страница опций доступности .

Заметка

При выборе Опубликовать ресурс бота подготавливается в среде Microsoft Entra ID вашего клиента, соответствующей агенту Copilot. Ресурс позволяет пользователям взаимодействовать с агентом в Microsoft Teams.

Задание параметров доступности

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

Заметка

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

Параметр доступности Description
Поделиться ссылкой Вы можете скопировать прямую ссылку в Microsoft Teams, чтобы вызвать опубликованный агент. Открытие ссылки в клиенте открывает интерфейс чата с агентом.
Показывать моим коллегам и пользователям, которым предоставлен доступ Предоставьте доступ другим для участия в создании агента или группам безопасности для использования агента в Microsoft 365 Chat или Teams.
Показывать всем в моей организации Отправьте администратору клиента запрос на добавление в организационный каталог, чтобы все пользователи клиента могли установить его по своему желанию.
Загрузить как ZIP-файл Скачайте как ZIP-папку. Этот параметр доступности позволяет вам вручную отправлять данные в Teams/Microsoft 365 Copilot, чтобы отправить администратору на проверку, или отправлять их непосредственно в каталог организации.

Для получения дополнительной информации об управлении приложениями в каталоге Teams см. раздел «Управление приложениями Power Platform».

Используйте агент в Microsoft 365 Copilot или Microsoft Teams

Вы можете попробовать агента в Microsoft 365 Copilot или Teams. Взаимодействуйте с агентом, используя либо @mentioning агента в интерфейсе чата Microsoft 365 Copilot, либо выбрав агента в боковой панели. После выбора агента вы взаимодействуете только с ним, пока не завершите этот разговор и не вернётесь в Copilot или Teams.

Советы авторам агентов

  • Microsoft 365 Copilot кэширует ответы на ранее заданные вопросы в данной сессии, даже если вызывает инструмент для извлечения данных. Чтобы взломать этот кэш, используйте значок «Начать новую тестовую сессию » в верхней части тестового чата.
  • Чтобы узнать, почему генеративный ИИ выбирает или не выбирает инструмент, введите - developer on в чате и задайте вопрос.
  • Результаты, которые вы видите во время выполнения в Microsoft 365 Copilot, могут отличаться от тестовых панелей Copilot Studio и Microsoft Teams.
  • В отличие от кастомных агентов, Copilot агенты не собирают данные для страницы Copilot Studio Analytics.
  • Используя Microsoft 365 Copilot для тестирования вашего агента, используйте опыт обратной связи для получения обратной связи команде Microsoft Copilot. Обратная связь напрямую не влияет на качество запуска Microsoft 365 Copilot.