View a markdown version of this page

Crie um pacote de configuração - Amazon Bedrock AgentCore
Exemplos de códigoParâmetros de solicitaçãoRespostaErros

Crie um pacote de configuração

Crie um pacote de configuração para armazenar um instantâneo versionado da configuração dinâmica do seu agente. O pacote é criado com uma versão inicial na mainline ramificação.

nota

O add config-bundle comando CLI salva a definição do pacote localmente. agentcore.json Para realmente criá-lo no serviço, você deve executá-lo agentcore deploy posteriormente.

Exemplos de código

exemplo
AgentCore CLI

Crie com componentes embutidos JSON e, em seguida, implante:

agentcore add config-bundle \
  --name myAgentConfig \
  --description "Initial config" \
  --branch mainline \
  --commit-message "Initial bundle creation" \
  --components '{"arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/MyAgent-abc123": {"configuration": {"system_prompt": "You are a helpful assistant.", "model_id": "global.anthropic.claude-sonnet-4-5-20250929-v1:0"}}}'

agentcore deploy

As --components chaves podem ser ARNs ou espaços reservados no formulário {{runtime:<name>}} ou. {{gateway:<name>}} Os espaços reservados se transformam em ARNs reais no momento da implantação, então use o formulário de espaço reservado para recursos gerenciados em seu projeto. As chaves ARN brutas exigem que o recurso já exista:

agentcore add config-bundle \
  --name myAgentConfig \
  --components '{"{{runtime:MyAgent}}": {"configuration": {"system_prompt": "You are a helpful assistant."}}}'

agentcore deploy

Adicione--description,--branch, e --commit-message para definir os metadados da versão ou --json para gerar o resultado como JSON.

Crie a partir de um arquivo de componentes e implante:

agentcore add config-bundle \
  --name myAgentConfig \
  --components-file ./components.json

agentcore deploy

Amostracomponents.json:

{
    "arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/MyAgent-abc123": {
        "configuration": {
            "system_prompt": "You are a helpful customer support assistant for Acme Store. When handling requests: 1) Identify ALL actions needed before starting any. 2) Execute each action in sequence. 3) Before ending any conversation, summarize what was done.",
            "model_id": "global.anthropic.claude-sonnet-4-5-20250929-v1:0"
        }
    }
}
AWS SDK (boto3)
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.create_configuration_bundle(
    bundleName="myAgentConfig",
    components={
        RUNTIME_ARN: {
            "configuration": {
                "system_prompt": "You are a helpful customer support assistant.",
                "model_id": "global.anthropic.claude-sonnet-4-5-20250929-v1:0",
                "temperature": 0.7,
            }
        }
    },
    description="Initial configuration for MyAgent",
    branchName="mainline",
    commitMessage="Initial bundle creation",
    clientToken=str(uuid.uuid4()),
)

print(f"Bundle ID: {response['bundleId']}")
print(f"Bundle ARN: {response['bundleArn']}")
print(f"Version ID: {response['versionId']}")

Parâmetros de solicitação

Parâmetro Tipo Obrigatório Descrição

bundleName

String

Sim

Nome do pacote. Deve corresponder[a-zA-Z][a-zA-Z0-9_]{0,99}. Os nomes devem ser exclusivos em sua conta.

components

Mapa

Sim

Mapa do identificador do componente para a configuração do componente. Normalmente, a chave é o ARN do AgentCore recurso que está sendo configurado (por exemplo, um ARN de tempo de execução). Cada valor contém um configuration objeto com pares arbitrários de valores-chave.

description

String

Não

Descrição do pacote. Máximo de 500 caracteres.

branchName

String

Não

Nome da filial para rastreamento de versões. O padrão é mainline. Deve corresponder[a-zA-Z][a-zA-Z0-9_/-]{0,127}.

commitMessage

String

Não

Mensagem de confirmação para a versão inicial. Máximo de 500 caracteres.

createdBy

Objeto

Não

Fonte que criou esta versão. Contém name (obrigatório) e arn (opcional).

clientToken

String

Não

Símbolo de idempotência. Se você tentar novamente com o mesmo token, o serviço retornará o pacote existente em vez de criar um novo.

tags

Mapa

Não

Tags de recursos. Máximo de 50 tags.

Resposta

Campo Tipo Description

bundleArn

String

ARN do pacote de configuração criado.

bundleId

String

Identificador exclusivo para o pacote. Formato: {name}-{10-char-suffix}.

versionId

String

UUID da versão inicial criada com o pacote.

createdAt

Timestamp

Quando o pacote foi criado.

Erros

Erro Status HTTP Description

ValidationException

400

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

ConflictException

409

Já existe um pacote com o mesmo nome ou token de cliente.

ServiceQuotaExceededException

402

Você atingiu o número máximo de pacotes de configuração para sua conta.

AccessDeniedException

403

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

ThrottlingException

429

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

InternalServerException

500

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