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 con la implementación directa de código de Amazon Bedrock AgentCore Runtime
La implementación directa de código le permite llevar su agente a Amazon Bedrock AgentCore Runtime simplemente empaquetando el código del agente y sus dependencias en un archivo zip. Su agente aún debe cumplir con los requisitos de tiempo de ejecución AgentCore .
Para crear su paquete de implementación como un archivo .zip, puede usar la AgentCore CLI zip de línea de comandos en un entorno Linux o macOS. Para usar los mismos comandos en Windows, puedes instalar el subsistema de Windows para Linux
Ten en cuenta que AgentCore Runtime usa los permisos de archivo POSIX, por lo que es posible que tengas que establecer los permisos para la carpeta del paquete de despliegue
Temas
Conceptos de implementación directa de código
Obtenga más información sobre los conceptos clave relacionados con el uso de la implementación directa de código con Amazon Bedrock AgentCore Runtime.
Temas
Amazon Bedrock AgentCore Runtime 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 utilizas imágenes de contenedor para implementar tus agentes, AgentCore Runtime es responsable de aplicar parches únicamente al kernel de procesamiento. En este caso, eres responsable de reconstruir la imagen de contenedor de tu agente a partir de la última imagen segura y de volver a implementar la imagen de 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 AgentCore Runtime a la implementación directa existente de Runtime. |
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 el modelo de responsabilidad
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 de tiempo de ejecución. AgentCore Runtime aplica actualizaciones de tiempo de ejecución de implementación directa de código a los agentes mediante la migración de los agentes de una versión anterior en tiempo de ejecución a una nueva versión en tiempo de ejecución.
Para los tiempos de ejecución de implementación directa, AgentCore Runtime aplica las actualizaciones en tiempo de ejecución automáticamente. Con las actualizaciones automáticas en tiempo de AgentCore ejecución, 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 gestionar sus dependencias de código. Actualmente, 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 implementar 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 implementación: la implementación directa de código implementa los agentes mediante archivos ZIP en lugar de contenedores, lo que permite iteraciones de desarrollo más rápidas.
-
Tiempo de implementación: aunque 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: el código directo admite dependencias personalizadas mediante el ZIP-based empaquetado, al tiempo que se mantiene la simplicidad de la implementación, mientras que la implementación basada en contenedores depende del archivo de Docker.
-
Tamaño del paquete: la implementación directa de código limita el tamaño del paquete a 250 MB, mientras que los paquetes basados en contenedores pueden tener un tamaño de hasta 2 GB.
-
Tasa de creación de sesiones: la implementación directa de código permite crear más sesiones, de 25 nuevas, sessions/second en comparación con 1,6 nuevas sessions/second con las implementaciones basadas en contenedores.
Nuestra orientación general es
-
Si el tamaño del paquete de implementación supera los 250 MB, si ya tienes CI/CD canalizaciones de contenedores 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 compilar 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.
