Создание экземпляров агентов

После публикации вашего агента и размещения его в административном центре Microsoft вы сможете создавать экземпляры агентов и пользователей агентов. Эти экземпляры и пользователи используют созданный вами blueprint агента и код агента.

В этой статье процесс рассматривается на три основных этапа:

  1. Configure agent в портале разработчиков Teams
  2. Создать экземпляр агента
  3. Протестируйте вашего развернутого агента

Если столкнулись с вызовами, обратитесь к разделу «Устранение неполадок ».

Предпосылки

1. Настройте агента в портале разработчиков Teams

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

  1. Получите свой Blueprint ID

    Откройте a365.generated.config.json в рабочем каталоге и скопируйте agentBlueprintId значение.

  2. Перейти к порталу разработчиков

    Откройте браузер и перейдите на страницу настройки:

    https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

    Замените <your-blueprint-id> на agentBlueprintId скопированное значение.

    Замечание

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

  3. Настройте агент

    В портале разработчиков:

    1. Установите тип агента на API

    2. Установите URL уведомления на конечную точку обмена сообщениями вашего агента. Найдите messagingEndpoint значение в a365.generated.config.json.

    3. Нажмите кнопку "Сохранить".

    Скриншот, показывающий страницу конфигурации портала разработчиков с типом агента, установленным на API и полем URL уведомления.

Вам нужна эта конфигурация, прежде чем создавать экземпляры агентов в Teams.

Узнайте больше о чертежах идентичности агентов и конфигурации портала разработчиков.

2. Создать экземпляр агента

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

Когда вы запрашиваете экземпляр агента, Teams отправляет запрос администратору арендатора для утверждения. Администраторы могут просматривать и одобрять запросы на странице Microsoft административного центра — Запрошенные агенты.

После того как администратор одобрит ваш запрос, Teams создаёт ваш экземпляр агента и делает его доступным в Teams.

3. Протестируйте своего действующего агента

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

После развертывания и с активными уведомлениями агентов в SDK Agent 365 ваш агент интегрируется с сервисами Microsoft 365. Он работает с Teams для чатов, каналов и встреч; с электронной почтой и календарем для отправки, получения и планирования; а также с помощью SharePoint и OneDrive для доступа к документам и обмена файлами. Также поддерживается функции совместной работы, такие как присутствие организации, задачи планировщика и комментарии к документам.

Это важно

Как и обычные пользователи, агенты также нуждаются в соответствующих лицензиях Microsoft 365 для доступа к сервисам. К общим лицензиям относятся Microsoft 365 E5, Teams Enterprise и Microsoft 365 Copilot.

Просмотр развернутого агента в административном центре

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

Перейдите на Центр администрирования Microsoft 365 - Agents, чтобы:

  • Просмотр вашего опубликованного агента
  • Управление параметрами агента
  • Мониторинг использования агента
  • Настройка разрешений

Агент тестирования в Teams

После развертывания, публикации и настройки чертежа агента и создания пользователя агента, протестируйте пользователя агента непосредственно в Microsoft Teams:

Начинайте тестирование

  1. Ищите нового пользователя агента в Teams.

    Замечание

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

  2. Начните новый чат с вашим недавно созданным экземпляром агента.

  3. Отправляйте тестовые сообщения для проверки работы агента.

Пример тестового сообщения

Если вы настроили агента с электронной почтой, отправьте это сообщение для тестирования функционала электронной почты. Обновите значение электронной почты получателя recipient@contoso.com .

Send an email to <recipient@contoso.com> with subject "Hello from Teams" and message "This is a test message from my agent!"

Агент обрабатывает запрос и отправляет письмо без дополнительного подтверждения.

Контрольный список проверки

После создания экземпляра агента убедитесь, что он работает корректно в Teams.

✅ Конфигурация портала разработчиков сохранена
✅ Агент появляется в поиске приложений Teams
✅ Вы можете создать агента экземпляра для команд
✅ Создан экземпляр агента
✅ Пользователь агента появляется в организации
✅ Агент отвечает на сообщения
✅ Агент может выполнять действия
✅ Журналы приложений не показывают ошибок
✅ Работа наблюдаемости в административном центре

Если ваш экземпляр агента работает не так, как ожидается, ознакомьтесь с разделом «Устранение неполадок » для подробных решений распространённых проблем.

Проверьте, что конфигурация портала разработчика сохранена

Перейдите к: https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

✅ Тип агента показывает: API✅Уведомление на основе URL совпадает с конечной ✅ точкой сообщения вашего агента Показывает сохраненное сообщение успешно

Агент Verify появляется в Teams

  1. Приложения >

  2. Ищите имя вашего агента

    ✅ Агент появляется в результатах ✅ поиска Показывает иконку и описание вашего агента

Убедитесь, что можно создать агента для команд

Выберите своего агента в приложениях Teams

