Guía de solución de problemas de Agent 365

Utilice esta guía para diagnosticar y resolver problemas a lo largo de todo el ciclo de vida del desarrollo de Agent 365. Utilice este artículo como punto de partida para la resolución de problemas y luego diríjase a secciones específicas para obtener soluciones detalladas.

Pasos de la solución de problemas

En esta tabla, cada vínculo proporciona pasos de solución de problemas para áreas específicas. El contenido se organiza por la etapa del ciclo de vida de desarrollo del SDK de Agent 365.

Referencia de comandos de diagnóstico

Antes de abordar problemas específicos, utilice estos comandos para comprobar el estado actual de su entorno de Agent 365:

Comprobar la CLI y la configuración

Utilice estos comandos para validar su CLI y la configuración.

# 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

Verificar los recursos de Azure

Utilice estos comandos para inspeccionar los recursos de Azure y el estado de la aplicación.

# 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

Verificar el plano del agente

Verifique que el blueprint de su agente exista y esté correctamente configurado.

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

Verificar blueprint en Microsoft Entra

1. Vaya a https://entra.microsoft.com>Registros de aplicaciones>Todas las aplicaciones.
2. Buscar su agentBlueprintId.

Procedimientos recomendados preventivos

Utilice estas recomendaciones para evitar problemas comunes y agilizar la resolución de problemas.

Antes de comenzar

Lista de comprobación de los requisitos previos:

✅ SDK .NET 8.0 instalado
✅ CLI de Azure instalada y autenticada
✅ Permisos obligatorios de Entra asignados
✅ Aplicación cliente personalizada creada y configurada
✅ Tenant habilitado para Microsoft Agent 365 Frontier

Comandos de validación:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Durante el desarrollo

Guarde sus configuraciones:

• Haga copias de seguridad de los archivos de configuración.
• Documente sus decisiones de configuración.
• Guarda los Id. generados, como el ID de plano técnico y el Id. de identidad gestionada.

Mantenga la CLI actualizada:

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

Prueba de forma incremental:

• Prueba después de cada paso importante.
• Verifique el éxito antes de seguir adelante.
• Mantenga las configuraciones operativas.

Antes de la implementación

Lista de comprobación previa a la implementación:

✅ El agente funciona localmente con Agents Playground.
✅ Todas las variables de entorno documentadas.
✅ Archivos de configuración comprometidos en control de versiones.
✅ Servidores MCP configurados y probados.
✅ Observabilidad habilitada y verificada.

Obtener ayuda adicional

Para revisar código de muestra, reportar problemas o buscar problemas existentes, utilice estos repositorios:

• Muestras de Agent 365
• Agent 365 DevTools (CLI)
• Agent 365 SDK - .NET
• Agent 365 SDK - Python
• SDK de Agent 365 - Node.js