Ejecución de código del motor del agente

Muchas tareas del agente, como los cálculos financieros y los flujos de trabajo de ciencia de datos, requieren que el 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 de zona de pruebas seguro, aislado y administrado.

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

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

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

  • Las zonas de pruebas mantienen su estado de ejecución (memoria) durante un máximo de 14 días. Este parámetro de configuración de tiempo de actividad (TTL) se puede configurar.

La Ejecución de código forma parte del paquete 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 agentes y cualquier modelo generativo.

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

  • Create sandbox: Crea un espacio seguro y aislado para ejecutar código no confiable o potencialmente dañino. Este aislamiento reduce los riesgos de seguridad, ya que evita que el código toque los recursos, los archivos o la red de tu sistema. Una zona de pruebas es fundamental cuando necesitas ejecutar código de forma segura, como para agentes de ciencia de datos, secuencias de comandos de orquestación o durante las pruebas de desarrollo. El entorno de pruebas 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 de pruebas de ejecución de código específico. Puedes consultar detalles como su estado actual (por ejemplo, en ejecución o detenido) y el tiempo de actividad (TTL). Esto te permite hacer un seguimiento de tus zonas de pruebas y verificar su estado antes o después de ejecutar el código.

  • List sandboxes: Enumera todas las zonas de pruebas de ejecución de código en tu proyecto. Puedes filtrar los resultados según criterios como el estado o el tipo de zona de pruebas. Esto te ayuda a verificar, supervisar y administrar muchas zonas de pruebas en tu proyecto.

  • Ejecutar código: Envía tu código junto con los archivos de entrada necesarios al entorno de pruebas para una ejecución segura. La respuesta incluye los resultados, como la salida estándar (stdout), el error estándar (stderr) y los archivos que genera el código. El entorno de pruebas 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.

¿Qué sigue?