View a markdown version of this page

AgentCore Control de versiones en tiempo de ejecución y puntos finales - Amazon Bedrock AgentCore

AgentCore Control de versiones en tiempo de ejecución y puntos finales

Amazon Bedrock AgentCore implementa el control de versiones automático para los AgentCore tiempos de ejecución y le permite administrar diferentes configuraciones mediante puntos de conexión.

Cada AgentCore Runtime de Amazon Bedrock AgentCore se versiona automáticamente:

  • Al crear un AgentCore Runtime, AgentCore Runtime crea automáticamente la versión 1 (V1)

  • Cada actualización del AgentCore Runtime crea una nueva versión con una configuración completa e independiente

  • Una vez creadas, las versiones son inmutables

  • Cada versión contiene toda la configuración necesaria para su ejecución

Cómo hacen referencia los puntos finales a las versiones

Los puntos finales proporcionan una forma de hacer referencia a versiones específicas de su AgentCore Runtime:

  • El DEFAULT punto final apunta automáticamente a la última versión de su Runtime AgentCore

  • Los puntos finales pueden apuntar a versiones específicas, lo que le permite mantener diferentes entornos (por ejemplo, de desarrollo, puesta en escena o producción)

  • Al actualizar un AgentCore Runtime, el DEFAULT punto final se actualiza automáticamente para apuntar a la nueva versión

  • Los puntos finales deben actualizarse de forma explícita para que apunten a nuevas versiones

Ejemplo de actualización de un punto final a una nueva versión

bedrock_agentcore_client = boto3.client('bedrock-agentcore', region_name='us-west-2') response = bedrock_agentcore_client.update_agent_runtime_endpoint( agentRuntimeId='agent-runtime-12345', endpointName='production-endpoint', agentRuntimeVersion='v2.1', description='Updated production endpoint' ) print(response)

Escenarios de control de versiones

La siguiente tabla ilustra cómo interactúan el control de versiones y los puntos finales durante el ciclo de vida de un entorno de ejecución: AgentCore

Tipo de cambio Comportamiento de creación de versiones Última versión Comportamiento del terminal

Creación inicial

Crea la versión 1 (V1) automáticamente

V1

DEFAULT apunta a V1

Cambio de protocolo

Crea una nueva versión con una configuración de protocolo actualizada

V2

DEFAULT se actualiza automáticamente a V2

Cree un punto final «PROD» con V2

No se ha creado ninguna versión nueva

V2

El punto final de PROD apunta a V2

Actualización de la imagen del contenedor

Crea una nueva versión con una nueva referencia de contenedor

V3

DEFAULT se actualiza a la V3, PROD permanece en la V2

Actualice «PROD» a la V3

No se ha creado ninguna versión nueva

V3

PROD se actualiza a la V3

Modificación de la configuración de red

Crea una nueva versión con los parámetros de seguridad actualizados

V4

DEFAULT se actualiza a la V4, PROD permanece en la V3

Estados del ciclo de vida del terminal

AgentCore Los puntos finales de tiempo de ejecución pasan por varios estados durante su ciclo de vida:

CREAR

Estado inicial cuando se crea un punto final

CREATE_FAILED

Indica un error de creación debido a los permisos, el contenedor u otros problemas

PREPARADO

El punto final está listo para aceptar solicitudes

ACTUALIZANDO

El punto final se está actualizando a una nueva versión

UPDATE_FAILED

Indica un error en la operación de actualización

Listado de versiones y puntos finales de AgentCore Runtime

Puede enumerar todas las versiones de un AgentCore Runtime llamando a la ListAgentRuntimeVersions operación. Para ver una lista de los puntos finales de un AgentCore Runtime, llameListAgentRuntimeEndpoints.