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

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