Solución de problemas de ejecución de código

En esta sección se describen los problemas habituales y sus soluciones al trabajar con la ejecución del código de Agent Engine.

Problemas con la creación de un entorno aislado

  • Error de permisos: si se producen errores al crear un sandbox, asegúrate de que tu Google Cloud proyecto tenga el rol de gestión de identidades y accesos (IAM) de usuario de Vertex AI(roles/aiplatform.user).

  • ID de proyecto o ubicación no válidos: compruebe que las variables PROJECT_ID y LOCATION que se usan en su código sean correctas y compatibles. Para ver una lista de las regiones admitidas, consulta Regiones admitidas.

  • No se ha creado Agent Engine: antes de crear un sandbox, confirma que la instancia de Agent Engine se ha creado correctamente. El método agent_engine.create() debe completarse sin errores.

Problemas de ejecución de código

  • Errores de código: revisa el resultado stderr de la respuesta execute_code para identificar errores de sintaxis, excepciones de tiempo de ejecución o fallos lógicos en tu código.

  • Problemas de E/S de archivos:

    • No se ha encontrado el archivo: asegúrate de que se haga referencia correctamente a los archivos de entrada especificados en la files matriz de tu input_data en el código. El código se ejecuta en la misma carpeta que los archivos y no puede acceder a otras carpetas.

    • No se ha generado el archivo de salida: comprueba que tu código esté escribiendo en el nombre de archivo de salida esperado y que no haya errores que impidan la creación o la escritura del archivo.

    • Límites de tamaño: los archivos no pueden superar los 100 MB.

  • Persistencia del estado: si tu código depende de un estado anterior, comprueba que estés usando el mismo sandbox_name en las llamadas posteriores. Además, asegúrate de que el sandbox no haya caducado.

  • Tiempo de espera: la ejecución del código se agota al cabo de 300 segundos. Te recomendamos que optimices el código para mejorar el rendimiento o que dividas las tareas complejas en pasos más pequeños y fáciles de gestionar.

Gestión y limpieza de entornos de pruebas

  • No se ha encontrado el entorno aislado que se quiere eliminar: si no puedes eliminar un entorno aislado, asegúrate de que el sandbox_name que estás usando es correcto y de que el entorno aislado sigue existiendo.

  • No se ha encontrado el Agent Engine que se va a eliminar: al igual que con las sandboxes, comprueba el agent_engine_name cuando intentes eliminar el Agent Engine.

  • Cuotas de recursos: si creas muchas sandboxes o realizas ejecuciones con frecuencia, es posible que alcances los límites de las cuotas de recursos. Consulta las cuotas de tu proyecto para los servicios de Vertex AI y solicita aumentos si es necesario. Para ver una lista de las cuotas de Agent Engine, consulta Cuotas.