Ejemplos de código Parámetros de solicitud Respuesta Errores

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 de la CLI guarda la definición del paquete de agentcore.json forma local. Para crearlo realmente en el servicio, debe ejecutarlo agentcore deploy después.

Ejemplos de código

ejemplo

AgentCore CLI

Cree con componentes JSON 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 que gestiones 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 establecer 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 tu cuenta.
`components`	Asignación	Sí	Mapa del identificador del componente a la configuración del componente. La clave suele ser el ARN del AgentCore recurso que se está configurando (por ejemplo, un ARN en 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 vuelves a intentarlo 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	Cuando se creó el paquete.

Errores

Error	Estado HTTP	Description (Descripción)
`ValidationException`	400	Parámetros de solicitud no válidos. Compruebe las restricciones de campo y los patrones de nomenclatura.
`ConflictException`	409	Ya existe un paquete con el mismo nombre o token de cliente.
`ServiceQuotaExceededException`	402	Ha alcanzado el número máximo de paquetes de configuración para su cuenta.
`AccessDeniedException`	403	Permisos insuficientes. Verifique que las políticas de IAM incluyan`bedrock-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 .

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Introducción

Actualizar un paquete