Обзор Microsoft Agent 365 SDK

SDK Microsoft Agent 365 соединяет уже принадлежащий вам агент и который он запускается, к Microsoft Agent 365. Используйте его для доступа на уровне кода к таким функциям, как идентификация агента, управляемые инструменты Work IQ или уведомления.

Где вписывается SDK

Агент 365 объединяет агентов из разных источников в одну управляющую плоскость, где организации могут обнаружить, управлять и обеспечивать безопасность в масштабах. Путь интеграции зависит от того, где и как вы создаёте агент:

Источник агента Путь интеграции
Платформы и агенты Microsoft, а также поддерживаемые сторонние агенты Используйте нативную интеграцию платформы с Agent 365. Эти агенты могут появиться в инвентаре Agent 365 без добавления SDK Agent 365.
Агенты, созданные на SDK или фреймворке, таких как Пакет SDK агентов Microsoft 365, OpenAI Agents SDK, Microsoft Agent Framework, LangChain, CrewAI или LlamaIndex Добавьте SDK Agent 365 в код агента для интеграции с разработчиками возможностей, таких как инструменты Work IQ или уведомления.
Подключённые агентные платформы, такие как Vertex AI или AWS Bedrock Настройте синхронизацию реестра для каждой платформы для импорта своих агентов в инвентарь Agent 365.

Все три пути соединяют агентов с Agent 365 и его интеграцией с Microsoft Entra, Microsoft Defender, Microsoft Purview и Microsoft Intune. Нативная интеграция и синхронизация реестра не всегда обеспечивают те же возможности на уровне кода, что и Agent 365 SDK. Интеграции платформы эволюционируют, поэтому проверьте текущие рекомендации платформы перед изменением интеграции. См. Выберите опцию интеграции.

Как возможности агента 365 сочетаются друг с другом

Интеграция с разработчиками Agent 365 предоставляет четыре функции. SDK Agent 365 предоставляет идентификацию, инструменты и уведомления. Microsoft OpenTelemetry обеспечивает наблюдаемость:

Capability Description
Identity Используйте идентификатор агента с поддержкой Microsoft Entra для безопасной аутентификации и контролируемого доступа к инструментам и данным. Агенты, которым нужен собственный пользовательский аккаунт и почтовый ящик, доступны только для арендаторов, участвующих в программе предварительного просмотра Frontier.
Наблюдаемость Используйте отдельный дистрибутив Microsoft OpenTelemetry для передачи телеметрии, которая генерирует аудитируемые, отслеживаемые взаимодействия, события вывода и использование инструментов.
Инструменты Вызов управляемых серверов Work IQ Model Context Protocol (MCP) для доступа к рабочим нагрузкам Microsoft 365, таким как Mail, Calendar, Word, SharePoint и Teams, под управлением администратора.
Уведомления Получайте и отвечайте на сообщения от Teams, Outlook, комментариев Word и электронной почты, как человек в приложениях Microsoft 365. Эта возможность требует пользовательского аккаунта агента и доступна только арендаторам, участвующим в программе предварительного просмотра Frontier.

Important

Не используйте устаревший SDK Agent 365 Observability для новых интеграций наблюдаемости. Используйте дистрибутив Microsoft OpenTelemetry. Продолжайте использовать пакеты SDK Agent 365 для идентификации, инструментов и уведомлений.

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

SDK предоставляется в специализированных для языка пакетах для Python, JavaScript и .NET. Установите пакет или пакеты для выбранных вами возможностей, затем настройте соответствующую идентичность, права и интеграцию во время выполнения. Для доступных пакетов см. пакеты SDK Agent 365. Установите Microsoft OpenTelemetry отдельно для новых интеграций наблюдаемости.

Сравните SDK Microsoft Agent 365 и Пакет SDK агентов Microsoft 365

Microsoft Agent 365 SDK и Microsoft 365 Agents SDK — это разные продукты.

Microsoft Agent 365 SDK (Этот SDK) Пакет SDK агентов Microsoft 365
Не создаёт агентов.
Расширяет уже существующий агент для добавления идентичности, инструментов и уведомлений. Используйте Microsoft OpenTelemetry для добавления наблюдаемости.		 Фреймворк для создания разговорных агентов.
Отвечает за доставку сообщений через такие каналы, как Teams и Microsoft Copilot, а также управляет состоянием разговоров.

Эти SDK работают вместе. Вы можете создать агент с помощью SDK Пакет SDK агентов Microsoft 365, использовать SDK Agent 365 для идентификации, инструментов и уведомлений, а также Microsoft OpenTelemetry для наблюдаемости.

Что это такое, а что нет

Вы по-прежнему владеете тремя слоями, которые обеспечивают работу агента:

Слой Description
Модель Языковая модель или движок рассуждения, который вызывает ваш агент. SDK не вызывает и не выбирает модели.
Фреймворк или среда выполнения LangChain, Microsoft Agent Framework, Semantic Kernel, OpenAI Agents SDK, Claude Agent SDK или пользовательский код. SDK не создаёт агентов, не планирует и не координирует шаги и не выполняет инструменты.
Хост Где бы ни работает агент сегодня, например, в Azure, AWS, Google Cloud или локально. SDK не размещает и не размещает вашего агента.

SDK Microsoft Agent 365 работает параллельно с этими уровнями. Он не создаёт, не размещает, не развёртывает, не оркестрирует и не исполняет агента.

Note

Регистры SDK Microsoft Agent 365 управляли MCP-серверами, так что ваш агент мог достигать рабочих нагрузок Microsoft 365, но ваша среда выполнения всё равно выполняет вызовы инструментов.

