기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 에이전트 빌더
<a name="agent-builder-1"></a>

Agent Builder는 Amazon Bedrock AgentCore에서 프로덕션 지원 AI 에이전트를 생성, 배포 및 관리하기 위한 플랫폼을 제공합니다. 이 섹션에서는 기술 구성 요소와 구현 세부 정보를 설명합니다.

## AgentCore 통합
<a name="agentcore-integration"></a>

Agent Builder는 사전 구축된 에이전트 이미지와 함께 구성 기반 배포 접근 방식을 사용하여 빠르고 안전하며 확장 가능한 에이전트 배포를 지원합니다.

 **사전 구축된 에이전트 이미지** 

에이전트 컨테이너 이미지는 CI/CD 파이프라인 중에 GAAB 팀이 빌드하고 퍼블릭 ECR 리포지토리에 게시합니다. 각 이미지 버전은 GAAB 솔루션 버전(예: v4.0.0 → gaab-strands-agent:v4.0.0)과 연결됩니다. 이미지는 Strands SDK를 기반으로 하며 다음을 포함합니다.
+ 에이전트 런타임 환경
+ MCP 클라이언트 통합
+ 메모리 관리 기능
+ OpenTelemetry 계측

 **ECR 풀스루 캐시** 

이 솔루션은 ECR 풀스루 캐시를 사용하여 퍼블릭 ECR 리포지토리의 에이전트 이미지를 고객의 프라이빗 ECR에 자동으로 배포합니다. 이 AWS 관리형 서비스는 다음과 같습니다.
+ 첫 번째 풀 시 이미지 캐싱(2\~5분 지연)
+ 사용자 지정 이미지 복사 로직 제거
+ 후속 배포를 위한 로컬 이미지 가용성 제공
+ 충돌을 방지하기 위해 배포당 고유한 캐시 규칙을 생성합니다.

 **구성 스토리지** 

에이전트 구성은 기존 사용 사례 구성과 함께 DynamoDB에 저장됩니다. 각 구성에는 다음이 포함됩니다.
+ 시스템 프롬프트 템플릿
+ 모델 공급자 및 모델 ID
+ 모델 파라미터(온도, max\_tokens)
+ MCP 서버 참조 및 엔드포인트
+ 메모리 설정(장기 메모리 토글)
+ 배포 메타데이터

 **이미지 버전 레지스트리** 

DynamoDB 테이블은 사용 가능한 에이전트 이미지 버전과 캐시 URIs를 추적하여 버전 관리 및 이전 버전과의 호환성을 지원합니다.

## 에이전트 구성
<a name="agent-configuration"></a>

 **시스템 프롬프트** 

시스템 프롬프트는 에이전트 동작, 성격 및 기능을 정의합니다. 관리자 사용자는 다음을 수행할 수 있습니다.
+ Agent Builder UI를 통해 기본 템플릿 편집
+ 도구 사용 및 응답 형식 지정에 대한 지침 포함
+ 언제든지 기본 템플릿으로 재설정

 **모델 선택** 

Agent Builder는 v4.0.0에서 Amazon Bedrock 모델을 지원합니다.
+ 모델 공급자: Amazon Bedrock(v4.0.0의 옵션만 해당)
+ 모델 선택: Claude, Nova 및 기타 Bedrock 모델
+ 모델 파라미터: 온도, max\_tokens, top\_p 및 모델별 설정

 **MCP 서버 통합** 

모델 컨텍스트 프로토콜 서버는 에이전트에게 엔터프라이즈 도구 및 데이터에 대한 액세스 권한을 제공합니다.
+ GET /mcp API 엔드포인트를 통한 서버 검색
+ 코드 변경이 없는 동적 구성
+ 인증 및 엔드포인트 관리
+ 에이전트에 대한 도구 기능 노출

## 스트리밍 및 처리
<a name="streaming-and-processing"></a>

 **실시간 스트리밍** 

