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

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

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

Необходимые условия

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

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

  • Удостоверение. Никаких дополнительных лицензий. У арендатора должен быть включён 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 затем направляет вас по одному из двух путей пополнения запасов. Выполните выбранный им шаг, затем продолжите с общими шагами, которые следуют за этим:

Оба пути затем продолжаются в Instrument для наблюдаемости.

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

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

Навык: make-a365-agent

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

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

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

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

Навык: make-ai-teammate

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

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

Important

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

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

Выполните этот шаг на любом из этих путей. Навык спрашивает, какой агент у вас есть.

Навык: instrument-observability

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

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

После тестового запуска диапазоны вашего агента отображаются в 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, прежде чем ваш агент сможет их вызвать. См. « Добавить и управлять инструментами».

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

Выполните этот шаг, если вы находитесь на пути напарника по команде с ИИ, для чего требуется программа предварительного просмотра 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снова, затем запустите соответствующий навык снова.

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

  • Last updated on