View a markdown version of this page

AgentCore aproveche el control de versiones y los puntos finales - Base amazónica 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ónListar las versiones y los puntos finales de los arnesesTemas relacionados

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.

AgentCore aproveche el control de versiones y los puntos finales

Amazon Bedrock AgentCore implementa el control de versiones automático para AgentCore aprovechar los límites y le permite administrar diferentes configuraciones mediante puntos de enlace. El control de versiones mediante arneses funciona del mismo modo que el control de versiones en AgentCore tiempo de ejecución (el arnés es una abstracción gestionada en comparación con Runtime), pero se gestiona mediante las API del plano de control del arnés.

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

  • Las versiones son inmutables una vez creadas

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

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

  • Los terminales pueden apuntar a versiones específicas, lo que te permite mantener diferentes entornos (por ejemplo, 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 se deben actualizar de forma explícita para que apunten a las 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 muestra 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 Versión más reciente Comportamiento de terminales

Creación inicial

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

V1

DEFAULT apunta a la V1

Cambio de modelo

Crea una nueva versión con la selección de modelo actualizada

V2

DEFAULT se actualiza automáticamente a la versión 2

Cree el punto final «PROD» con la V2

No se ha creado ninguna versión nueva

V2

El punto final del PROD apunta a la V2

Actualización de herramientas o habilidades

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

V3

Actualizaciones PREDETERMINADAS 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

Actualizaciones PREDETERMINADAS a la V4, PROD permanece en la V3

Estados del ciclo de vida del terminal

Los terminales de Harness pasan por varios estados a lo largo de su ciclo de vida:

CREAR

Estado inicial cuando se crea un punto final

CREATE_FAILED

Indica un error de creación debido a problemas con los permisos, la configuración u otros

PREPARADO

El punto final está listo para aceptar solicitudes

ACTUALIZANDO

Endpoint 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 vincular 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"

Listar las versiones y los puntos finales de los arneses

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