Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 |
|---|---|
| Compilar y ejecutar agente |
Autenticación CLI del Agente 365 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 Agregar y administrar herramientas |
| Plano del agente de configuración | Plano del Agente de Instalación |
| Desplegar |
Implementación del agente en Azure Desplegar el agente en Amazon Web Services (AWS) Despliega el agente en Google Cloud Platform (GCP) |
| Publicar agente en el centro de administración de Microsoft 365 | Publicar agente en el centro de administración de Microsoft |
| Crear instancias de agente | Crear instancias de agente |
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
- Vaya a https://entra.microsoft.com>Registros de aplicaciones>Todas las aplicaciones.
- Buscar su
agentBlueprintId.
Solucionar problemas de autenticación de CLI
La configuración de Agent 365 utiliza la aplicación empresarial Agent 365 CLI administrada por Microsoft cuando está disponible y recurre en su defecto a una aplicación personalizada propia del inquilino. Para ver los pasos completos de comportamiento y verificación, véase autenticación Microsoft Entra.
| Síntoma | Resolution |
|---|---|
| No se encuentra la aplicación gestionada por Microsoft | Actualiza la CLI y ejecuta a365 setup requirements. Busca en Aplicaciones empresariales el identificador de la aplicación f54280f4-395e-4ea8-9e48-bf2d4952aa14. Si el despliegue por fases no ha llegado a tu inquilino, usa la aplicación de respaldo personalizada. |
AADSTS530035 Durante la autenticación por código de dispositivo |
Los valores predeterminados de seguridad o el acceso condicional bloquean el código del dispositivo. No desactives la política de seguridad de la organización. Ejecuta la CLI en Windows nativo para usar WAM, o trabaja con tu administrador de identidad para usar una aplicación personalizada aprobada y propiedad del inquilino. |
AADSTS70007 Durante la autenticación |
Actualización a la última CLI. Las versiones anteriores podían usar un modo de respuesta del navegador no soportado con la aplicación gestionada por Microsoft. |
| Faltan los ámbitos delegados requeridos | Vuelva a ejecutar a365 setup requirements . No modifiques la aplicación gestionada por Microsoft ni crees una concesión de permiso local para el inquilino. Si usas una aplicación propiedad del inquilino, sigue La validación de la CLI falla durante la configuración. |
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 .NET 8.0 instalado
✅ CLI de Azure instalado y autenticado
✅ Permisos obligatorios de Entra asignados
✅Aplicación empresarial Agent 365 CLI gestionada por Microsoft disponible, o aplicación cliente personalizada 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 Id. generados, como el ID de plano técnico 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: