Тестовые агенты с помощью туннелей разработчиков

Используя Dev Tunnels, вы можете тестировать агента Agent 365 с помощью Microsoft 365 приложений (таких как Teams, Outlook или Word), пока ваш агент работает локально на вашей машине разработки. Этот подход объединяет локальную разработку и реальные тесты, чтобы вы могли проверить поведение агента в реальных средах Microsoft 365 перед развертыванием в облаке.

Предпосылки

Перед использованием Dev Tunnels убедитесь, что вы установили командную строку Dev Tunnels.

Настройте Dev Tunnel

Настройте Dev Tunnel, чтобы ваш локальный агент подвергал доступ к сервисам Microsoft 365.

Создайте и запустите туннель

  1. Войдите в Dev Tunnel:

    devtunnel user login

  2. Создайте постоянный туннель:

    devtunnel create --allow-anonymous

    Эта команда возвращает идентификатор туннеля. Сохраните этот идентификатор для будущего использования.

  3. Настройте порт туннеля:

    Назначьте порт, который использует ваш агент-сервер (обычно 3978):

    devtunnel port create <tunnel-id> -p <port-number>

  4. Запусти туннель:

    devtunnel host <tunnel-id>

    Команда отображает ваш URL туннеля (например, https://abc123xyz.devtunnels.ms:3978). Скопируйте этот URL для следующего шага.

Tip

Используйте devtunnel list для просмотра всех ваших туннелей и devtunnel delete <tunnel-id> удаления тех, которые вам больше не нужны.

Настройка конечной точки обмена сообщениями агентов

Зарегистрируйте свой URL Dev Tunnel (например, https://abc123xyz.devtunnels.ms:3978/api/messages) как конечную точку сообщений агента, чтобы Microsoft 365 знал, куда направлять сообщения. Не забудьте /api/messages добавить суффикс к конечной точке.

Пожалуйста, смотрите Set agent messaging endpoint

Тест с Microsoft 365

Когда ваш Dev Tunnel активен и конечная точка зарегистрирована, протестируйте своего агента в приложениях Microsoft 365.

Тестирование в Microsoft Teams

  1. Запустите локальный агент , используя инструкции в разделе «Установка зависимостей», и запустите сервер приложений агента.

  2. Проверьте тоннельную связь:

    devtunnel list

    Проверьте, показывает ли в вашем туннеле активные соединения. Столбец «Соединения с хостом» должен показывать число больше 0.

  3. Взаимодействуйте с вашим агентом в Teams:

    • Open Microsoft Teams (веб или десктоп)
    • В поисковой строке Teams найдите вашего агента по имени или электронной почте
    • Начните разговор с агентом
    • Отправьте сообщение и наблюдайте за ответом
    • Проверьте локальную консоль на наличие входящих запросов и активности агентов

Тестовые уведомления по электронной почте

Если ваш агент настроен на уведомления по электронной почте:

  1. Отправьте письмо на адрес электронной почты вашего агента
  2. Добавьте своего агента в копию в переписке
  3. Следите за локальной консолью на предмет веб-хука уведомлений
  4. Проверьте, как ваш агент обрабатывает и отвечает на письма

Интеграция Test Word

Для агентов, отвечающих на комментарии Word:

  1. Откройте документ Word, к которому ваш агент имеет доступ.
  2. Добавьте комментарий с упоминанием вашего агента.
  3. Проверьте уведомление в вашей локальной консоли.
  4. Проверьте, что ответ вашего агента появился в Word.

Мониторинг активности туннеля

Dev Tunnels предоставляет инспекцию трафика для отладки проблем с соединением и понимания потока запросов:

devtunnel show <tunnel-id>

Эта команда отображает:

  • Активные подключения и детали сессии.
  • Информация о запросах и ответах.
  • Статистика объёма трафика.
  • Ошибки соединения и предупреждения.

Вы также можете отслеживать активность туннеля в реальном времени, наблюдая за выходом devtunnel host команды.

Поддержание тоннельных соединений

Dev Tunnels требуют, чтобы devtunnel host процесс продолжал работать. Если неактивность, проблемы с сетью или переход компьютера в спящий режим приводят к прорыву соединения, нужно перезапустить его.

Проверьте состояние туннеля

Проверьте, активен ли ваш туннель:

devtunnel list

Выходные данные отображаются:

  • Идентификатор туннеля: ваш идентификатор туннеля
  • Хост-соединения: количество активных соединений (должно быть одно или несколько при devtunnel host работе)
  • Порты: Настроенные порты
  • Срок действия: Время исчерпания тоннеля

Если Host Connections показывает 0, туннель существует, но в данный момент не размещается.

Перезапусти отключённый туннель

Если соединение с туннелем пропадает, перезапустите его, используя тот же идентификатор туннеля:

devtunnel host <tunnel-id>

URL туннеля остаётся прежним, так что вам не нужно обновлять конфигурацию endpoint для обмена сообщениями агента.

Поддерживайте работу тоннелей во время разработки

Для поддержания стабильных соединений:

  • Держите окно терминала открытым — не закрывайте терминал при работе devtunnel host.
  • Предотвращение сна компьютера — настройте систему так, чтобы она оставалась в состоянии сна, во время тестовых сессий.
  • Следите за ошибками соединения — отслеживайте devtunnel host выход терминала на предмет сообщений о разрыве.
  • Перезагрузка после смены сети — если вы переключаете сеть или подключаетесь к VPN, перезапускайте туннель.

Tip

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

Очистка

Когда вы закончите тестирование с помощью туннелей разработчиков:

Остановите туннель

Нажмите Ctrl+C на запуск devtunnel host терминала, чтобы остановить туннель.

Эта команда удаляет URL Dev Tunnel с конечной точки обмена сообщениями вашего агента. При развертывании в продакшн установите URL конечной точки, размещённой в облаке.

Note

Туннель остаётся доступным для дальнейшего использования, пока вы не удалите его явно с помощью devtunnel delete <tunnel-id>.

Ограничения

Учитывайте эти ограничения при тестировании с туннелями разработчика:

  • Только для разработки: Используйте Dev Tunnels для разработки и тестирования, а не для продакшена.
  • Производительность: Ожидайте более высокой задержки по сравнению с облачными агентами из-за маршрутизации сети.
  • Стабильность соединения: Туннельные соединения иногда могут обрываться и требовать ручной перезагрузки.
  • Вопросы--allow-anonymous безопасности: Флаг удобен для тестирования, но не используйте его с конфиденциальными данными.
  • Управление сессиями: возможно, потребуется периодически повторную аутентификацию в зависимости от продолжительности сессии.

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

После успешного тестирования Dev Tunnel:

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

Если вы сталкиваетесь с проблемами во время тестирования через туннели разработчиков, начните здесь для общих исправлений туннелей, подключения и конечных точек. Для более широкой диагностики неполадок Agent 365 (настройка, аутентификация и обмен сообщениями) см. раздел Устранение неполадок.

Тоннельное соединение не удалось

Симптомы: Dev Tunnel не запускается и сразу отключается.

Решения:

  • Подтвердите, что вы вошли в систему: devtunnel user login
  • Проверьте, использует ли другой процесс тот же порт
  • Убедитесь, что ваш межсетевой экран поддерживает подключения к туннелю разработчиков
  • Удалить и заново создать туннель: devtunnel delete <tunnel-id> затем создать новый

Сообщения не доходят до местного агента

Симптомы: Microsoft 365 означает, что сообщение было отправлено, но ваш местный агент его не получил.

Решения:

  • Убедитесь, что ваш агент работает локально
  • Проверьте, что туннель активен: devtunnel list должно показаться «Подключено».
  • Проверьте конфигурацию конечной точки и a365.config.json убедитесь, что URL вашего туннеля разработчика установлен как конечная точка для обмена сообщениями
  • Проверьте логи туннеля разработчика в работе терминала devtunnel host на предмет ошибок соединения
  • Убедитесь, что ваш локальный порт совпадает с туннельным портом (оба по умолчанию должны быть 3978)

Ошибки аутентификации через Dev Tunnel

Симптомы: ошибки 401 или 403 при тестировании через Dev Tunnel.

Решения:

  • Проверка — аутентификация агента настроена (аутентификация токеном носителя не работает с туннелями разработчика для интеграции с Microsoft 365).
  • Проверьте данные агентского чертежа в a365.generated.config.json.
  • Убедитесь, что у вашего агента есть необходимые права на тестируемые операции.
  • Убедитесь, что ваши токены аутентификации не истекли.

URL туннеля изменён или истёк

Симптомы: Ранее работающий туннельный URL больше не направляется к вашему агенту.

Решения:

  • Проверьте статус туннеля с помощью devtunnel list.
  • Перезапустите туннель, используя devtunnel host <tunnel-id>.
  • Обновите конечную точку сообщения, если URL изменился, используя a365 setup blueprint --endpoint-only --m365.
  • Last updated on