구성 번들
구성 번들은 에이전트가 런타임에 읽는 시스템 프롬프트, 모델 IDs, 도구 설명 및 기타 키-값 페어 등 에이전트의 동적 구성을 버전 관리되고 변경할 수 없는 스냅샷입니다. 번들은 코드에서 에이전트 동작을 분리하므로 코드를 재배포하지 않고도 에이전트의 응답 방식을 변경할 수 있습니다.
핵심 개념
-
구성 요소는 구성한 AgentCore 리소스의 ARN(예: 런타임 ARN)에 의해 입력됩니다. 각 구성 요소에는 임의의 키-값 페어가 있는
configuration객체가 포함되어 있습니다. -
버전은 변경할 수 없습니다. 모든 업데이트는 고유한 UUID를 사용하여 새 버전을 생성합니다. 버전은 git 커밋과
parentVersionIds마찬가지로를 통해 체인을 형성합니다. -
브랜치는 버전 계보(예: ,
mainlineexperiment-1)를 구성합니다. -
번들 이름은 문자로 시작해야 하며 문자, 숫자 및 밑줄(하이픈 없음)을 포함할 수 있습니다. 패턴:
[a-zA-Z][a-zA-Z0-9_]{0,99}.
구성 번들을 사용해야 하는 경우
-
A/B 테스트. A/B 테스트의 각 변형은 특정 번들 버전을 참조합니다. 게이트웨이는 각 요청에 번들 참조를 주입합니다.
-
권장 사항. 권장 사항 API는 번들에서 현재 구성을 읽고 최적화된 구성을 새 번들 버전으로 작성할 수 있습니다.
-
롤백. 버전은 변경할 수 없으므로 버전 ID를 참조하여 이전 버전으로 롤백할 수 있습니다.
-
감사 추적. 버전 체인은 구성 변경에 대한 전체 기록을 제공합니다.
