Навыки Agent 365 для настройки управляемых агентов

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

Навыки реализуются во всех агентах кода, включая Claude Code, GitHub Copilot CLI и VS Code agent.

Чтобы установить навыки и следовать пути онбординга для вашего агента, смотрите раздел «Быстрый старт: Соедините существующего агента с агентом 365».

Замечание

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

Когда использовать навыки

Подключение существующего агента к корпоративной идентичности, наблюдаемости, управляемым инструментам и уведомлениям требует нескольких упорядоченных этапов настройки. Эти шаги включают установку Agent 365 CLI, проверку требований Azure, регистрацию чертежа, настройку ресурсов Entra, подключение экспортеров OpenTelemetry, подключение серверов Model Context Protocol (MCP) и локальное тестирование.

Навыки выполняют эти шаги в необходимом порядке для выбранного пути и подтверждают итоговый проект.

Как работает навык

Каждый навык следует одному и тому же рабочему процессу:

  1. Опишите желаемый результат.
  2. Пусть навык определит стек проекта и существующую конфигурацию.
  3. Указывайте запрошенные значения, например, режим аутентификации.
  4. Проверьте код, манифест и изменения в конфигурации, которые он вносит.
  5. Убедитесь, что проект всё ещё строится и интеграция работает.

Семь навыков

a365-setup — это точка входа. После валидации предварительных требований вас направляет по одному из двух путей, и вы следуете только по этому пути:

  • Стандартный агент. a365-setup делегаты на make-a365-agent. Используйте этот путь, когда агенту нужна регистрация и наблюдаемость, но нет учетной записи пользователя.
  • Напарник по команде с ИИ. a365-setup делегирует на make-ai-teammate, для агента, которому нужен собственный пользовательский аккаунт. Этот путь требует программы предварительного просмотра Frontier.
Skill Purpose
a365-setup Устанавливает CLI Agent 365, проверяет требования Azure, обнаруживает стек агентов, затем делегирует на make-a365-agent или make-ai-teammate.
make-a365-agent Предоставляет стандартный агент, которому не нужен собственный аккаунт пользователя. Регистрирует чертеж идентичности агента в Microsoft Entra, создаёт из него идентичность агента и настраивает необходимые агенту права Entra ID, затем предлагает наблюдаемость и инструменты в качестве дополнений.
make-ai-teammate Превращает агента в ИИ-тиммейта с собственной учетной записью. Регистрирует чертеж идентичности агента и создаёт из него идентичность агента, затем добавляет слой хостинга, маршрутизацию сообщений и уведомления. Нужно a365-setup сначала запуститься.
instrument-observability Wires OpenTelemetry и Agent 365 трассирует экспортер, чтобы размахи агентов охватывали Microsoft Defender, Microsoft Purview и Центр администрирования Microsoft 365. Запрашивает тип агента и режим аутентификации; см. идентичность агента.
a365-code-validator Проверяет и диагностирует существующую интеграцию Agent 365, включая инструментирование, артефакты Microsoft Entra, обмен сообщениями, доступ к инструментам и связанные конфигурации. Только для чтения по умолчанию. Используйте instrument-observability для добавления наблюдаемости с нуля.
add-workiq-tools Подключает серверы Work IQ MCP, включая Mail, Calendar и Word, чтобы агент мог читать и работать с данными Microsoft 365. Требуется модель делегированных разрешений и автоматически пропускается при режиме аутентификации S2S.
test-local Локально запускает AI-агента по команде и открывает Agents Playground для интерактивного тестирования, без необходимости облачного развертывания. Это касается и пути напарника с ИИ.

Important

make-ai-teammate предоставляет агенту собственный пользовательский аккаунт, включая почтовый ящик и присутствие в Teams. Эта возможность доступна только арендаторам, участвующим в программе предварительного просмотра Frontier.

Обычно навык вызывается, называя результат, а не называя навык. Например , добавление наблюдаемости к этому агенту выполняет instrument-observability. Если ваш помощник по программированию открывает внутреннюю a365-code-validator возможность, попросите его подтвердить эту интеграцию с Agent 365; эта возможность также внутренне описывается как Validate & Diagnose. Доступность и вызов зависят от ассистента и установленного пакета Skills. Для формулировки запросов, используемых на каждом этапе, см. Быстрый старт: Соединить существующий агент с агентом 365.

Поддерживаемые стеки

Skills автоматически обнаруживают стек проекта, так что вам не нужно создавать карту вручную. Это стеки, которые обнаруживает Навыки. SDK также работает с другими фреймворками.

Language Frameworks
.NET Microsoft Agent Framework, Semantic Kernel, Azure AI Foundry
Node.js LangChain, OpenAI Agents SDK, Claude Agent SDK, Semantic Kernel, Google ADK
Python Microsoft Agent Framework, LangChain, OpenAI Agents SDK, Claude Agent SDK, Semantic Kernel, Google ADK

Безопасность и повторяемость

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

  • Аддитивный и идемпотентный. Навыки не удаляют и не перестраивают существующий код, а повторный запуск навыка не дублирует выполненную работу.
  • Государственное осознание. Навыки обнаруживают уже запрограммированные шаги, поэтому пропускают, а не повторяют выполненные шаги.
  • Ограждение. Навыки не изменяют файлы вне вашего проекта и проверяют, что сборка всё равно проходит, прежде чем завершить её.

Используйте навыки, когда:

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

Используйте ручную настройку, когда:

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

Для ручного пути используйте шаги настройки в Quickstart: подключите существующий агент к Agent 365 и выполните эквивалентные команды CLI Agent 365 для вашей среды.