Руководство по устранению неполадок в Agent 365

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

Действия по устранению неполадок

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

Стадия Ресурсы по устранению неполадок
Сборка и запуск агента Аутентификация CLI Agent 365
Agent 365 CLI
Регистрация пользовательского клиентского приложения для Agent 365 CLI
Сервер имитации инструментов
Наблюдаемость агентов
Тестирование агентов
Тестирование агентов с использованием туннеля разработки
Добавление инструментов и управление ими
Настройка схемы агента Настройка схемы агента
Развернуть Развернуть агента на Azure
Развертывание агента в Amazon Web Services (AWS)
Развертывание агента в Google Cloud Platform (GCP)
Публикация агента в Центре администрирования Microsoft 365 Публикация агента в Центре администрирования Microsoft
Создание экземпляров агента Создание экземпляров агента

Справочник диагностических команд

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

Проверка CLI и конфигурации

Используйте следующие команды для проверки CLI и конфигурации.

# Verify CLI is installed and check version
a365 --version

# Display current configuration
Get-Content a365.config.json | ConvertFrom-Json

# Display generated configuration (after setup)
Get-Content a365.generated.config.json | ConvertFrom-Json

Проверка ресурсов Azure

Используйте следующие команды для диагностики ресурсов Azure и статуса приложения.

# Set these variables with appropriate data for your app
$resource-group = <your-resource-group>
$app-name = <your-app-name>

# Authenticate with Azure
az login

# List resources in your resource group
az resource list --resource-group $resource-group --output table

# Check Web App status
az webapp show --name $app-name --resource-group $resource-group --query state

# View Web App logs (real-time)
az webapp log tail --name $app-name --resource-group $resource-group

Проверка схемы агента

Убедитесь, что схема агента существует и правильно настроена.

# Check if blueprint ID is set
Get-Content a365.generated.config.json | Select-String "agentBlueprintId"

Проверка схемы в Microsoft Entra

  1. Выберите https://entra.microsoft.com>Регистрации приложений>Все приложения.
  2. Выполните поиск по своему agentBlueprintId.

Диагностика аутентификации CLI

Настройка Agent 365 использует управляемое Microsoft корпоративное приложение CLI Agent 365 и возвращается к пользовательскому приложению, принадлежащему арендатору. Для полных шагов по поведению и верификации см. раздел аутентификации Microsoft Entra.

Симптом Резолюция
Приложение, управляемое Microsoft, не найдено Обновите CLI и запустите a365 setup requirements. Поиск корпоративных приложений по идентификатору f54280f4-395e-4ea8-9e48-bf2d4952aa14приложений. Если поэтапное развертывание не дошло до вашего арендатора, используйте резервный вариант пользовательского приложения.
AADSTS530035 Во время аутентификации кода устройства Стандартные настройки безопасности или условный доступ блокируют код устройства. Не отключайте политику безопасности организации. Запустите CLI на родной Windows для WAM или работайте с администратором идентичности для использования одобренного пользовательского приложения, принадлежащего арендатору.
AADSTS70007 Во время аутентификации Обновление до последнего CLI. Старые версии могли использовать неподдерживаемый режим отклика браузера с приложением, управляемым Microsoft.
Требуемые делегированные области отсутствуют Еще раз запустите a365 setup requirements. Не изменяйте приложение, управляемое Microsoft, и не создавайте для него разрешение с локальным арендатором. Если вы используете приложение, принадлежащее арендатору, следите за ошибками проверки CLI во время настройки.

Рекомендации по профилактике

Используйте эти рекомендации, чтобы избежать распространенных проблем и упростить устранение неполадок.

Перед началом работы

Контрольный список предварительных требований:

✅ .NET 8.0 SDK установлен
✅ Azure CLI установлен, аутентификация пройдена
✅ Назначены необходимые разрешения Entra
✅Доступно корпоративное приложение Agent 365 CLI под управлением Microsoft или пользовательское клиентское приложение, настроенное
✅ В арендаторе включена поддержка Microsoft Agent 365 Frontier

Команды валидации:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

В процессе разработки

Сохраняйте свои конфигурации:

  • Храните резервные копии файлов конфигурации.
  • Документируйте свои решения по настройке.
  • Сохраняйте сгенерированные идентификаторы, такие как ИД схемы и ИД управляемого удостоверения.

Обновляйте CLI:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

Тестируйте инкрементно:

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

Перед развертыванием

Контрольный список перед развертыванием:

✅ Агент работает локально с Agents Playground.
✅ Все переменные среды документированы.
✅ Файлы конфигурации зафиксированы в системе контроля версий.
✅ MCP-серверы настроены и протестированы.
✅ Наблюдаемость включена и проверена.

Получите дополнительную помощь

Чтобы просматривать примеры кода, сообщать о проблемах или искать существующие проблемы, используйте следующие репозитории:

  • Last updated on