View a markdown version of this page

Atualizar um pacote de configuração - Base da Amazônia AgentCore
Exemplos de códigoParâmetros de solicitaçãoRespostaRamificação e mesclagensErros

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Atualizar um pacote de configuração

Atualize um pacote de configuração para criar uma nova versão imutável com a configuração alterada. Cada atualização produz um novo ID de versão; as versões existentes nunca são modificadas. As versões formam uma cadeia viaparentVersionIds, semelhante ao git commits.

Exemplos de código

exemplo
AgentCore CLI

Edite a configuração agentcore.json e reimplante. A CLI detecta o pacote existente e cria uma nova versão com a correta automaticamente: parentVersionIds

# Edit the bundle configuration in agentcore.json (change model_id, system prompt, etc.)
# Then redeploy to create a new version:
agentcore deploy

# After deploying, confirm a new immutable version was created:
agentcore cb versions --name MyBundle

# Inspect what changed between two versions (get IDs from `cb versions`):
agentcore cb diff --name MyBundle --from <v1> --to <v2>
AWS SDK (boto3)

Atualize alterando o ID do modelo:

import boto3
import uuid

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

RUNTIME_ARN = "arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/MyAgent-abc123"

response = client.update_configuration_bundle(
    bundleId="myAgentConfig-a1b2c3d4e5",
    components={
        RUNTIME_ARN: {
            "configuration": {
                "system_prompt": "You are a helpful customer support assistant.",
                "model_id": "us.anthropic.claude-sonnet-4-20250514-v1:0",
                "temperature": 0.7,
            }
        }
    },
    parentVersionIds=["12345678-1234-1234-1234-123456789012"],
    commitMessage="Switch to Claude Sonnet 4",
    clientToken=str(uuid.uuid4()),
)

print(f"New version ID: {response['versionId']}")

Atualize com um prompt de sistema recomendado a partir de um resultado de recomendação:

import boto3
import uuid

cp_client = boto3.client("bedrock-agentcore-control", region_name="us-west-2")
dp_client = boto3.client("bedrock-agentcore", region_name="us-west-2")

RUNTIME_ARN = "arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/MyAgent-abc123"

# Get the recommendation result
recommendation = dp_client.get_recommendation(recommendationId="myRec-a1b2c3d4e5")
recommended_prompt = recommendation["result"]["systemPromptRecommendationResult"]["recommendedSystemPrompt"]

# Update the bundle with the recommended prompt
response = cp_client.update_configuration_bundle(
    bundleId="myAgentConfig-a1b2c3d4e5",
    components={
        RUNTIME_ARN: {
            "configuration": {
                "system_prompt": recommended_prompt,
                "model_id": "global.anthropic.claude-sonnet-4-5-20250929-v1:0",
                "temperature": 0.7,
            }
        }
    },
    parentVersionIds=["12345678-1234-1234-1234-123456789012"],
    commitMessage="Apply recommended system prompt",
    createdBy={"name": "optimization-job", "arn": recommendation["recommendationArn"]},
    clientToken=str(uuid.uuid4()),
)

print(f"New version ID: {response['versionId']}")

Parâmetros de solicitação

Parâmetro Tipo Obrigatório Descrição

bundleId

String

Sim

O ID do pacote de configuração a ser atualizado. Passado como parâmetro de caminho.

bundleName

String

Não

Nome atualizado para o pacote.

description

String

Não

Descrição atualizada. Máximo de 500 caracteres.

components

Mapa

Não

Configurações de componentes atualizadas. Cria uma nova versão com esses componentes.

parentVersionIds

Lista de strings

Não

IDs da versão principal para rastreamento de linhagem. Obrigatório ao atualizarcomponents. Compromissos regulares: mãe solteira. Compromissos de mesclagem: dois pais (ramificação de destino mais recente, ramificação de origem mais recente). Se a ramificação já existir, o primeiro pai deve ser a versão mais recente dessa ramificação.

branchName

String

Não

Nome da ramificação para esta versão. Se não for especificado, herda a ramificação do pai ou usa como padrão. mainline

commitMessage

String

Não

Envie uma mensagem descrevendo as mudanças. Máximo de 500 caracteres.

createdBy

Objeto

Não

Fonte que criou esta versão. Contém name (obrigatório) e arn (opcional). Use isso para rastrear se uma versão foi criada por um usuário, um trabalho de recomendação ou outra automação.

clientToken

String

Não

Símbolo de idempotência.

Resposta

Campo Tipo Description

bundleArn

String

ARN do pacote de configuração.

bundleId

String

ID do pacote de configuração.

versionId

String

UUID da nova versão criada por essa atualização.

updatedAt

Timestamp

Quando a atualização foi aplicada.

Ramificação e mesclagens

Os pacotes de configuração oferecem suporte à ramificação semelhante ao git:

  • Compromissos lineares. Omita parentVersionIds ou rejeite um pai solteiro. A nova versão amplia a linhagem do ramo.

  • Nova filial. Especifique uma branchName que ainda não existe e uma que parentVersionIds aponta para a versão da qual você deseja ramificar.

  • Compromissos de mesclagem. Passo doisparentVersionIds: a primeira é a versão mais recente na ramificação de destino, a segunda é a mais recente na ramificação de origem. Isso cria uma confirmação de mesclagem na ramificação de destino.

Erros

Erro Status HTTP Description

ValidationException

400

Parâmetros de solicitação inválidos. Verifique as restrições de campo.

ResourceNotFoundException

404

O especificado bundleId não existe.

ConflictException

409

Conflito de versão. A versão principal especificada não é a mais recente na ramificação. Obtenha a versão mais recente e tente novamente.

AccessDeniedException

403

Permissões insuficientes. Verifique se as políticas do IAM incluembedrock-agentcore:UpdateConfigurationBundle.

ThrottlingException

429

Taxa de solicitações excedida. Novas tentativas com recuo exponencial.

InternalServerException

500

Service-side erro. Repetir a solicitação .