Быстрый старт: подключите существующего агента к агенту 365

В этом быстром старте вы подключаете существующего агента к Agent 365, используя Agent 365 Skills в вашем помощнике по программированию. Путь начинается с регистрации агента, затем добавляет выбранные вами возможности и заканчивается валидацией. Если вы создаёте AI-напарника, для которого требуется программа предварительного просмотра Frontier, вы также можете протестировать её локально.

Каждый шаг называет навык, который его обрабатывает, и показывает пример запроса. Навык вызывается, называя результат, а не вводя его имя.

Prerequisites

  • Существующий агент в поддерживаемом стеке: Python, Node.jsили .NET.
  • Арендатор Microsoft с включённым агентом 365. Войдите в систему как глобальный администратор или как разработчик идентификатора агента с глобальным администратором, доступным для выполнения разрешений OAuth.
  • Подписка Azure с разрешением на создание ресурсов.
  • Поддерживаемый помощник по программированию: Claude Code, GitHub Copilot CLI или VS Code.
  • Для установки навыков использовался GitHub CLI (gh),

Note

Настройка Agent 365 использует корпоративное приложение Agent 365 CLI, управляемое Microsoft, когда оно доступно в вашем арендаторе. Для этого пути не нужно создавать собственное клиентское приложение. Если корпоративное приложение недоступно, настройка возвращается к приложению, принадлежащему арендатору, под названием Agent 365 CLI. Поддерживается явно настроенное пользовательское клиентское приложение. Для получения дополнительной информации см . раздел Регистрация пользовательского клиента для Agent 365 CLI.

Лицензирование зависит от того, какие возможности вы принимаете:

  • Identity. Никаких дополнительных лицензий. У арендатора должен быть включён Agent 365.
  • Наблюдаемость. По крайней мере один пользователь в арендаторе имеет лицензию Microsoft 365 E7 или Microsoft Agent 365. Без неё телеметрия бесшумно исчезает.
  • Инструменты (рабочий IQ). Лицензия Microsoft 365 Copilot. Work IQ MCP находится на предварительном просмотре.
  • Уведомления. Пользовательский аккаунт агента, доступный только арендаторам программы предварительного просмотра Frontier.

Tip

Сначала убедитесь, что SDK — это правильный механизм интеграции для вашего агента. См. Выберите опцию интеграции. Для модели идентификации, лежащей в основе регистрации, включая чертежи, разрешения и согласие, см. ключевые понятия Agent identity и Microsoft Entra ID для агентов.

Установите навыки

Внедрите эти навыки своему ассистенту по программированию:

gh skill add microsoft/agent365-skills

Та же команда работает для Claude Code, GitHub Copilot CLI и VS Code agent. После этого перезапусти ассистента, чтобы он получил новые навыки.

Настройте и обнаружите проект

Откройте проект агента в вашем ассистенте по программированию, затем запустите:

Навык: a365-setup

настроил этот проект для Агента 365

Отвечайте на вопросы о вашем агенте. Когда навык заканчивается, он подтверждает ваши требования и обнаруживает стек.

Настройка сохраняет сгенерированные идентификаторы и конечные точки в a365.generated.config.json. Стандартная настройка агента не требует написания вручную конфигурационного файла; Настройка напарника с помощью ИИ требует ручного создания a365.config.json.

a365-setup затем направляет вас по одному из двух путей пополнения запасов. Выполните выбранный им шаг, затем продолжите с общими шагами, которые следуют за этим:

  • Стандартный агент, которому не нужен собственный пользовательский аккаунт. a365-setup спрашивает, проходит ли он аутентификацию с помощью OBO (от имени авторизованного пользователя) или S2S (как самого, без авторизованного пользователя). Продолжайте с регистрацией агента.
  • ИИ-товарищ по команде, что действительно так. Он аутентифицируется как отдельная учётная запись, поэтому a365-setup не требует режим аутентификации. Пропустите, чтобы добавить сообщения и уведомления. Этот путь требует программы предварительного просмотра Frontier.

Оба пути затем продолжаются в Instrument для наблюдаемости. Для выбора пути и режима аутентификации см. типы агентов и режимы аутентификации.

Регистрация агента

Выполните этот шаг, если a365-setup вас направили на стандартный путь агента.

Навык: make-a365-agent

зарегистрируйте этого агента у Агента 365

Когда навык завершён, у вашего агента будет зарегистрированный чертёж в Microsoft Entra, идентификация агента, созданная на его основе, и необходимые права: делегированные права для OBO или разрешения приложений для S2S. Регистрация обеспечивает видимость каталога; Шаг наблюдаемости добавляет телеметрию.

Добавить сообщения и уведомления

Пройдите этот шаг, если a365-setup вас направили на путь напарника по команде с ИИ.

Навык: make-ai-teammate

Добавляйте сообщения и уведомления в этот агент

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

Important

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

Инструмент для наблюдаемости