✅ Кнопка Запросить экземпляр/Создать экземпляр включена ✅ Можно запрашивать экземпляр без ошибок

Верификовать создание экземпляра агента

После выбора экземпляра запроса:

✅ Запрос успешно отправляется администратору

Пользователь агента Verify, появляется в организации

В Центр администрирования Microsoft 365:

  1. Перейдите по адресу https://admin.cloud.microsoft/#/agents/all
  2. Перейти на вкладку « Запросы всех агентов»

✅ Ваш запрос на экземпляр агента указан как состояние ожидающего рассмотрения ✅ . Администратор может одобрить экземпляр агента для использования ✅ . Пользователь может создать экземпляр из Teams и дать ему имя.

Агент проверяет ответы на сообщения

В чате Teams с вашим агентом — отправьте тестовое сообщение: Hello!

✅ Агент показывает индикатор ✅ набора. Агент отвечает в течение нескольких секунд ✅ . Ответ связен и актуален.

Агент верификации может выполнять действия

Если вы настраиваете инструменты, проверьте их функциональность. Например, если вы добавили сервер Mail MCP, отправьте себе тестовое письмо.

Агент должен:

✅ Подтвердить запрос ✅ Выполнить вызов ✅ инструмента Подтвердить успешное завершение

Проверяйте, что письмо приходит на ваш почтовый ящик.

Проверка функциональности

Следующий чек-лист предлагает систематический подход к тестированию для вашего агента:

Базовая функциональность:

✅ Агент отвечает на простые приветствия. ✅ Агент ведёт многошаговые разговоры. ✅ Агент даёт соответствующие ответы.

Функциональность инструмента:

Зависит от конфигурации сервера MCP

✅ Могу отправлять письма. ✅ Могу получить доступ к календарю. ✅ Можно искать документы. ✅ Может выполнять настроенные действия.

Обработка ошибок:

✅ Обрабатывает недействительные запросы с достоинством. ✅ Предоставляет полезные сообщения об ошибках. ✅ Не вылетает при неожиданном вводе.

Производительность:

✅ Отвечает через несколько секунд. ✅ Ошибок тайм-аута не было. ✅ Стабильное время отклика.

Проверьте журналы приложений

Чтобы узнать, что делает ваш агент, проверьте логи приложений, используя команду log tail в az webapp .

# Real-time logs from Azure
az webapp log tail --name <your-web-app> --resource-group <your-resource-group>

На что обращать внимание в логах:

✅Входящие запросы от Teams ✅ Успешные вызовы ✅ инструментов ✅ аутентификации Отправленные ❌ ответы Сообщения об ошибках или исключениях

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

После того как ваш агент начнёт работать:

  1. Перейдите к: https://admin.cloud.microsoft/#/agents/all

  2. Выберите своего агента и откройте вкладку «Активность ».

    Вы должны увидеть:

    ✅ Сессии появляются. ✅ Каждая сессия показывает триггеры и действия. ✅ Вызовы инструментов регистрируются с временными метками.

Дальнейшие шаги

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

Жизненный цикл разработки вашего агента завершен, но его влияние только начинается. Большая часть того, что вы создали в жизненном цикле разработчика Agent 365, является открытый код и приветствует вклад сообщества. Вызывайте баги, запросы на функции и pull requests:

  • Agent 365 Samples: Есть интересные и интересные агенты для сэмплов? Поделитесь своим агентским кодом с сообществом открытый код здесь!
  • Node.js SDK: SDK Agent 365 в Node.js.
  • Python SDK: SDK Agent 365 в Python году.
  • .NET SDK: SDK Agent 365 в C# (.NET).
  • Agent 365 DevTools CLI: CLI, который поможет вам пройти весь жизненный цикл разработки Agent 365.

Устранение неполадок

В этом разделе содержатся распространённые проблемы при создании и тестировании экземпляров агентов.

Подсказка

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

Агент не появляется в Teams

Симптом: Агент отображается в административном центре, но в приложениях Teams его нельзя.

Коренная причина: Отсутствует конфигурация Developer Portal.

Solution:

  1. Получите свой Blueprint ID — a365.generated.config.json ищите agentBlueprintId.

  2. Настройка в Developer Portal:

    1. Перейдите по адресу https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

    2. Установите тип агента на API

    3. Установите URL уведомления на конечную точку обмена сообщениями вашего агента. Найдите messagingEndpoint значение в a365.generated.config.json.

    4. Нажмите кнопку "Сохранить".

  3. Подождите 5–10 минут для распространения.

Проверка

  • Открытые приложения > Teams > Поиск вашего агента.
  • Агент появляется и доступен для добавления.

Нельзя создать экземпляр агента в Teams

Симптом: Агент появляется в Teams, но вы не можете добавить или создать экземпляр; Кнопка запроса экземпляра не работает.

Коренная причина: Microsoft Agent 365 Frontier не включён для арендатора.