Процесс адаптации

Интеграция состоит из четырёх этапов:

Этап Description
1. Регистрация Создайте чертеж идентификатора агента и идентификатор агента в Microsoft Entra.
2. Продление Добавьте те возможности, которые нужны вашему агенту. Используйте SDK Agent 365 для инструментов или уведомлений Work IQ, а для наблюдаемости — Microsoft OpenTelemetry.
3. Валидировать Запустите агент как раньше и подтвердите его личность, телеметрию, доступ к инструментам и обработку сообщений.
4. Действовать Используйте контроли Agent 365 для управления и аудита подключённого агента.

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

Как проходит запрос

Одно взаимодействие может использовать все четыре функции. Когда кто-то @mentions из вашего агента в Word комментирует:

  1. Уведомления доставляют упоминание вашему агенту.
  2. Идентификация и аутентификация определяют, действует ли агент как сам себя — от имени авторизованного пользователя или через аккаунт агента. Выбранный режим, разрешения, согласие и субъект токена определяют, какие данные и действия доступны.
  3. Инструменты дают агенту управляемый доступ к необходимым данным Microsoft 365.
  4. Наблюдаемость фиксирует вызов, вызовы инструментов и вывод модели.

Ваш агент отвечает в комментариях.

Пакеты Agent 365 SDK

Пакеты Agent 365 SDK доступны в диспетчерах пакетов для поддерживаемых языков.

Important

Пакеты наблюдаемости в следующих таблицах устарели. Не используйте их для новых интеграций. Используйте дистрибутив Microsoft OpenTelemetry или ознакомьтесь с устаревшей документацией Agent 365 Observability SDK перед миграцией существующей интеграции.

Пакеты SDK Agent 365 для Python можно найти в индексе пакетов Python (PYPI).

Package Description
microsoft-agents-a365-notifications Расширения для уведомлений и обмена сообщениями для приложений агентов ИИ. Предоставляет утилиты для обработки уведомлений агентов, событий жизненного цикла и маршрутизации по различным каналам и субканалам в приложениях Microsoft 365.
microsoft-agents-a365-observability-core Устарело: устаревшие компоненты телеметрии, отслеживания и мониторинга для агентов ИИ, построенные на базе OpenTelemetry. Обеспечивает структурированные спаны для вызова агента, выполнения инструментов и вывода LLM с распространением контекста и подключаемыми экспортерами. Используйте дистрибутив Microsoft OpenTelemetry вместо этого.
microsoft-agents-a365-observability-extensions-agent-framework Устарело: Устаревшие расширения наблюдаемости для Microsoft Agent Framework. Обеспечивает интеграцию трассировки OpenTelemetry специально для приложений на базе Agent Framework. Используйте дистрибутив Microsoft OpenTelemetry вместо этого.
microsoft-agents-a365-observability-extensions-openai Устарело: Устаревшие расширения наблюдаемости для OpenAI Agents SDK. Обеспечивает интеграцию трассировки OpenTelemetry для приложений на базе OpenAI Agents с автоматическим инструментированием рабочих процессов агентов и вызовов инструментов. Используйте дистрибутив Microsoft OpenTelemetry вместо этого.
microsoft-agents-a365-observability-extensions-langchain Устарело: Устаревшие расширения наблюдаемости для фреймворка LangChain. Обеспечивает интеграцию трассировки OpenTelemetry для приложений ИИ на базе LangChain с автоматическим инструментированием цепочек, агентов и инструментов. Используйте дистрибутив Microsoft OpenTelemetry вместо этого.
microsoft-agents-a365-observability-extensions-semantic-kernel Устарело: Устаревшие расширения наблюдаемости для фреймворка Semantic Kernel. Обеспечивает интеграцию трассировки OpenTelemetry для приложений на базе Semantic Kernel с автоматическим инструментированием функций ядра, подключаемых модулей и планировщиков. Используйте дистрибутив Microsoft OpenTelemetry вместо этого.
microsoft-agents-a365-runtime Основные утилиты времени выполнения и управления средами для приложений агентов ИИ. Обеспечивает обнаружение ключевых API Power Platform, настройку среды и определение области аутентификации.
microsoft-agents-a365-tooling Базовая функциональность для управления инструментами серверов MCP (протокола контекста модели) в приложениях, созданных с помощью Microsoft Agent 365 SDK. Предоставляет основу для обнаружения, регистрации и управления серверами инструментов в различных фреймворках ИИ.
microsoft-agents-a365-tooling-extensions-agentframework Инструменты и службы для разработки агентов ИИ, специфичные для Agent Framework. Предоставляет службу регистрации инструментов MCP (протокола контекста модели) для динамического добавления MCP-серверов в агентов Agent Framework.
microsoft-agents-a365-tooling-extensions-openai Инструменты и службы для разработки агентов ИИ, специфичные для OpenAI Agents SDK. Предоставляет службу регистрации инструментов MCP (протокола контекста модели) для динамического добавления MCP-серверов в агентов на базе OpenAI Agents SDK.
microsoft-agents-a365-tooling-extensions-semantickernel Инструменты и службы для разработки агентов ИИ, специфичные для Semantic Kernel. Предоставляет службу регистрации инструментов MCP (протокола контекста модели) для динамического добавления MCP-серверов в агентов на базе Semantic Kernel.
microsoft-agents-a365-tooling-extensions-azureaifoundry Инструменты и службы для разработки агентов ИИ, специфичные для Azure AI Foundry. Предоставляет службу регистрации инструментов MCP (протокола контекста модели) для динамического добавления MCP-серверов в агентов Azure AI Foundry.

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

  • Последнее обновление: