Общие сведения об агентах пользовательского обработчика для Microsoft 365

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

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

Что такое пользовательский агент обработчика?

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

Структура пользовательского агента обработчика Microsoft 365 Copilot

Ключевые характеристики агентов пользовательского обработчика

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

  • Настраиваемая оркестрация . Определите специализированные рабочие процессы и подключитесь к внешним системам для внедрения дополнительных знаний или вызова действий.
  • Гибкие модели ИИ . Выберите один из базовых моделей, точно настроенных моделей или отраслевого ИИ в соответствии с вашим вариантом использования.
  • Упреждающая автоматизация — программная активация рабочих процессов и выполнение действий в корпоративных приложениях.

Подходы к разработке для пользовательских агентов обработчика

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

Подход с низким уровнем кода

Так как Copilot Studio — это полностью управляемая платформа SaaS, которая упрощает создание пользовательских агентов обработчика, вы можете сосредоточиться на создании эффективного взаимодействия с агентами, не беспокоясь об инфраструктуре, размещении или управлении. Он предлагает встроенное соответствие требованиям через Microsoft Power Platform, а также готовые шаблоны и соединители для Microsoft 365 и партнерских служб. Хотя он поддерживает разработку с низким уровнем кода, реальная ценность заключается в упрощенном развертывании и управлении.

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

Профессиональный подход к коду

Для разработки программного кода используйте Visual Studio или Visual Studio Code с расширением Microsoft 365 Agents Toolkit. Этот набор средств упрощает разработку агентов, предоставляя готовые шаблоны, простую отладку и упрощенные рабочие процессы развертывания. Он идеально подходит для разработчиков, которым требуется полностью настраиваемый интерфейс.

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

Пакет SDK агентов Microsoft 365

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

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

Teams SDK

Пакет SDK для Teams — это платформа, специально предназначенная для Microsoft Teams. Он включает встроенный оркестратор планировщика действий и поддерживает языковые модели на основе GPT из Azure и OpenAI.

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

Интеграция агентов Microsoft Foundry

Microsoft Foundry предоставляет платформу для создания, тестирования и публикации интеллектуальных агентов с помощью пакета SDK Для платформы агента (прежнее название — Семаническое ядро). Эти агенты можно интегрировать в Microsoft 365 Copilot и Teams с помощью портала Foundry или набора средств microsoft 365 Agents.

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

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

Функция Публикация из Foundry в Microsoft 365 Интеграция с Microsoft 365 с помощью набора средств агентов
Описание Опубликуйте агент Foundry непосредственно в Microsoft 365 Copilot и Teams с минимальной настройкой. Автоматически подготавливает Azure Служба Bot и идентификатор Entra, а также упаковыв агент для распространения. Подключите существующий агент Foundry к Microsoft 365 Copilot с помощью приложения-посредника, созданного с помощью microsoft 365 Agents Toolkit. Включает расширенную настройку, отладку и развертывание в нескольких средах.
Инструменты Портал foundry Visual Studio Code/Visual Studio с набором средств агентов Microsoft 365
Идеально подходит для Быстрое развертывание и тестирование с минимальными изменениями кода Сценарии, требующие пользовательской логики, единого входа или управляемой инфраструктуры

Оба подхода интеграции подключают службу агента Foundry к Microsoft 365 Copilot через уровень бота или прокси-сервера, что позволяет пользователям взаимодействовать с агентами Foundry непосредственно в Microsoft 365 и Teams.

Сравнение средств разработки агента

В следующей таблице представлено краткое сравнение доступных подходов.

Функция Copilot Studio ИИ Teams Пакет SDK для агентов Литейного
Подход к разработке Низкий уровень кода Профессиональный код Профессиональный код Код с низким уровнем или профессиональный код
Инструменты Пользовательский интерфейс Copilot Studio Visual Studio Code/Visual Studio с пакетом SDK для Teams Visual Studio Code/Visual Studio с набором средств агентов Microsoft 365 Портал foundry или Visual Studio Code/Visual Studio с набором средств агентов Microsoft 365
Публикация Моя организация Моя организация
ISV/store		 Моя организация
ISV/store
10+ каналов		 Моя организация
ISV/store
Каналы Microsoft 365 Copilot, Teams, партнерские приложения, мобильные приложения и пользовательские веб-сайты Microsoft 365 Copilot, Teams Microsoft 365 Copilot, Teams, партнерские приложения, мобильные приложения и пользовательские веб-сайты Microsoft 365 Copilot и Teams (для других каналов требуется настраиваемая интеграция)
Эффективность Индивидуально Группа Группа Индивидуально
Orchestrator Copilot Studio Планировщик действий ИИ Teams Использование собственного (например, семантического ядра, LangChain) Использование собственного (например, семантического ядра или LangChain)
Модели ИИ Copilot Studio Любая модель по вашему выбору Любая модель по вашему выбору Foundry OpenAI или пользовательские модели
Поддерживаемые языки программирования Неприменимо (низкий код) C#, TypeScript, JavaScript, Python C#, JavaScript, Python Python, C#

