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.
En esta página se tratan problemas y soluciones comunes al trabajar con Agent Framework.
Note
Esta página se está reestructurando. Se agregarán escenarios comunes de solución de problemas.
Problemas comunes
Errores de autenticación
Asegúrese de que tiene configuradas las credenciales correctas para el proveedor de IA. Para Azure OpenAI, compruebe lo siguiente:
- La CLI de Azure está instalada y autenticada (
az login) - El usuario tiene el rol de
Cognitive Services OpenAI UseroCognitive Services OpenAI Contributor
Problemas de instalación de paquetes
Asegúrese de que usa el SDK de .NET 8.0 o posterior. Ejecute dotnet --version para comprobar la versión instalada.
Agent Framework admite Python 3.11 a 3.15. Python 3.10 ya no se admite ni se prueba en Python 1.24, aunque los metadatos del paquete sigan permitiendo la instalación. Utilice Python 3.11 o posterior y ejecute python --version para comprobar el intérprete activo.
En Python 3.14 y 3.15, no se evalúan las expresiones declarativas de Power Fx. En Python 3.15, pip install agent-framework omite Redis porque RedisVL requiere una versión anterior de Python. Hyperlight 0.8, el extra A2UI de AG-UI y DuckDB 2.x son compatibles con Python 3.15. Si no se puede resolver una integración, compruebe su rango Requires-Python y use un intérprete compatible.
Para obtener más información, consulte la guía de cambios significativos de Python 2026.
Asegúrese de que usa Go 1.26 o posterior. Ejecute go version para comprobar la versión instalada. Si las dependencias no se resuelven, ejecute go mod tidy y compruebe que el módulo importa github.com/microsoft/agent-framework-go paquetes que existen en el SDK actual.
Obtener ayuda
Si no encuentra una solución aquí, visite nuestras discusiones de GitHub para obtener soporte técnico de la comunidad.