Пакет SDK агентов Microsoft Agent 365 и интерфейс командной строки

Впервые работаете с Agent 365?

Во-первых, выберите вариант интеграции. Если встроенная интеграция или синхронизация реестра предоставляют необходимые возможности, вам не нужно добавлять SDK только для регистрации агента. Для агентов Google Vertex AI и Amazon Bedrock см. Регистрация Google Vertex AI и агентов Amazon Bedrock.

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

Начальная точка	Начните здесь	Первый результат	Перед началом
У вас есть агент, и вы хотите адаптацию с помощью ИИ.	Быстрый старт: Подключите существующего агента к Агенту 365, используя навыки Агента 365.	Зарегистрируйте агента, добавьте выбранные вами возможности и проверьте интеграцию.	Проверьте поддерживаемые стеки, помощников по программированию, доступ к арендаторам, роли и требования к лицензированию.
У вас есть агент, и вы хотите самостоятельно управлять CLI-командами.	Составьте план агента.	Создайте чертёж, который определяет идентичность и права вашего агента.	Проверьте CLI, роль арендатора и требования к подписке Azure, затем используйте идентификатор агента для выбора модели идентичности.
Лучше учиться на примерном проекте, а не менять своего агента.	Выберите образец в Python, Node.jsили .NET.	Настройте образец и получите первый ответ в Agents Playground.	Ознакомьтесь с выбранными требованиями быстрого запуска или примерами README, включая время выполнения, доступ к модели и настройку аутентификации.

Для пути к примеру каталог ссылается на Python + Microsoft Agent Framework, Node.js + LangChain, а также на быстрые запуски Node.js + Claude Agent SDK, а также на .NET пример. Выберите свой язык в каталоге, чтобы увидеть доступные фреймворки.

Note

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

Agent 365 SDK

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

Tip

Ищете готовые агенты? См. статью об агентах-партнерах экосистемы, доступных в Agent 365, чтобы узнать больше об агентов, предварительно интегрированных при запуске.

У агентов уникальный идентификатор. Люди вызывают их с помощью привычных действий (например, @mentions) в приложениях, которыми обычно пользуются корпоративные пользователи (например, Teams, Word, Outlook и т. д.). Они демонстрируют прозрачное поведение, которое формирует доверие, выполняют поддающиеся аудиту действия и делают это посредством безопасного доступа к инструментам и данным.

С помощью пакета SDK Agent 365 агенты могут:

• Использовать идентификаторы агента на базе Microsoft Entra с собственными пользовательскими ресурсами, такими как почтовый ящик, для безопасной аутентификации и управляемого доступа к инструментам и данным.
• Получать и отвечать на уведомления из Teams, Outlook, комментариев в Word и писем — так же, как обычный участник в приложениях Microsoft 365.
• Обеспечивать полную наблюдаемость через сервис Open Telemetry, что позволяет отслеживать и аудировать взаимодействия агентов, события вывода и использование инструментов.
• Получайте доступ к управляемым серверам протокола контекста модели (MCP) для работы с ресурсами Microsoft 365 (например, Почта, Календарь, SharePoint, Teams) под контролем администратора.
• Функционировать в рамках утвержденной ИТ-системы схемы, гарантируя, что каждый экземпляр агента наследует политики соответствия, управления и безопасности.

Ознакомьтесь с обзором SDK Agent 365.

Интерфейс командной строки агента 365

Интерфейс командной строки Agent 365 — это основной инструмент командной строки для Agent 365 на протяжении всего жизненного цикла разработки агента: он автоматизирует настройку, управление идентификацией, конфигурацию, интеграцию с MCP, публикацию и развертывание в Azure для готовых к корпоративному использованию агентов.

С помощью интерфейса командной строки Agent 365 разработчики могут:

• Создавать схемы агентов и все необходимые для них ресурсы.
• Управлять встроенными и пользовательскими инструментами Work IQ, разрешениями и инструментарием для агентов.
• Развертывать код агента в Azure.
• Публиковать пакеты приложений агента в центре администрирования Microsoft.
• Удалять схемы агентов, идентификаторы и прочие ресурсы Azure, созданных в интерфейсе командной строки.

