Поделиться через

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

  • Статья

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

В Microsoft Copilot Studio эти более специализированные помощники называются агентами помощника. Эти помощники создаются путем предоставления инструкций на естественном языке, которые генерируют запросы для большой языковой модели (LLM) в Copilot для Microsoft 365. Агенты могут включать ссылки на корпоративные данные, действия и предлагаемые запросы.

Заметка

То, что называется агентами помощника в Copilot Studio, называется агентами в Copilot для Microsoft 365. Дополнительные сведения о расширяемости Copilot для Microsoft 365 см. в разделе Расширяемость Microsoft 365 Copilot.

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

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

Что такое агенты помощника, действия, знания помощника и начальные запросы?

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

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

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

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

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

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

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

Создание агента

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

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

  1. Войдите в учетную запись Copilot Studio по адресу https://copilotstudio.microsoft.com

  2. Перейдите к пункту Помощники в левой навигационной панели.

  3. Выберите Microsoft 365 Copilot в списке помощников.

  4. Отсюда выберите + Добавить в карточке Агенты. Вы будете перенаправлены в интерфейс разговорной разработки.

  5. Опишите полными предложениями, что должен уметь и знать агент.

  6. Когда взаимодействие будет завершено, выберите Я закончил в чате.

    Заметка

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

  7. Выберите Создать, чтобы перейти на страницу обзора агента.

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

Добавление знаний в агент

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

Существует три основных типа знаний, которые можно добавить в агент:

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

Заметка

Веб-поиск настраивается с помощью возможностей карточки на странице обзора, а не на странице знаний.

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

  1. Вернитесь на страницу обзора агента.
  2. На карточке Знания выберите + Добавить знания.
  3. Выбор источника данных.
    • Если вы используете SharePoint, укажите путь к корню библиотеки или сайта. В настоящее время указание одной страницы или файла не поддерживается.
    • Если вы используете соединитель помощника и администратор настроил соединитель Graph в Microsoft 365, вы можете выбрать соединитель Graph из настроенных источников данных.
    • Веб-поиск можно включить/отключить на странице обзора помощника на карточке Дополнительные настройки.

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

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

Заметка

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

Добавление действия в агент

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

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

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

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

Снимок экрана панели действий

Для добавления действий:

  1. Вернитесь на страницу обзора агента.
  2. На карточке Действия выберите Добавить действие.
  3. Найдите нужный соединитель помощника или выберите Создать новый поток или Добавить API для пользовательского соединителя.
  4. Если выбран соединитель помощника, опыт пользователя будет представлен с разделами Соединитель и Настройка.

Раздел соединителя

  1. Аутентификация конечного пользователя: выберите тип аутентификации, предпочтительный для этого действия. У вас есть выбор между аутентификацией пользователя и аутентификацией создателя помощника. Другие детали конфигурации аутентификации автоматически обрабатываются реализацией соединителя помощника.
  2. Описание использования: инструкции, сообщающие модели LLM Copilot для Microsoft 365, как использовать действие в агенте.

Раздел конфигурации

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

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

Copilot Studio автоматически заполняет набор входных и выходных данных, проверяя объект соединителя помощника. Создатель может позволить модели LLM Copilot для Microsoft 365 заполнить эти поля или заполнить их вручную в процессе разработки.

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

Снимок экрана панели редактирования входных данных действий

Завершение и тестирование

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

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

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

Снимок экрана настройки карточки подключений

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

Важно

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

Начальные запросы

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

Снимок экрана начальных запросов в чате Copilot для Microsoft 365

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

Общие сведения о начальных запросах

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

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

Снимок экрана предложений начальных запросов

Разработка начальных запросов

  1. Вернитесь на страницу Обзор агента.
  2. Прокрутите вниз до раздела Начальные запросы и выберите Изменить.
  3. Добавьте до шести начальных запросов и нажмите «Сохранить».

Публикация агента

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

Публикация агента

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

  2. Выбирать Опубликовать справа вверху.

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

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

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

Заметка

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

Параметры доступности

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

Заметка

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

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

Более подробную информацию об управлении приложениями в каталоге Teams можно найти здесь: Управление приложениями Power Platform

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

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

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

Снимок экрана использования агента в Copilot для Microsoft 365

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

  • Copilot для Microsoft 365 кэширует ответы на ранее заданные вопросы в данном сеансе, даже если он вызвал действие для извлечения данных. Чтобы очистить этот кэш, используйте кнопку Создать чат.
  • Чтобы получить дополнительную информацию о том, почему большая языковая модель выбирает или не выбирает действие, введите -developer on в поле ввода Copilot для Microsoft 365 и задайте вопрос.
  • Результаты, которые вы видите во время выполнения в Copilot для Microsoft 365, могут отличаться от того, что вы видите в тестовом холсте Copilot Studio и в Microsoft Teams.
  • В отличие от пользовательских помощников, агенты не собирают данные на вкладке "Аналитика Copilot Studio". Эта функция оценивается для будущих выпусков.
  • При использовании Microsoft 365 Copilot для тестирования агента используйте функцию обратной связи с большим пальцем вниз, чтобы предоставить отзыв команде Microsoft Copilot для рассмотрения и устранения проблем. Обратная связь напрямую не влияет на качество запуска Copilot для Microsoft 365.