AgentCore 런타임 버전 관리 및 엔드포인트
Amazon Bedrock AgentCore는 AgentCore 런타임에 대한 자동 버전 관리를 구현하고 엔드포인트를 사용하여 다양한 구성을 관리할 수 있습니다.
Amazon Bedrock AgentCore의 각 AgentCore 런타임은 자동으로 버전이 지정됩니다.
-
AgentCore 런타임을 생성하면 AgentCore 런타임이 버전 1(V1)을 자동으로 생성합니다.
-
AgentCore 런타임을 업데이트할 때마다 완전한 독립형 구성으로 새 버전이 생성됩니다.
-
버전은 일단 생성되면 변경할 수 없습니다.
-
각 버전에는 실행에 필요한 모든 구성이 포함되어 있습니다.
엔드포인트가 버전을 참조하는 방법
엔드포인트는 AgentCore 런타임의 특정 버전을 참조하는 방법을 제공합니다.
-
DEFAULT엔드포인트는 AgentCore 런타임의 최신 버전을 자동으로 가리킵니다. -
엔드포인트는 특정 버전을 가리킬 수 있으므로 다양한 환경(예: 개발, 스테이징, 프로덕션)을 유지할 수 있습니다.
-
AgentCore 런타임을 업데이트하면
DEFAULT엔드포인트가 새 버전을 가리키도록 자동으로 업데이트됩니다. -
엔드포인트는 새 버전을 가리키도록 명시적으로 업데이트해야 합니다.
엔드포인트를 새 버전으로 업데이트하는 예
bedrock_agentcore_client = boto3.client('bedrock-agentcore', region_name='us-west-2') response = bedrock_agentcore_client.update_agent_runtime_endpoint( agentRuntimeId='agent-runtime-12345', endpointName='production-endpoint', agentRuntimeVersion='v2.1', description='Updated production endpoint' ) print(response)
버전 관리 시나리오
다음 표는 AgentCore 런타임의 수명 주기 동안 버전 관리와 엔드포인트가 상호 작용하는 방식을 보여줍니다.
| 변경 유형 | 버전 생성 동작 | 최신 버전 | 엔드포인트 동작 |
|---|---|---|---|
|
초기 생성 |
버전 1(V1)을 자동으로 생성합니다. |
V1 |
DEFAULT는 V1을 가리킵니다. |
|
프로토콜 변경 |
업데이트된 프로토콜 설정을 사용하여 새 버전을 생성합니다. |
V2 |
DEFAULT가 V2로 자동 업데이트됨 |
|
V2를 사용하여 "PROD" 엔드포인트 생성 |
새 버전이 생성되지 않음 |
V2 |
PROD 엔드포인트가 V2를 가리킴 |
|
컨테이너 이미지 업데이트 |
새 컨테이너 참조를 사용하여 새 버전을 생성합니다. |
V3 |
V3에 대한 DEFAULT 업데이트, PROD는 V2에 남아 있음 |
|
"PROD"를 V3로 업데이트 |
새 버전이 생성되지 않음 |
V3 |
V3에 대한 PROD 업데이트 |
|
네트워크 설정 수정 |
업데이트된 보안 파라미터를 사용하여 새 버전을 생성합니다. |
V4 |
V4에 대한 DEFAULT 업데이트, PROD는 V3에 남아 있음 |
엔드포인트 수명 주기 상태
AgentCore 런타임 엔드포인트는 수명 주기 동안 다양한 상태를 거칩니다.
- CREATING
-
엔드포인트가 생성될 때의 초기 상태
- CREATE_FAILED
-
권한, 컨테이너 또는 기타 문제로 인한 생성 실패를 나타냅니다.
- 준비됨
-
엔드포인트가 요청을 수락할 준비가 되었습니다.
- 업데이트 중
-
엔드포인트를 새 버전으로 업데이트하는 중입니다.
- UPDATE_FAILED
-
업데이트 작업 실패를 나타냅니다.
AgentCore 런타임 버전 및 엔드포인트 나열
ListAgentRuntimeVersions 작업을 호출하여 AgentCore 런타임의 모든 버전을 나열할 수 있습니다. AgentCore 런타임의 엔드포인트를 나열하려면를 호출합니다ListAgentRuntimeEndpoints.
