Ejecución de código de Agent Engine

Muchas tareas de los agentes, como los cálculos financieros y los flujos de trabajo de ciencia de datos, requieren que un agente genere y ejecute código. La ejecución de código de Agent Engine permite que tu agente ejecute código en un entorno aislado, seguro y gestionado.

Las funciones de ejecución de código incluyen lo siguiente:

  • Los entornos de pruebas se pueden crear y ejecutar código en menos de un segundo.

  • Las sandboxes admiten archivos de entrada y salida de hasta 100 MB para toda la solicitud o respuesta.

  • Los entornos de pruebas mantienen su estado de ejecución (memoria) durante un máximo de 14 días. Este ajuste de tiempo de vida (TTL) se puede configurar.

Ejecución de código forma parte de la suite de Agent Engine. Sin embargo, no es necesario que implementes tu agente en Agent Engine para usar la ejecución de código. Tu agente puede ejecutarse en cualquier lugar, incluso de forma local.

La ejecución de código funciona con cualquier framework de agente y cualquier modelo generativo.

Estas son las principales operaciones para trabajar con un sandbox de ejecución de código:

  • Crear entorno aislado: crea un espacio seguro y aislado para ejecutar código no fiable o potencialmente dañino. Este aislamiento reduce los riesgos de seguridad, ya que evita que el código acceda a los recursos, archivos o redes de tu sistema. Un entorno aislado es fundamental cuando necesitas ejecutar código de forma segura, como en el caso de los agentes de ciencia de datos, las secuencias de comandos de orquestación o las pruebas durante el desarrollo. El espacio aislado ofrece un sistema de archivos limitado y no tiene acceso a la red.

  • Get sandbox: muestra la configuración y el estado de un entorno aislado de ejecución de código específico. Puedes consultar detalles como su estado actual (por ejemplo, si está en ejecución o detenido) y el tiempo de vida (TTL). De esta forma, puedes monitorizar tus sandboxes y verificar su estado antes o después de ejecutar el código.

  • List sandboxes: muestra todas las sandboxes de ejecución de código de tu proyecto. Puedes filtrar los resultados por criterios como el estado o el tipo de zona de pruebas. Esto te ayuda a comprobar, monitorizar y gestionar muchas sandboxes en tu proyecto.

  • Ejecutar código: envía tu código junto con los archivos de entrada necesarios al espacio aislado para que se ejecute de forma segura. La respuesta incluye los resultados, como la salida estándar (stdout), el error estándar (stderr) y los archivos que genere el código. El sandbox también puede mantener el estado, lo que permite que las llamadas Execute Code posteriores se basen en las anteriores. Esto es fundamental para las sesiones interactivas o las tareas complejas que necesitan que el entorno mantenga el estado en varias ejecuciones de código.

Siguientes pasos