View a markdown version of this page

Comience a usar Amazon Bedrock AgentCore Implementación directa de código en tiempo de ejecución - lecho rocoso amazónico AgentCore

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Comience a usar Amazon Bedrock AgentCore Implementación directa de código en tiempo de ejecución

Con la implementación directa de código, usted empaqueta el código del agente y sus dependencias en un archivo zip y lo implementa en AgentCore Tiempo de ejecución. Tu agente aún tiene que seguirte AgentCore Requisitos de tiempo de ejecución.

Tener el AgentCore Empaquete la CLI e implemente un CodeZip Runtime, consulte Comience con AgentCore Tiempo de ejecución con AgentCore CLI. Para crear el paquete de implementación manualmente, siga las guías específicas para cada idioma que aparecen a continuación o utilice otra utilidad de archivos.zip, como 7 zip. En los ejemplos que se muestran en las siguientes secciones se presupone que está utilizando una línea de comandos zip herramienta en un entorno Linux o macOS. Para usar los mismos comandos en Windows, puede instalar el subsistema de Windows para Linux para obtener un Windows-integrated versión de Ubuntu y Bash.

Tenga en cuenta que AgentCore Runtime usa los permisos de archivo POSIX, por lo que es posible que necesites establecer los permisos para la carpeta del paquete de despliegue antes de crear el archivo .zip.

Conceptos de implementación directa de código

Obtenga información sobre los conceptos clave a la hora de utilizar la implementación directa de código con Amazon Bedrock AgentCore Tiempo de ejecución.

Temas

    Amazon Bedrock AgentCore El tiempo de ejecución con implementación directa de código utiliza un modelo de responsabilidad compartida similar a AWS Lambda. AgentCore Runtime administra el entorno de ejecución del lenguaje y aplica los parches de seguridad automáticamente, mientras usted se centra en el código del agente y las dependencias.

    Si estás usando imágenes de contenedor para desplegar tus agentes , entonces AgentCore Runtime es responsable de parchear solo el kernel de procesamiento. En este caso, eres responsable de reconstruir la imagen del contenedor de tu agente a partir de la última imagen segura y de volver a implementar la imagen del contenedor.

    Esto se resume en la siguiente tabla:

    Modo de implementación AgentCore La responsabilidad del tiempo de ejecución Su responsabilidad

    Modo de despliegue directo

    Publique una nueva versión de Language Runtime que contenga los parches más recientes para Language Runtime. Aplica los parches de Language Runtime a los existentes AgentCore Implementación directa en tiempo de ejecución.

    Actualice el código de su agente, incluidas las dependencias, para corregir cualquier vulnerabilidad de seguridad.

    Imagen de contenedor

    Aplica automáticamente parches al kernel del sistema operativo de procesamiento subyacente con la versión más reciente.

    Actualice el código de su agente, incluidas las dependencias, para corregir cualquier vulnerabilidad de seguridad. Volver a compilar e implementar la imagen del contenedor con regularidad utilizando la imagen base más reciente.

    Para obtener más información sobre la responsabilidad compartida con AWS, consulte Modelo de responsabilidad compartida.

    AgentCore Runtime mantiene actualizado cada tiempo de ejecución de Direct Code Deploy con actualizaciones de seguridad, correcciones de errores, nuevas funciones, mejoras de rendimiento y compatibilidad con versiones menores. Estas actualizaciones de tiempo de ejecución se publican como versiones en tiempo de ejecución . AgentCore Runtime aplica actualizaciones directas de tiempo de ejecución de implementación de código a los agentes mediante la migración de los agentes de una versión de tiempo de ejecución anterior a una nueva versión de tiempo de ejecución.

    Para los tiempos de ejecución de implementación directa, AgentCore Runtime aplica automáticamente las actualizaciones en tiempo de ejecución. Con las actualizaciones automáticas en tiempo de ejecución, AgentCore Runtime asume la carga operativa de aplicar parches a las versiones en tiempo de ejecución. Para la mayoría de los clientes, esta debería ser una opción segura, ya que solo se aplicarán automáticamente los parches de lenguaje de ejecución y los clientes son responsables de traer y administrar sus dependencias de código. En la actualidad AgentCore Runtime no permite cambiar este comportamiento de aplicación automática de parches.

    AgentCore Runtime se esfuerza por ofrecer actualizaciones de tiempo de ejecución que sean compatibles con versiones anteriores de las funciones existentes. Sin embargo, al igual que ocurre con los parches de software, hay casos excepcionales en los que una actualización del tiempo de ejecución puede afectar negativamente a una función ya existente. Por ejemplo, los parches de seguridad pueden exponer un problema subyacente con una función existente que depende del comportamiento inseguro anterior. Si, en casos extremadamente raros, este riesgo no es aceptable, utilice imágenes de contenedor para desplegar su agente.

    Compare algunas de las dimensiones para ver en qué se diferencia una opción de la otra, por lo que es útil elegir la opción correcta

    • Proceso de despliegue : La implementación directa de código implementa los agentes mediante archivos ZIP en lugar de contenedores, lo que permite acelerar las iteraciones de desarrollo.

    • Tiempo de implementación : Si bien no hay mucha diferencia durante la primera implementación de un agente, las actualizaciones posteriores del agente son significativamente más rápidas si se implementa directamente el código.

    • Personalización : Soporta directamente el código para dependencias personalizadas a través de ZIP-based el empaquetado manteniendo la simplicidad de la implementación, mientras que está basado en contenedores depende de un archivo Docker.

    • Tamaño del paquete : La implementación directa del código limita el tamaño del paquete a 250 MB. Container-based los paquetes pueden tener hasta 2 GB (comprimidos) en la versión de plataforma V1 o hasta 10 GB (comprimidos) en la versión de plataforma V2. Las imágenes de más de 2 GB necesitan un configuración de recursos.

    • Tasa de creación de sesiones : La implementación directa del código permite crear más sesiones, es decir, 25 sesiones nuevas sessions/second en comparación con 1.6 nuevas sessions/second con despliegues basados en contenedores.

    Nuestra orientación general es

    • Si el tamaño del paquete de implementación supera los 250 MB y ya tienes un contenedor CI/CD si tienes canalizaciones y necesitas dependencias y paquetes altamente especializados, las implementaciones basadas en contenedores son una buena opción.

    • Si el tamaño del paquete de implementación es pequeño, el código y el paquete no son complejos de construir y utilizan marcos y lenguajes comunes, y necesitas crear prototipos e iteraciones rápidas, la implementación directa del código sería la opción.

    También puede existir una opción híbrida en la que los desarrolladores utilicen el despliegue directo de código para experimentar y prototipar rápidamente los agentes y luego cambien a despliegues basados en contenedores (por los motivos anteriores) para desarrollarlos, probarlos e implementarlos en producción.