Guía de solución de problemas del Agente 365

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

Pasos para solucionar problemas

Cada uno de los enlaces de esta tabla proporciona pasos de solución de problemas para áreas específicas. El contenido está agrupado por la etapa del ciclo de desarrollo del SDK del Agente 365.

Comandos de referencia de diagnóstico

Antes de adentrarte en problemas específicos, utiliza estos comandos para comprobar el estado actual de tu configuración de Agent 365:

Comprobar la CLI y la configuración

Usa estos comandos para validar tu CLI y 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

Comprobación de los recursos de Azure

Use estos comandos para inspeccionar Azure recursos y 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

Confirma que la plantilla de tu agente existe y está correctamente configurada.

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

Comprobación del plano técnico en Microsoft Entra

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

Mejores prácticas preventivas

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

Antes de comenzar

Lista de requisitos previos:

SDK de ✅ .NET 8.0 instalado
✅ CLI de Azure instalado y autenticado
✅ 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

Guarda tus configuraciones:

• Haz copias de seguridad de los archivos de configuración.
• Documenta tus elecciones de configuración.
• Guarda los IDs generados, como el ID de blueprint y el ID de identidad gestionada.

Mantén la CLI actualizada:

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

Evalúa de forma incremental:

• Prueba después de cada paso importante.
• Verifica el éxito antes de seguir adelante.
• Mantén las configuraciones actuales.

Antes de la implementación

Lista de verificación previa al despliegue:

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

Busca ayuda adicional

Para revisar código de ejemplo, reportar problemas o buscar problemas existentes, utiliza estos repositorios:

• Muestras del Agente 365
• Herramientas de desarrollo (CLI) del Agente 365
• SDK de Agent 365: .NET
• SDK de Agent 365: Python
• SDK del agente 365 - Node.js