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

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

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

Каждая ссылка в этой таблице предоставляет шаги по устранению неполадок для конкретных областей. Ресурсы сгруппированы по этапам жизненного цикла разработки с использованием SDK 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.

Профилактические рекомендации

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

Перед началом

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

✅ .NET 8.0 SDK установлен
✅ Azure CLI установлен, аутентификация пройдена
✅ Назначены необходимые разрешения Entra
✅ Создано и настроено пользовательское клиентское приложение
✅ В арендаторе включена поддержка 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