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

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

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

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

Стадия Устранение неполадок содержимого
Build and run agent Агент 365 CLI
Регистрация пользовательского клиента для Agent 365 CLI
Сервер имитационного инструмента
Наблюдаемость агента
Тестовые агенты
Тестовые агенты с помощью туннелей разработчиков
Добавляйте и управляйте инструментами
Чертеж агента настройки Чертеж агента настройки
Развернуть Развернуть агента на Azure
Развернуть агента в Amazon Web Services (AWS)
Развернуть агента в Google Cloud Platform (GCP)
Агент публикации в Microsoft 365 Admin Center Агент публикации в административный центр 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

Verify Azure resources

Используйте эти команды для проверки ресурсов 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
✅ Создано и настроено пользовательское клиентское приложение
✅ Tenant включен для Microsoft Agent 365 Frontier

Команды проверки:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Во время разработки

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

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

Держите CLI в курсе:

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

Тестируйте поэтапно:

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

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

Чек-лист перед развертыванием:

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

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

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

  • Last updated on