В этой статье отвечают на распространённые вопросы о SDK Agent 365: что он делает и не делает, когда он вам нужен, какие возможности доступны, как работает идентификация и как проверить интеграцию.
Область действия и позиционирование
Могу ли я создать агента с помощью SDK Agent 365?
No. SDK — это не фреймворк для построения агентов. Создайте агента с помощью выбранного фреймворка, затем используйте SDK Agent 365, чтобы перенести его в Agent 365. Посмотрите, когда использовать SDK Agent 365.
Создаёт ли SDK вызовы языковых моделей или оркестрирует шаги?
No. Ваш агент продолжает создавать свои собственные вызовы моделей, а оркестрация остаётся в вашем фреймворке или процессе выполнения. См. Agent 365 SDK и экосистему агентов.
SDK хостит или размещает моего агента?
No. Ваш агент работает там, где он работает сегодня. Смотрите, чем отличается SDK Agent 365?
Выполняет ли SDK вызовы инструментов моего агента?
No. Регистры SDK управляли серверами протокола Model Context Protocol (MCP); Исполнение остаётся в вашем времени. См. Agent 365 SDK и экосистему агентов.
Заменяет ли SDK мой агентный фреймворк?
No. Оставьте свою модель, фреймворк или среду выполнения и хост. SDK работает параллельно с ними и добавляет идентификацию, наблюдаемость, инструменты и уведомления. Для пошаговой границы см. обзор Agent 365 SDK.
Чем SDK Agent 365 отличается от Пакет SDK агентов Microsoft 365?
SDK Пакет SDK агентов Microsoft 365 создаёт разговорные агенты, обрабатывая связность каналов и состояние разговоров. SDK Agent 365 расширяет уже созданный вами агент. Они работают вместе. См. обзор SDK агента 365.
Какие языки поддерживает SDK?
Python, JavaScript и .NET. См. пакеты SDK Agent 365.
Выбор механизма интеграции
Нужен ли мне SDK?
Не всегда. Если встроенная интеграция или синхронизация реестра уже предоставляет необходимые возможности вашему агенту, возможно, SDK вам не понадобится. См. Выберите опцию интеграции.
Когда встроенная интеграция становится достаточной?
Когда путь платформы уже предоставляет возможности Agent 365, необходимые для вашего сценария. Copilot Studio и Azure AI Foundry могут относиться к этой категории, но поддержка зависит от того, как агент создан, аутентифицирован и размещён. Владение или развертывание кода само по себе не требует SDK. См. Сравните механизмы интеграции агента 365.
В чём разница между синхронизацией реестра и интеграцией с SDK?
Синхронизация реестра объединяет агентов с подключённых агентных платформ, таких как Google Vertex AI и Amazon Bedrock, в Agent 365 через конфигурацию на уровне платформы. Интеграция SDK предназначена для агентов, которые вы создаёте с помощью агентного SDK или фреймворка, и она даёт управление на уровне кода. См. Сравните механизмы интеграции агента 365.
Мой агент работает вне Azure. Могу ли я всё ещё использовать SDK?
Yes. SDK не меняет направление работы вашего агента. Он работает с агентами, размещёнными на Azure, AWS, Google Cloud или локально. См. Жизненный цикл разработки агента 365.
Возможности
Обязательно ли принимать все четыре способности?
Нет, но у них есть предварительные требования. План идентификации агента лежит в основе возможностей идентификации, инструментов и уведомлений, а уведомления дополнительно требуют пользовательский аккаунт агента, который доступен только арендаторам, участвующим в программе предварительного просмотра Frontier. Observability также работает со стандартной регистрацией приложения Microsoft Entra. Кроме того, добавляйте возможности в любом порядке. См. уведомления «Проверить».
С какой возможности мне начать?
Личность. Регистрация — это то, что делает агента видимым в Агенте 365, так что начните с этого. Добавьте наблюдаемость, когда вам нужна оперативная видимость. См. Регистрировать агента и инструмент для наблюдаемости.
Куда девается моя телеметрия?
Размахи агентов доступны в Microsoft Defender, Microsoft Purview и Центр администрирования Microsoft 365.
Две вещи могут заставить телеметрию выглядеть как исчезнувшая, даже если при вводе возвращается HTTP 200.
Если ни у одного пользователя в арендаторе не назначена лицензия Microsoft 365 E7 или Microsoft Agent 365, весь запрос отклоняется.
Если в корне пробежки нет действительного invoke_agent пролёта, они всё равно можно запросить в Defender Advanced Hunt, но не появляются ни на одной из трёх поверхностей.
Посмотрите, где отображаются ваши данные, а также Ограничения и условия выброса.
Что такое рабочий IQ?
Work IQ — это набор управляемых MCP-серверов, которые предоставляют вашему агенту под контролем администратора рабочие нагрузки Microsoft 365, такие как Mail, Calendar, Word, SharePoint и Teams. Work IQ MCP находится в предварительном просмотре и требует лицензии Microsoft 365 Copilot. См. Проверить инструменты.
Какие источники уведомлений поддерживаются?
Teams, Outlook, комментарии в Word и электронная почта. Для получения уведомлений требуется пользовательский аккаунт агента, который доступен только арендаторам, участвующим в программе предварительного просмотра Frontier. Смотрите типы уведомлений и уведомления «Верифицироваться».
Identity
Нужна ли моему агенту собственная личность?
Каждая интеграция с Agent 365 требует модели идентичности, но это не всегда означает выделение агенту собственной пользовательской учетной записи. Агент может использовать S2S в качестве идентификатора агента, OBO — от имени авторизованного пользователя, а Agentic-User — через собственную учетную запись Microsoft Entra пользователя. Выберите режим, который соответствует работе агента, его правам и необходимым ресурсам Microsoft 365. См. идентичность агента.
В чём разница между планом идентификации агента и идентичностью агента?
Чертёж — это повторно используемый шаблон, который хранит учетные данные и заявленные разрешения для своего рода агента. Идентификатор агента — это аккаунт, под которым отдельный агент аутентифицируется. Один чертеж может создавать множество идентичностей агентов. См. объекты идентичности и S2S, идентичность агента, полученная на основе чертежа.
Где хранятся данные моего агента?
На чертеже, а не на личности агента. Поскольку скомпрометированный чертеж влияет на каждого агента, созданного из него, считайте количество чертежей как решение о границе безопасности. См. идентичность агента.
Сколько чертежей мне нужно создать?
Столько, сколько нужно, чтобы разделить границы учетных данных и разрешений. Объединяйте только идентификаторы агентов, которые могут безопасно делиться учётными данными и унаследованными разрешениями чертежа. См. Основа идентичности и S2S, идентичность агента, основанного на чертежах.
Какую модель разрешений следует использовать?
Разрешения приложений для работы между сервисами, где агент действует по собственным правам. Делегированные права на работу от имени компании, когда агент действует с правами авторизованного пользователя и контекстом. См. идентичность агента.
Нужна ли моему агенту лицензия Microsoft 365?
Только если у него есть аккаунт пользователя и нужны сервисы, такие как Teams, Exchange или SharePoint. Агенты с собственной учетной записью доступны только арендаторам программы предварительного просмотра Frontier. Лицензирование на уровне арендатора по-прежнему применяется к другим возможностям: телеметрия отменяется, если хотя бы один пользователь в арендаторе не имеет лицензии Microsoft 365 E7 или Microsoft Agent 365, а для Work IQ MCP требуется лицензия Microsoft 365 Copilot. Смотрите пользовательскую запись агента, инструменты Verify identity, проверьте наблюдаемость и инструменты Verify.
Почему почтовый ящик моего агента ещё не доступен?
Предоставление ресурсов может задерживать присваивание лицензий. См. чек-лист проверки проверки SDK агента 365 для ожидаемых таймингов.
Кто такой спонсор?
Бизнес-представитель отвечает за цель и жизненный цикл агента. Для каждого удостоверения агента и шаблона идентификации агента требуется по крайней мере один спонсор. Службы безопасности используют спонсора, чтобы связаться с ответственным человеком во время инцидента. Смотрите Спонсоры и Проверьте личность.
Настройка и навыки
Что такое навыки агента 365?
Способ получить помощника по программированию, например GitHub Copilot CLI, который выполняет этапы интеграции за вас. См. Навыки агента 365.
Что заменило рабочий процесс настройки instructions.md?
Агент 365 Skills заменил этот рабочий процесс. Используйте навыки вместо этого.
Если ваш помощник по программированию открывает внутреннюю возможность Validate & Diagnose, вы можете попросить его подтвердить интеграцию Agent 365; Внутри a365-code-validatorэтого также называют .
Доступность зависит от ассистента и установленного пакета навыков. См. Навыки агента 365.
Обязательно ли использовать навыки?
No. Каждый шаг можно выполнять вручную. Навыки подходят для стандартных установок и повторяемого онбординга; Ручная настройка подходит для нестандартных сред и устранения неполадок. Посмотрите, когда использовать Навыки.
Безопасно ли использовать навык несколько раз?
Yes. Навыки аддитивны и идемпотентны, поэтому выполненные шаги пропускаются, а не дублируется. См. Безопасность и повторяемость.
Навык пропустил шаг. Это проблема?
Обычно нет. Навыки пропускают уже настроенную работу. Запустите конкретный навык ещё раз и чётко укажите результат, если хотите подтвердить. См. Безопасность и повторяемость.
Могу ли я протестировать перед развертыванием в облаке?
На пути с ИИ-тиммейтом — да.
Навык test-local управляет вашим агентом вместе с Agents Playground — местной тестовой упряжкой — для тестирования на дым.
Agents Playground подключается через конечную точку сообщений агента, поэтому это не относится к стандартным агентам.
См. «Семь навыков » и «Тестовый агент» в «Агентская площадка».
Validation
Как подтвердить, что интеграция сработала?
Мой агент ведёт себя иначе после интеграции. Что пошло не так?
SDK расширяет ваш агент, а не заменяет его часть. Проверьте любые изменения поведения перед развертыванием: сгенерированный код, конфликты зависимостей, конфигурация и совместимость SDK — все возможные причины. Начните с «Проверьте существующее поведение».