Подробнее об интерфейсе командной строки Agent 365

Жизненный цикл разработки Agent 365

Agent 365 работает с агентами, созданными на базе любых пакетов SDK или на любой платформе. Это включает малокодовые платформы, такие как Copilot Studio и Azure AI Foundry. Также поддерживаются полнокодовые платформы, такие как Microsoft Agent Framework, Microsoft Agents SDK, OpenAI Agents SDK, Claude Code SDK и LangChain SDK. Agent 365 также работает с кодом агента, размещенным на любой конечной точке — будь то Azure, Amazon Web Services (AWS), Google Cloud Platform (GCP) или любой другой облачный провайдер.

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

Phase	Guide
Проверьте интеграцию перед развертыванием.	Проверка проверки SDK агента 365 и проверьте вашего агента.
Развернуть код агента.	Azure, AWS или Google Cloud Platform.
Упаковывайте и опубликуйте агента.	Агент публикации в административный центр Microsoft.
Создайте и проверьте развернутый экземпляр агента.	Создайте экземпляры агентов и протестируйте развернутый агент.
Уберите ресурсы, которые вам больше не нужны.	Справочник по очистке CLI, включая варианты детальной очистки и сухого запуска.

Схема агента Agent 365

Прежде чем работать с экземплярами агентов Agent 365, полезно понять, что мы подразумеваем под схемой агента Agent 365. В основе лежит схема агента Microsoft Entra. Это одобренное ИТ, предварительно сконфигурированное определение типа агента, по сути корпоративная «схема», из которой могут создаваться соответствующие требованиям агенты. Схема определяет возможности агента, необходимый доступ к инструменту Work IQ, ограничения безопасности и соответствия, требования к аудиту, метаданные жизненного цикла, а также любые связанные шаблоны политик управления, такие как DLP, ограничения внешнего доступа или правила ведения журнала. После активации схемы для использования в арендаторе, пользователи могут запросить у своих администраторов создание новых экземпляров агентов на основе этой схем в центре администрирования Microsoft 365. Каждый экземпляр агента наследует правила своей схемы, что гарантирует единообразное управление над почтой, календарем, Teams, доступом к SharePoint и любыми другими рабочими нагрузками Microsoft 365, с которыми взаимодействует агент. Это предотвращает появление теневых или неавторизованных агентов, обеспечивает наблюдаемость и привязывает каждого агента к защищенной модели идентификации и разрешений, поддерживаемой Entra.

В чем отличие пакета SDK Agent 365?

SDK Agent 365 отличается от агентных фреймворков, таких как Microsoft Agent Framework или Microsoft Copilot Studio, тем, что не создаёт и не размещает агентов. Вместо этого он улучшает уже созданные вами агенты независимо от базового стека, добавляя корпоративные возможности, такие как идентификация агента на базе Entra, управляемый доступ к инструменту Work IQ, уведомления через протокол Activity и управление на основе идентификаторов агента. Используйте Microsoft OpenTelemetry для наблюдаемости.

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

Пакет SDK Agent 365 и экосистема агентов

В этой таблице резюмируется слоистая архитектура агента, показывая, как пакет SDK Agent 365 добавляет корпоративные возможности над логикой вашего агента и средой выполнения оркестратора LLM, предоставляемой выбранным вами фреймворком.

Слой	Role	Кем предоставлено
Корпоративные возможности	Идентификация, уведомления и инструменты из Agent 365 SDK; наблюдаемость от Microsoft OpenTelemetry	Agent 365 SDK и Microsoft OpenTelemetry
Логика агента	Запросы, рабочие процессы, рассуждения	Ваша реализация в коде
Среда выполнения оркестратора LLM	Вызов модели и оркестрация инструментов	Пакет SDK/фреймворк агента по вашему выбору

Дальнейшие действия

Подключите существующего агента к агенту 365