Compartir a través de

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

Importante

Necesitas formar parte del programa Frontier preview para obtener acceso anticipado a Microsoft Agent 365. Frontier te conecta directamente con las últimas innovaciones de IA de Microsoft. Las previsualizaciones de Frontier están sujetas a los términos de vista previa existentes en tus acuerdos con clientes. Como estas funciones aún están en desarrollo, su disponibilidad y capacidades pueden cambiar con el tiempo.

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.

Etapa Contenido de solución de problemas
Build y run agent Agente 365 CLI
Registro personalizado de la aplicación cliente para la CLI del Agente 365
Servidor de herramientas simuladas
Observabilidad del agente
Agentes de prueba
Agentes de prueba utilizando Dev Tunnels
Configuración del Agente de Configuración 365 Configurar la configuración del Agente 365
Agregar y administrar herramientas
Plano del agente de configuración Plano del Agente de Configuración
Desplegar Deploy agent to Azure
Desplegar el agente en Amazon Web Services (AWS)
Despliega el agente en Google Cloud Platform (GCP)
Publicar el agente en el centro de administración de Microsoft 365 Publicar el agente en el centro de administración de Microsoft
Crear instancias de agente Crear instancias de agente

Referencia de comandos diagnósticos

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
a365 config display

# Display generated configuration (after setup)
a365 config display -g

Verify Azure resources

Usa estos comandos para inspeccionar los recursos de Azure y el estado de la app.

# 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 el blueprint de tu agente existe y está correctamente configurado.

# Check if blueprint ID is set
a365 config display -g | Select-String "agentBlueprintId"

Verificar blueprint en Microsoft Entra

  1. Ir a https://entra.microsoft.com>Registros de aplicaciones Todas>las solicitudes.
  2. Busca tu agentBlueprintIdarchivo .

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:

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

Evalúa de forma incremental:

  • Prueba después de cada paso importante.
  • Verifica el éxito antes de seguir adelante.
  • Sigue funcionando con configuraciones.

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:

  • Last updated on