Solución de problemas de Framework de agentes

Vista previa

Agent Framework es una oferta de vista previa, sujeta a las “Condiciones de las ofertas de fase previa a la DG” de las Condiciones específicas del servicio deGoogle Cloud . Los productos y las características anteriores a la disponibilidad general pueden tener asistencia limitada, y es posible que los cambios en estos productos y características no sean compatibles con otras versiones de la fase previa a la DG. Para obtener más información, consulta las descripciones de la etapa de lanzamiento. Además, si usas Agent Framework, aceptas los términos y condiciones de la vista previa de Generative AI (“Términos de la vista previa”).

En esta página, encontrarás ayuda para diagnosticar y resolver problemas habituales cuando trabajes con el Agente Framework.

En esta página, encontrarás lo siguiente:

• Instalación y configuración
• Problemas con la definición de agentes
• Problemas de ejecución
• Fallas de implementación
• Problemas de evaluación
• Mensajes de error comunes (opcional)

Instalación y configuración

Problemas comunes: Fallas de instalación, errores de importación y problemas de autenticación de la API

Verifica lo siguiente:

• Versiones de Python y pip
• Integridad y ruta de acceso del archivo .whl
• Configuración del archivo .env (claves de API, detalles del proyecto)
• Configuración de gcloud auth (para Vertex AI)
• Instalación de dependencias (requirements.txt)
• Activación del entorno virtual

Problemas con la definición del agente

Problemas comunes: El agente no se comporta como se espera, no se llama a las herramientas, hay errores en agent.py.

Verifica lo siguiente:

• Sintaxis de código agent.py (linting)
• Claridad y exactitud del agente instruction
• Definiciones de las herramientas (nombres, descripciones y parámetros)
• Atributos del agente (name, model, tools, flow): errores tipográficos y validez
• Lógica de código dentro de agent.py: Usa instrucciones de impresión para la depuración

Problemas de ejecución

Problemas habituales: Los comandos de CLI fallan (af run, af web, af test), hay errores en la IU web y problemas con el servidor de la API.

Verifica lo siguiente:

• Sintaxis y argumentos de los comandos de la CLI (--help)
• Directorio de trabajo (raíz del proyecto del agente)
• Mensajes de error de la terminal (copiar errores completos)
• Conflictos de puertos (para la IU web o el servidor de la API, prueba con diferentes puertos)
• Compatibilidad del navegador (para la IU web)
• Errores de la consola del navegador (para la IU web)

Problemas con la evaluación

Problemas habituales: Fallas en las pruebas, resultados de evaluación inesperados.

Verifica lo siguiente:

• Sintaxis de archivo *.test.json (JSON válido)
• Contenido del archivo de prueba (consultas, expected_tool_use, precisión de reference)
• Rutas de acceso de archivos en el comando af test o el código pytest
• Criterios de evaluación en test_config.json (si se usan)
• Ejecuta pruebas en la IU web para obtener comentarios visuales

Mensajes de error comunes

• Problema de instalación
• Problema con la clave de API o la autenticación
• Atributo model incorrecto
• Conflicto de puertos en el servidor web o de la API

Sugerencias generales para solucionar problemas:

• Simplifica y aisla: Empieza de forma simple y agrega complejidad de forma gradual.
• Verifica los registros: Terminal, Registros de Cloud y Consola del navegador.
• Consulta la documentación: Vuelve a leer las secciones relevantes.
• Buscar en línea: Stack Overflow, foros
• Proporcionar información detallada cuando solicites ayuda: código, errores, pasos y entorno