Agent Builder는 실시간 응답 스트리밍을 위해 WebSocket에 연결된 AgentCore의 Server-Sent Events(SSE)를 사용합니다.
+ Lambda 함수는 AgentCore 런타임에 대한 SSE 연결을 설정합니다.
+ 스트림은 API Gateway WebSocket에 브리지됩니다.
+ 클라이언트에 token-by-token 응답 전송을 활성화합니다.
+ 장기 실행 요청에 대한 연결을 유지합니다.

 **처리 제약 조건** 

v4.0.0의 에이전트 처리는 Lambda 실행 제한 시간으로 제한됩니다.
+ 최대 처리 시간: 15분
+ 동기식 처리 모델
+ 대화형 에이전트 및 중간 워크플로에 적합
+ v4.1\+에 대한 확장된 비동기 지원 계획

## 메모리 관리
<a name="memory-management"></a>

 **단기 메모리** 

사용자 지정 MemoryHookProvider를 사용하는 모든 에이전트에 대해 기본적으로 활성화됩니다.
+ Strands 콜백 핸들러를 통해 대화 이벤트 캡처
+ 컨텍스트 격리를 위해 actorId 및 sessionId별로 구성
+ 세션 내에서 대화 컨텍스트를 유지합니다.
+ AgentCore 메모리와 자동 통합

 **장기 메모리** 

strands\_tools의 AgentCore 메모리 도구를 사용하는 선택적 기능:
+ Agent Builder UI의 단순 토글
+ 기본 설정을 사용한 의미 체계 메모리 전략
+ 자연 도구 호출을 통한 에이전트 제어 액세스
+ 세션 간에 추출된 인사이트를 저장합니다.
+ conversationId를 sessionId로 사용

## 관찰성
<a name="observability"></a>

 **AWS OpenTelemetry Distro(ADOT)** 

에이전트는 컨테이너 빌드 중에 자동으로 계측됩니다.
+ 에이전트 작업을 위한 자동 트레이스 생성
+ 서비스 경계를 넘어 분산 추적
+ 상관관계 IDs 사용한 구조화된 로깅
+ CloudWatch 트랜잭션 검색과 통합

 **인증 흐름** 

사용자는 사용자 그룹을 기반으로 DynamoDB에서 IAM 정책을 검색하는 사용자 지정 Lambda 권한 부여자가 검증한 JWT 토큰으로 Amazon Cognito를 통해 인증합니다.

## 워크플로 빌더
<a name="workflow-builder-1"></a>

Workflow Builder는 에이전트를 도구 위임 패턴으로 사용하여 여러 에이전트를 조정하는 감독자 에이전트를 생성하여 다중 에이전트 오케스트레이션을 활성화합니다.

### 워크플로 아키텍처
<a name="workflow-architecture"></a>

 **주요 구성 요소** 
+  **감독자 에이전트**: 사용자 요청을 수신하고 특수 에이전트에게 위임하는 진입점 에이전트
+  **전문 에이전트**: 감독자를 위한 도구로 등록된 Agent Builder 사용 사례
+  **에이전트 레지스트리**: 에이전트 구성 및 메타데이터를 저장하는 DynamoDB 테이블
+  **오케스트레이션 계층**: 에이전트의 SDK 구현을 도구 패턴으로 스트랜드합니다.

### 에이전트 인스턴스화
<a name="agent-instantiation"></a>

 **로컬 에이전트 생성** 

모든 특수 에이전트는 동일한 AgentCore 런타임 내에서 로컬로 인스턴스화됩니다.

1. DynamoDB에서 에이전트 구성을 검색합니다.

1. 각 Agent Builder 에이전트의 로컬 인스턴스를 생성합니다.

1. 각 에이전트는 자체 MCP 서버 연결을 유지합니다.

1. 감독자 에이전트가 특수 에이전트를 도구로 등록

1. Strands SDK는 에이전트 선택 및 위임을 관리합니다.