Чек-лист проверки SDK Agent 365

Используйте этот чек-лист проверки SDK Agent 365 после интеграции агента и до его развертывания. Это последний шаг на пути адаптации: Agent 365 Skills или ручная настройка применяют интеграцию. Эти проверки помогают убедиться, что каждая возможность работает, чтобы вы могли с уверенностью развернуться.

Если ваш помощник по программированию открывает внутреннюю возможность Agent 365 Validate & Diagnose, также называемую a365-code-validator, вы можете попросить его проверить эту интеграцию с Agent 365 для кодового предпросмотра. Он проверяет проект на наличие пробелов в инструментации, артефактах Microsoft Entra, обмене сообщениями, доступе к инструментам и связанной конфигурации. Доступность и вызов зависят от ассистента и пакета навыков. Используйте чек-лист, чтобы подтвердить результаты в вашей целевой среде. Валидатор не заменяет сквозное тестирование или обзор платформы.

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

Пройдите этот чек-лист, если вы:

  • Я адаптировал агента и хочу подтвердить интеграцию перед развертыванием.
  • Добавил возможность агенту, который ты уже интегрировал.
  • Унаследовал агента от другой команды и нужно определить, что именно настроено.

Проверьте существующее поведение

SDK расширяет ваш агент, поэтому интеграция не должна менять работу агента.

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

Замечание

Если поведение ядра изменилось, проверьте перед развертыванием. Сгенерированный код, конфликты зависимостей, конфигурация и совместимость SDK — все возможные причины. См. раздел Устранение неполадок.

Проверка удостоверения

  • План идентификации агента зарегистрирован в Microsoft Entra.
  • Существует идентичность агента, созданная из этого чертежа. Навык make-a365-agent создаёт его на стандартном пути агента и make-ai-teammate на пути напарника ИИ; см. Быстрый старт: Соединить существующего агента с Агентом 365.
  • По крайней мере один спонсор назначается.
  • Если агенту нужен пользовательский аккаунт, этот аккаунт существует и связан с идентификацией агента.
  • Если у агента есть аккаунт пользователя, им присваиваются необходимые лицензии, а также предоставляются зависимые ресурсы, такие как почтовый ящик.
  • Права на API и область видимости Microsoft Graph предоставляются и правильно распределяются.
  • Агент аутентификация и действует под ожидаемой идентификацией.

Important

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

Замечание

После назначения лицензий подготовка ресурсов для пользовательской учетной записи обычно заканчивается за 10–15 минут, но может занять до 24 часов.

Проверьте наблюдаемость

  • По крайней мере одному пользователю в арендаторе присвоена лицензия Microsoft 365 E7 или Microsoft Agent 365. Без этой лицензии телеметрия отпадает, хотя при вводе HTTP 200 возвращается.
  • Пакеты наблюдаемости устанавливаются и настраиваются.
  • Тестовый запрос создаёт отсеки для вызова агента, выполнения инструмента и вывода.
  • В корне у серии есть валидный invoke_agent отсеч. Без него пролёты остаются доступными для запроса в Defender Advanced Hunting, но не достигают трёх поверхностей.
  • Телеметрия доступна в Microsoft Defender, Microsoft Purview и Центр администрирования Microsoft 365.
  • Атрибуты размаха соответствуют ожидаемым операциям.

Проверьте инструменты

Заполните этот раздел, если агент вызывает серверы протокола Model Context Protocol (MCP).

  • Лицензия Microsoft 365 Copilot доступна в арендаторе. Work IQ MCP находится на стадии предварительного просмотра и требует такого подхода.
  • Агент обнаруживает MCP-серверы, к которым должен иметь доступ.
  • Вызов тестового инструмента успешно выполняется от конца до конца.
  • Время выполнения агента фиксирует сбой инструмента, возвращает контролируемую ошибку и остаётся доступным.

Проверяйте уведомления

Заполните этот раздел, если агент получает уведомления.

  • Агент получает уведомления от настроенных источников, таких как Teams, Outlook, комментарии Word или электронная почта.
  • Агент отвечает на уведомление о тесте как задумано.

Important

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

Проверка конфигурации

  • Храните учетные данные и секреты надёжно и не передавайте их в систему контроля версий.
  • Отдельные сеттинги для разработки, тестирования и производства.
  • Убедитесь, что интеграция работает на целевом хосте.

Подтвердить готовность к развертыванию

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

Устранить неудачные проверки

Повторите соответствующий этап настройки или попросите помощника по программированию выполнить конкретную возможность.

Для распространённых симптомов и их устранения см. раздел «Устранение неполадок». Для симптомов, специфичных для настройки на основе навыков, см. таблицу устранения неполадок в Quickstart: Подключите существующего агента к Agent 365.

Для ответов на связанные вопросы смотрите раздел Agent 365 SDK по частым вопросам.

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

  • Last updated on