View a markdown version of this page

구성 번들 생성 - Amazon Bedrock AgentCore

구성 번들 생성

구성 번들을 생성하여 에이전트의 동적 구성의 버전이 지정된 스냅샷을 저장합니다. 번들은 mainline브랜치에 초기 버전으로 생성됩니다.

참고

CLI add config-bundle 명령은 번들 정의를 agentcore.json 로컬에 저장합니다. 서비스에서 실제로 생성하려면 agentcore deploy 나중에를 실행해야 합니다.

코드 샘플

AgentCore CLI

인라인 구성 요소 JSON을 사용하여를 생성한 다음 배포합니다.

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

--components 키는 또는 형식의 ARNs {{runtime:<name>}} 또는 자리 표시자일 수 있습니다{{gateway:<name>}}. 자리 표시자는 배포 시 실제 ARNs으로 확인되므로 프로젝트에서 관리되는 리소스에 자리 표시자 양식을 사용합니다. 원시 ARN 키를 사용하려면 리소스가 이미 있어야 합니다.

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

--description, --branch--commit-message를 추가하여 버전 메타데이터--json를 설정하거나 결과를 JSON으로 출력합니다.

구성 요소 파일에서를 생성한 다음 배포합니다.

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

샘플components.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']}")

요청 파라미터

파라미터 유형 필수 설명

bundleName

문자열

번들의 이름입니다. 와 일치해야 합니다[a-zA-Z][a-zA-Z0-9_]{0,99}. 이름은 계정 내에서 고유해야 합니다.

components

구성 요소 구성에 대한 구성 요소 식별자 맵입니다. 키는 일반적으로 구성 중인 AgentCore 리소스의 ARN입니다(예: 런타임 ARN). 각 값에는 임의의 키-값 페어가 있는 configuration 객체가 포함됩니다.

description

문자열

No

번들에 대한 설명입니다. 최대 500자.

branchName

문자열

No

버전 추적을 위한 브랜치 이름입니다. 기본값은 mainline입니다. 와 일치해야 합니다[a-zA-Z][a-zA-Z0-9_/-]{0,127}.

commitMessage

문자열

No

초기 버전에 대한 커밋 메시지입니다. 최대 500자.

createdBy

객체

아니요

이 버전을 생성한 소스입니다. name (필수) 및 arn (선택 사항)를 포함합니다.

clientToken

문자열

No

Idempotency 토큰입니다. 동일한 토큰으로 재시도하면 서비스는 새 번들을 생성하는 대신 기존 번들을 반환합니다.

tags

아니요

리소스 태그. 최대 50개의 태그.

응답

Field 유형 설명

bundleArn

문자열

생성된 구성 번들의 ARN입니다.

bundleId

문자열

번들의 고유 식별자입니다. 형식: {name}-{10-char-suffix}

versionId

문자열

번들로 생성된 초기 버전의 UUID입니다.

createdAt

타임스탬프

번들이 생성된 시간입니다.

오류

오류 HTTP 상태 설명

ValidationException

400

잘못된 요청 파라미터입니다. 필드 제약 조건 및 이름 지정 패턴을 확인합니다.

ConflictException

409

동일한 이름 또는 클라이언트 토큰의 번들이 이미 있습니다.

ServiceQuotaExceededException

402

계정의 최대 구성 번들 수에 도달했습니다.

AccessDeniedException

403

권한이 부족합니다. IAM 정책에가 포함되어 있는지 확인합니다bedrock-agentcore:CreateConfigurationBundle.

ThrottlingException

429

요청 속도가 초과되었습니다. 지수 백오프를 사용하여 재시도하세요.

InternalServerException

500

서비스 측 오류입니다. 요청을 다시 시도하세요.