Ключевые рекомендации

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

  • Публикация область. Только агенты, созданные с помощью пакета SDK для Teams, Пакет SDK агентов Microsoft 365 или Foundry, могут быть опубликованы в Microsoft Commercial Store с помощью набора средств агентов.
  • Производительность групп . Для сценариев с несколькими пользователями, особенно в Teams, рассмотрите пакет SDK для Teams для встроенной поддержки каналов совместной работы и собраний. Агенты Foundry также можно использовать в Teams, но может потребоваться дополнительная настройка для многопользовательского взаимодействия.
  • Потребности в настройке. Если вам нужен полный контроль над моделями ИИ или оркестрацией, выберите подход с профессиональным кодом с помощью Пакет SDK агентов Microsoft 365 или Foundry с помощью набора средств агентов.
  • Доступ к источнику знаний . Copilot Studio агенты имеют собственный доступ к содержимому соединителя Microsoft 365 и Copilot. Агенты pro-code, в том числе созданные с помощью пакета SDK для агентов или Foundry с помощью набора средств агентов, могут получать доступ к тем же данным через API Microsoft Graph и использовать API извлечения для заземления данных Microsoft 365.

Примеры сценариев

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

Сценарий Описание Рекомендуемый подход
Анализ юридических случаев Юридическая фирма создает автономный агент ИИ с помощью Foundry. Агент использует специально обученный LLM для анализа прецедентного права и интегрируется с внешними юридическими базами данных. Агент используется в системе управления делами фирмы, но также должен быть доступен в Microsoft 365 Copilot и иметь доступ к документам в SharePoint. Используйте Foundry , так как это позволяет фирме поддерживать настраиваемую логику ИИ и оркестрацию, делая агент доступным в Microsoft 365. Агенты можно публиковать на портале Foundry или интегрировать с помощью microsoft 365 Agents Toolkit.
Хирургическое планирование в сфере здравоохранения Больница создает агент для хирургических групп для планирования и планирования операций. Агент сотрудничает с врачами, медсестрами и административным персоналом и интегрируется с системами информации о пациентах и планирования. Агент упрощает совместную работу со всеми членами команды для планирования, создания встреч, разрешения конфликтов и настройки напоминаний и уведомлений. Используйте пакет SDK для Teams , так как агент работает в многопользовательской среде для совместной работы. Публикация в каналах Или собраниях Teams обеспечивает простое взаимодействие, а встроенный оркестратор Планировщика действий подключается к информационным системам планирования и пациентов.
Помощник адаптации сотрудников Компания хочет предоставить упрощенный помощник ИИ для новых сотрудников, чтобы отвечать на вопросы и ответы по управлению персоналом, направлять их по заполнению документов и указывать им внутренние ресурсы. Агент в основном обрабатывает стандартные процессы и документацию, которые уже доступны в Microsoft 365. Используйте Copilot Studio, так как она обеспечивает быструю разработку и развертывание с низким уровнем кода. Агент может использовать встроенные знания и соединители Microsoft 365, что делает его идеальным для простых рабочих процессов, для которых не требуются пользовательские модели ИИ или многоканальные оркестрации.

Рекомендации по проектированию и развертыванию

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

Примечание.

Настраиваемые агенты обработчика поддерживаются в манифесте приложения версии 1.21 и более поздних.

Порядок сообщений и поведение потоковой передачи

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

  • Используйте одну последовательность потоковой передачи для каждого пользователя. Создайте один StreamingResponse объект и завершите его с помощью перед endStream() отправкой дополнительных сообщений.

  • Подключите носитель внутри одного потока. Используйте setAttachments() вместо отправки отдельного действия без потоковой передачи. Отдельные сообщения могут появляться до или внутри потока из-за различий меток времени.

  • Не запускайте новый поток до завершения предыдущего. Несколько потоков в одном и том же порядке могут привести к непредсказуемому упорядочению в Teams и Copilot.

  • Сериализация исходящих сообщений. Избегайте параллельной отправки сообщений из нескольких потоков. Убедитесь, что ожидается обновление для поддержания порядка.

  • Не отправляйте потоковые обновления после endStream(). После завершения потока все новые обновления становятся отдельными действиями и могут отображаться не по порядку. Если вам нужно отправить сообщение, используйте replyToId его, чтобы сохранить его в том же потоке и уменьшить проблемы с последовательности.

Выбор модели ИИ

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

Дополнительные сведения см. в статье Выбор правильных моделей для приложений.

Ответственное применение ИИ

Убедитесь, что пользовательский агент соответствует требованиям, обеспечивает безопасность и соответствует политикам ответственного ИИ (RAI), соблюдая принципы RAI, применяя управление данными и соблюдая требования к публикации хранилищ для поставщиков программного обеспечения.

Факторы затрат

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

Дополнительные сведения см. в статье Рекомендации по затратам для расширяемости Copilot.

Конфиденциальность и соответствие требованиям

Запросы и ответы агента пользовательского обработчика в Copilot Chat и Teams хранятся в соответствии с условиями продукта Microsoft 365 и управляются в соответствии с инструкциями клиента. Для просмотра этих сохраненных данных и управления ими администраторы могут использовать поиск контента или Microsoft Purview.

Связанные материалы

  • Last updated on