View a markdown version of this page

Crear un paquete de configuración - Amazon Bedrock AgentCore
Ejemplos de códigoParámetros de solicitudRespuestaErrores

Crear un paquete de configuración

Cree un paquete de configuración para almacenar una instantánea versionada de la configuración dinámica de su agente. El paquete se crea con una versión inicial en la mainline sucursal.

nota

El add config-bundle comando CLI guarda la definición del paquete agentcore.json localmente. Para crearlo realmente en el servicio, debe ejecutarlo agentcore deploy después.

Ejemplos de código

ejemplo
AgentCore CLI

Cree JSON con componentes en línea y, a continuación, implemente:

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

Las --components claves pueden ser ARN o marcadores de posición en el formulario o. {{runtime:<name>}} {{gateway:<name>}} Los marcadores de posición se convierten en ARN reales en el momento de la implementación, así que usa el formulario de marcadores de posición para los recursos gestionados en tu proyecto. Las claves ARN sin procesar requieren que el recurso ya exista:

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

agentcore deploy

Agregue --description y --commit-message para configurar los metadatos de la versión o --json para generar el resultado como JSON. --branch

Cree a partir de un archivo de componentes y, a continuación, implemente:

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

agentcore deploy

Ejemplocomponents.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 solicitud

Parámetro Tipo Obligatorio Descripción

bundleName

Cadena

Sí

Nombre del paquete. Debe coincidir[a-zA-Z][a-zA-Z0-9_]{0,99}. Los nombres deben ser únicos en su cuenta.

components

Asignación

Sí

Mapa del identificador del componente con la configuración del componente. La clave suele ser el ARN del AgentCore recurso que se está configurando (por ejemplo, un ARN de tiempo de ejecución). Cada valor contiene un configuration objeto con pares clave-valor arbitrarios.

description

Cadena

No

Descripción del paquete. Máximo 500 caracteres.

branchName

Cadena

No

Nombre de la sucursal para el seguimiento de versiones. El valor predeterminado es mainline. Debe coincidir[a-zA-Z][a-zA-Z0-9_/-]{0,127}.

commitMessage

Cadena

No

Mensaje de confirmación para la versión inicial. Máximo 500 caracteres.

createdBy

Objeto

No

Fuente que creó esta versión. Contiene name (obligatorio) y arn (opcional).

clientToken

Cadena

No

Símbolo de idempotencia. Si lo vuelves a intentar con el mismo token, el servicio devuelve el paquete existente en lugar de crear uno nuevo.

tags

Asignación

No

Etiquetas de recursos. Máximo 50 etiquetas.

Respuesta

Campo Tipo Description (Descripción)

bundleArn

Cadena

ARN del paquete de configuración creado.

bundleId

Cadena

Identificador único del paquete. Formato: {name}-{10-char-suffix}.

versionId

Cadena

UUID de la versión inicial creada con el paquete.

createdAt

Timestamp

Cuándo se creó el paquete.

Errores

Error Estado HTTP Description (Descripción)

ValidationException

400

Parámetros de solicitud no válidos. Compruebe las restricciones de los campos y los patrones de nomenclatura.

ConflictException

409

Ya existe un paquete con el mismo nombre o token de cliente.

ServiceQuotaExceededException

402

Has alcanzado el número máximo de paquetes de configuración para tu cuenta.

AccessDeniedException

403

Permisos insuficientes. Compruebe que las políticas de IAM estén incluidasbedrock-agentcore:CreateConfigurationBundle.

ThrottlingException

429

Se superó la tasa de solicitudes. Vuelva a intentarlo con retroceso exponencial.

InternalServerException

500

Service-side error. Intente realizar de nuevo la solicitud .