View a markdown version of this page

AgentCore aprovechar el control de versiones y los puntos finales - Amazon Bedrock AgentCore
¿Cómo hacen referencia los puntos finales a las versionesEscenarios de control de versionesEstados del ciclo de vida del terminalCreación de un punto de conexiónListado de versiones de arneses y terminalesTemas relacionados

AgentCore aprovechar el control de versiones y los puntos finales

Amazon Bedrock AgentCore implementa el control de versiones automático para los AgentCore arneses y le permite administrar diferentes configuraciones mediante puntos de conexión. El versionado de Harness funciona de la misma manera que el versionado en AgentCore tiempo real (el arnés es una abstracción gestionada en lugar de Runtime), pero se administra a través de las API del plano de control de arneses.

Cada arnés de Amazon Bedrock AgentCore se versiona automáticamente:

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

  • Cada actualización del arnés 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 la ejecución: modelo, indicador del sistema, herramientas, memoria, límites y entorno

¿Cómo hacen referencia los puntos finales a las versiones

Los puntos finales proporcionan una forma de hacer referencia a versiones específicas del arnés:

  • El DEFAULT punto final apunta automáticamente a la versión más reciente del arnés

  • 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 arnés, el DEFAULT punto final se actualiza automáticamente para que apunte a la nueva versión

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

Ejemplo: actualizar un punto final a una nueva versión

ejemplo
AWS CLI/boto3
import boto3

control_client = boto3.client('bedrock-agentcore-control', region_name='us-west-2')

response = control_client.update_harness_endpoint(
    harnessId='MyHarness-UuFdkQoXSL',
    endpointName='production-endpoint',
    targetVersion='2',
    description='Updated production endpoint'
)

print(response)

O con la AWS CLI:

aws bedrock-agentcore-control update-harness-endpoint \
  --harness-id "MyHarness-UuFdkQoXSL" \
  --endpoint-name "production-endpoint" \
  --target-version "2" \
  --description "Updated production endpoint"

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 arnés:

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 modelo

Crea una nueva versión con la selección de modelos 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 la V2

Actualización de herramienta o habilidad

Crea una nueva versión con la configuración de herramientas actualizada

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

Límites o modificación del entorno

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

V4

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

Estados del ciclo de vida del terminal

Los puntos finales de Harness 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, la configuración 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

Creación de un punto de conexión

Cree un punto final con nombre para anclar un entorno a una versión de arnés específica. Si lo omitetargetVersion, el punto final apunta a la versión más reciente en el momento de la creación.

ejemplo
AWS CLI/boto3
import boto3

control_client = boto3.client('bedrock-agentcore-control', region_name='us-west-2')

response = control_client.create_harness_endpoint(
    harnessId='MyHarness-UuFdkQoXSL',
    endpointName='production-endpoint',
    targetVersion='2',
    description='Production endpoint pinned to V2'
)

print(response)

O con la AWS CLI:

aws bedrock-agentcore-control create-harness-endpoint \
  --harness-id "MyHarness-UuFdkQoXSL" \
  --endpoint-name "production-endpoint" \
  --target-version "2" \
  --description "Production endpoint pinned to V2"

Listado de versiones de arneses y terminales

Puede enumerar todas las versiones de un arnés llamando a la ListHarnessVersions operación. Para ver una lista de los puntos finales de un arnés, llameListHarnessEndpoints.

ejemplo
AWS CLI/boto3
import boto3

control_client = boto3.client('bedrock-agentcore-control', region_name='us-west-2')

# List all versions of a harness
versions = control_client.list_harness_versions(
    harnessId='MyHarness-UuFdkQoXSL'
)
for version in versions['harnessVersions']:
    print(version)

# List all endpoints for a harness
endpoints = control_client.list_harness_endpoints(
    harnessId='MyHarness-UuFdkQoXSL'
)
for endpoint in endpoints['endpoints']:
    print(endpoint)

O con la AWS CLI:

aws bedrock-agentcore-control list-harness-versions \
  --harness-id "MyHarness-UuFdkQoXSL"

aws bedrock-agentcore-control list-harness-endpoints \
  --harness-id "MyHarness-UuFdkQoXSL"

Ambas operaciones admiten la paginación mediante maxResults ynextToken. Para recuperar la configuración de un único punto final, llameGetHarnessEndpoint; para eliminar uno, llameDeleteHarnessEndpoint.

Temas relacionados