Решение: Свяжитесь с вашим администратором арендаторов, чтобы убедиться Microsoft Agent 365 Frontier включён для арендатора.

Дополнительные сведения о Frontier.

Проверка

Функции Frontier появляются в приложениях Microsoft 365 Copilot и Microsoft 365, как только ваша лицензия и настройки администратора это позволяют.

Агент не отвечает на сообщения

Симптом: Вы создаёте экземпляр агента, но он не отвечает на сообщения. В приложении нет логов.

Коренная причина: Несколько возможных причин — проблемы с конечными точками сообщений, проблемы с аутентификацией или ошибки в конфигурации.

Основы устранения неполадок

  1. Проверьте, что веб-приложение запущено:

    az webapp show --name <your-app-name> --resource-group <your-resource-group> --query state
# Should be: "Running"

  2. Проверьте конечную точку обмена сообщениями:

    • Это должно быть: https://<your-app-root-url>/api/messages
    • Проверьте это в a365.config.json и a365.generated.config.json

  3. Тестируйте конечную точку напрямую:

    curl https://<your-app-root-url>/api/messages
# Should not return 404

  4. Проверьте журналы заявок:

    az webapp log tail --name <your-app-name> --resource-group <your-resource-group>
# Look for incoming requests and errors

Расширенная диагностика

  1. Проверка подлинности:

    • Проверьте, истекли ли токены сроки действия. Продлевайте их, если потребуется.
    • Проверьте учетные данные в конфигурации веб-приложения.

  2. Проверьте конфигурацию инструмента/MCP:

    • Проверьте, что MCP-серверы настроены.
    • Разрешения на проверку предоставлены.

  3. Тестируйте локально:

    • Запускайте агента локально с той же конфигурацией.
    • Пробуй тест в Agents Playground.
    • Это работает локально, но не в облачном > развертывании.

Распространенные решения

  • Конечная точка сообщений неверна: Обновление в Azure портале и портале разработчиков.
  • Веб-приложение остановилось: Запустите с помощью Azure портала или CLI.
  • Токен истёк: Обновлять токены в переменных среды Web App.
  • Отсутствуют переменные окружения: Проверьте настройки приложения в Azure портале.
  • Проблемы с сервером MCP: Проверьте принцип сервиса и разрешения.
  • Ошибки кода: Проверьте журналы приложений на наличие исключений.

Проверка

Отправьте сообщение своему агенту в Teams и проверьте журналы заявок на наличие входящих запросов.

Вам также стоит попробовать:

Сбой вызовов инструментов

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

Коренная причина: Отсутствуют разрешения MCP-сервера, не настроен принципал сервиса, проблемы с сетевым подключением или неправильная конфигурация инструмента.

Solutions

Попробуйте следующие решения, когда вызов инструментов не удаётся:

  • Проверьте права в административном центре

    Проверьте и одобрите необходимые разрешения на сервер MCP:

    • Перейдите по адресу https://admin.cloud.microsoft/#/agents/all
    • Выберите разрешения вашего агента >
    • Убедитесь, что в списке есть и утверждены необходимые серверы MCP

  • Принцип проверки сервиса

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

    # Download and run:
# https://github.com/microsoft/Agent365-devTools/blob/main/scripts/cli/Auth/New-Agent365ToolsServicePrincipalProdPublic.ps1

  • Проверьте конфигурацию конечных точек MCP

    Убедитесь, что вы используете производственный MCP-эндпоинт:

    # Should be production endpoint, not mock
MCP_PLATFORM_ENDPOINT=https://agent365.svc.cloud.microsoft

  • Проверьте управляемую личность

    Проверьте, что управляемая личность включена в вашем веб-приложении:

    # Verify managed identity is enabled
az webapp identity show --name <your-app-name> --resource-group <your-resource-group>

Проверка

Вызовы инструмента тестирования через Teams и проверяйте логи на успешное выполнение.

Вам также стоит попробовать следующие шаги:

Передача лицензии не проходит

Симптом: Вы не можете назначить лицензию пользователю агента. Ошибки лицензий вы видите в административном центре.

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

Solutions

Попробуйте следующие решения, если присвоение лицензии не удаётся:

  1. Доступны лицензии для проверки:

    • Проверьте Центр администрирования Microsoft 365 >Billing>Licenses.
    • Убедитесь, что Microsoft Agent 365 Frontier включён для арендатора.

  2. Назначайте лицензию вручную:

    • Перейдите на Центр администрирования Microsoft 365 >Users.
    • Найдите пользователя агента.
    • Присваивайте соответствующую лицензию.

  3. Необходимые лицензии для полной функциональности:

    • Microsoft 365 E5 (или эквивалент).
    • Команды Энтерпрайз.
    • Microsoft 365 Copilot (для функций Copilot).

Проверка

Проверьте, отображаются ли в профиле пользователя в административном центре назначенные лицензии.

  • Last updated on