Nota
L'accés a aquesta pàgina requereix autorització. Podeu provar d'iniciar la sessió o de canviar els directoris.
L'accés a aquesta pàgina requereix autorització. Podeu provar de canviar els directoris.
Importante
Debe formar parte del programa de versión preliminar Frontier 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 previsualización existentes de sus 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 |
|---|---|
| Compilar y ejecutar agente |
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 de Agent 365 |
Configurar la configuración del Agente 365 Agregar y administrar herramientas |
| Esquema del agente de configuración | Plano del Agente de Instalación |
| Desplegar |
Deploy agent to Azure Desplegar el agente en Amazon Web Services (AWS) Despliega el agente en Google Cloud Platform (GCP) Comando de la CLI deploy del agente 365 |
| Publicar 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 |
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
a365 config display
# Display generated configuration (after setup)
a365 config display -g
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
a365 config display -g | Select-String "agentBlueprintId"
Comprobación del plano técnico en Microsoft Entra
- Vaya a https://entra.microsoft.com>App registrations>Todas las aplicaciones.
- 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
✅ 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.
- 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: