Troubleshooting

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 User o Cognitive 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.10 a 3.15. Python 3.10 sigue siendo compatible con esta versión, pero está desaconsejado, ya que Python 3.10 original alcanzó el final de la vida útil. Utilice Python 3.11 o posterior para entornos nuevos 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 funciona correctamente con un conjunto de características reducido: Redis e Hyperlight no están instalados y el AG-UI A2UI adicional no está disponible. 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 está usando Go 1.25 o una versión 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.

Pasos siguientes