Comience con la implementación directa de código en Amazon Bedrock AgentCore Runtime
La implementación directa del código le permite llevar a 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ónAgentCore .
Para crear su paquete de implementación como un archivo de archivos.zip, puede usar la AgentCore CLIzip de línea de comandos en un entorno Linux o macOS. Para usar los mismos comandos en Windows, puede instalar el subsistema de Windows para Linux
Tenga en cuenta que AgentCore Runtime usa permisos de archivo POSIX, por lo que es posible que deba configurar los permisos para la carpeta del paquete de despliegue
Temas
Conceptos de despliegue directo de código
Obtenga información sobre los conceptos clave al utilizar 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 al de 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 en las dependencias.
Si utilizas imágenes de contenedores para implementar tus agentes, AgentCore Runtime es responsable de parchear únicamente el kernel de cómputo. En este caso, eres responsable de reconstruir la imagen del contenedor del agente a partir de la imagen segura más reciente 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 del motor de ejecución del idioma que contenga los últimos parches para el tiempo de ejecución del idioma. Aplique los parches de ejecución del idioma a la implementación directa AgentCore de Runtime existente. |
Actualice el código del agente, incluidas las dependencias, para solucionar cualquier vulnerabilidad de seguridad. |
|
Imagen de contenedor |
Aplica automáticamente la última versión del kernel del sistema operativo de cómputo subyacente. |
Actualice el código del agente, incluidas las dependencias, para solucionar 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 compartida
AgentCore Runtime mantiene actualizado cada tiempo de ejecución de implementación directa de código con actualizaciones de seguridad, correcciones de errores, nuevas funciones, mejoras de rendimiento y compatibilidad con versiones menores. Estas actualizaciones en tiempo de ejecución se publican como versiones en 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 de tiempo de ejecución anterior a una nueva versión de tiempo de ejecución.
Para los tiempos de ejecución de despliegue directo, 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 parchear 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 tiempo de ejecución de idiomas y los clientes son responsables de incorporar 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 proporcionar actualizaciones en 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 muy raras ocasiones, este riesgo no es aceptable, utilice imágenes de contenedores para implementar su agente.
Algunas de las dimensiones de la comparación permiten ver en qué se diferencia una opción de la otra, por lo que es útil elegir la opción correcta
-
Proceso de despliegue: el despliegue directo de código despliega los agentes mediante archivos ZIP en lugar de contenedores, lo que permite realizar 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 con la implementación directa del código.
-
Personalización: el código directo admite dependencias personalizadas mediante el ZIP-based empaquetado, a la vez que mantiene la simplicidad de implementación, mientras que la implementación basada en contenedores depende de un 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: el despliegue directo de código permite crear 25 sesiones nuevas en sessions/second comparación con las 1,6 nuevas que se crean sessions/second con las implementaciones basadas en contenedores.
Nuestra orientación general es
-
Si el tamaño del paquete de despliegue supera los 250 MB, tiene CI/CD canalizaciones de contenedores existentes y necesita dependencias y paquetes altamente especializados, entonces las implementaciones basadas en contenedores son una buena opción.
-
Si el tamaño del paquete de despliegue es pequeño, el código y el paquete no son complejos de compilar y utilizan marcos y lenguajes comunes, y necesita una rápida creación de prototipos e iteraciones, entonces la opción sería el despliegue directo del código.
También puede haber una opción híbrida en la que los desarrolladores utilicen el despliegue directo de código para experimentar y crear prototipos de agentes rápidamente y, después, cambien a despliegues basados en contenedores (por los motivos anteriores) para desarrollar, probar e implementar en producción.