Выполните этот шаг на любом из этих путей. Если a365-setup вы ещё не записали их, навык спрашивает, какой у вас агент и какой режим аутентификации он использует.

Навык: instrument-observability

добавить наблюдаемость этому агенту

Навык поддерживает все три режима аутентификации:

  • OBO (от имени авторизованного пользователя)
  • S2S (сервис-сервис, для фоновых операций)
  • Agentic-User (собственная учетная запись агента, для которой требуется программа предварительного просмотра Frontier)

Во всех режимах экспортер отправляет телеметрию по маршруту S2S с помощью токена только для приложения, поэтому зарегистрированному экземпляру агента не требуется разрешение на наблюдаемость или согласие администратора. Режим определяет только, как ваш агент получит этот токен. См. Agent 365 enabled using S2S и Agent identity.

После тестового запуска диапазоны вашего агента отображаются в Microsoft Defender, Microsoft Purview и Центр администрирования Microsoft 365.

Important

Две вещи могут сделать так, что телеметрия выглядит как исчезлая, даже если запрос возвращает HTTP 200. Если ни одному пользователю в арендаторе не присвоена лицензия Microsoft 365 E7 или Microsoft Agent 365, весь запрос отклоняется; наличие SKU недостаточно. Если в корне пробежки нет действительного invoke_agent пролёта, они остаются доступными для запроса в Defender Advanced Hunting, но не появляются ни на одной из трёх поверхностей. Корневой диапазон — это верхний диапазон, который SDK излучает для одного вызова агента; Каждый вызов инструмента и событие вывода вкладываются внутри него.

Подключите данные Microsoft 365

Выполните этот шаг на любом из путей, если ваш агент читает или действует с данными Microsoft 365. Инструменты для работы IQ требуют делегированной модели разрешений, поэтому этот шаг автоматически пропускается, если ваш агент использует S2S.

Навык: add-workiq-tools

Подключить WorkIQ, Mail и Calendar

Назовите нужные вам рабочие нагрузки, такие как Mail, Calendar или Word. Навык подключает соответствующие серверы Work IQ MCP, и ваш агент может получить доступ к этим данным под контролем администратора.

Important

Work IQ MCP находится в предварительном просмотре и требует лицензии Microsoft 365 Copilot. Глобальный администратор должен предоставить OAuth права на серверы Work IQ, прежде чем ваш агент сможет их вызвать. См. « Добавить и управлять инструментами».

Добавьте предотвращение потери данных

Выполните этот необязательный шаг, если вашему агенту нужна система предотвращения потери данных Microsoft Purview (DLP). Этот навык поддерживает агентскую делегированную аутентификацию и Node.js S2S с клиентской секретной FMI-аутентификацией.

Навык: purview-dlp-integration

добавить Purview DLP в этот агент

Этот навык добавляет проверки Microsoft Graph processContent для блокировки подсказок до их попадания в LLM, когда политика блокировки ввода совпадает, а также направляет настройки разрешений и политики DLP. Опциональный ответ проверяет ответы, но не фильтрует чувствительный выход. По умолчанию ошибки и тайм-ауты останавливают ход, включая задержку ответа при неудаче аудита.

Important

Этот этап требует включения Purview DLP для ИИ в вашем арендаторе, включая лицензирование, оплату по мере использования и DSPM для адаптации ИИ. Для .NET проверьте защиту с лучшей защитой вашей версии SDK.

Локальное тестирование

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

Навык: test-local

Тестируйте этот агент локально

Ваш агент соперничает с Agents Playground — местной тестовой системой, чтобы вы могли провести дымовой тест перед развертыванием.

Проверьте результат

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

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

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

Troubleshoot

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

Симптом Решение
Помощник по программированию описывает команды, но не запускает их Используйте режим с доступом к терминалу. В VS Code используйте режим агента. Режимы Ask и Edit не могут запускать команды терминала.
Setup reports missing Azure prerequisites Выполните пререквизиты, указанные a365-setup в списке, затем запустите навык снова.
Регистрация чертежа не проходит, или команды CLI возвращают ошибки авторизации Убедитесь, что вы вошли в аккаунт, имеющий разрешение на регистрацию чертежей идентификации агента в арендаторе.
Телеметрия не отображается Убедитесь, что хотя бы одному пользователю в арендаторе назначена лицензия Microsoft 365 E7 или Microsoft Agent 365, затем убедитесь, что запуск издаёт действительный invoke_agent спан, а затем убедитесь, что выбранный вами режим аутентификации соответствует вашей среде. Попросите вашего помощника по программированию подтвердить интеграцию с Agent 365; Установленный навык валидатора может диагностировать инструменты.
Похоже, шаг был пропущен Навыки учитывают состояние и пропускают уже запрограммированную работу, так что, скорее всего, этап уже завершён. Повторите конкретный навык и чётко скажите результат.
Значения конфигурации должны меняться после настройки Если ваша установка использует a365.config.json, отредактируйте и запустите a365 config init -c ./a365.config.jsonснова, затем запустите соответствующий навык снова.

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

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