View a markdown version of this page

AgentCore Controle de versão e endpoints em tempo de execução - Amazon Bedrock AgentCore
Como os endpoints fazem referência às versõesCenários de controle de versãoEstados do ciclo de vida do endpointListando versões e endpoints do AgentCore Runtime

AgentCore Controle de versão e endpoints em tempo de execução

O Amazon Bedrock AgentCore implementa o controle de versão automático para AgentCore tempos de execução e permite que você gerencie diferentes configurações usando endpoints.

Cada AgentCore Runtime no Amazon Bedrock AgentCore é automaticamente versionado:

  • Quando você cria um AgentCore Runtime, o AgentCore Runtime cria automaticamente a versão 1 (V1)

  • Cada atualização do AgentCore Runtime cria uma nova versão com uma configuração completa e independente

  • As versões são imutáveis depois de criadas

  • Cada versão contém toda a configuração necessária para execução

Como os endpoints fazem referência às versões

Os endpoints fornecem uma forma de referenciar versões específicas do seu AgentCore Runtime:

  • O DEFAULT endpoint aponta automaticamente para a versão mais recente do seu AgentCore Runtime

  • Os endpoints podem apontar para versões específicas, permitindo que você mantenha ambientes diferentes (por exemplo, desenvolvimento, preparação, produção)

  • Quando você atualiza um AgentCore Runtime, o DEFAULT endpoint é atualizado automaticamente para apontar para a nova versão

  • Os endpoints devem ser atualizados explicitamente para apontar para novas versões

Exemplo: atualização de um endpoint para uma nova versão 

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)

Cenários de controle de versão

A tabela a seguir ilustra como o controle de versão e os endpoints interagem durante o ciclo de vida de um Runtime: AgentCore

Tipo de alteração Comportamento de criação de versão Versão mais recente Comportamento do endpoint

Criação inicial

Cria a versão 1 (V1) automaticamente

V1

O DEFAULT aponta para V1

Alteração de protocolo

Cria uma nova versão com configurações de protocolo atualizadas

V2

DEFAULT é atualizado automaticamente para V2

Crie um endpoint “PROD” com V2

Nenhuma nova versão criada

V2

O endpoint PROD aponta para V2

Atualização da imagem do contêiner

Cria uma nova versão com nova referência de contêiner

V3

Atualizações PADRÃO para V3, PROD permanece na V2

Atualize “PROD” para V3

Nenhuma nova versão criada

V3

Atualizações do PROD para V3

Modificação das configurações de rede

Cria uma nova versão com parâmetros de segurança atualizados

V4

Atualizações PADRÃO para V4, PROD permanece na V3

Estados do ciclo de vida do endpoint

AgentCore Os endpoints de tempo de execução passam por vários estados durante seu ciclo de vida:

CRIANDO

Estado inicial quando um endpoint está sendo criado

FALHA NA CRIAÇÃO

Indica falha na criação devido a permissões, contêiner ou outros problemas

PRONTO

O endpoint está pronto para aceitar solicitações

ATUALIZANDO

O Endpoint está sendo atualizado para uma nova versão

UPDATE_FAILED

Indica falha na operação de atualização

Listando versões e endpoints do AgentCore Runtime

Você pode listar todas as versões de um AgentCore Runtime chamando a ListAgentRuntimeVersions operação. Para listar os endpoints de um AgentCore Runtime, chameListAgentRuntimeEndpoints.