View a markdown version of this page

에이전트 빌더 - AWS의 생성형 AI 애플리케이션 빌더
AgentCore 통합에이전트 구성스트리밍 및 처리메모리 관리관찰성워크플로 빌더

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

에이전트 빌더

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

AgentCore 통합

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를 추적하여 버전 관리 및 이전 버전과의 호환성을 지원합니다.

에이전트 구성

시스템 프롬프트

시스템 프롬프트는 에이전트 동작, 성격 및 기능을 정의합니다. 관리자 사용자는 다음을 수행할 수 있습니다.

  • 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 엔드포인트를 통한 서버 검색

  • 코드 변경이 없는 동적 구성

  • 인증 및 엔드포인트 관리

  • 에이전트에 대한 도구 기능 노출

스트리밍 및 처리

실시간 스트리밍

Agent Builder는 실시간 응답 스트리밍을 위해 WebSocket에 연결된 AgentCore의 Server-Sent Events(SSE)를 사용합니다.

  • Lambda 함수는 AgentCore 런타임에 대한 SSE 연결을 설정합니다.

  • 스트림은 API Gateway WebSocket에 브리지됩니다.

  • 클라이언트에 token-by-token 응답 전송을 활성화합니다.

  • 장기 실행 요청에 대한 연결을 유지합니다.

처리 제약 조건

v4.0.0의 에이전트 처리는 Lambda 실행 제한 시간으로 제한됩니다.

  • 최대 처리 시간: 15분

  • 동기식 처리 모델

  • 대화형 에이전트 및 중간 워크플로에 적합

  • v4.1+에 대한 확장된 비동기 지원 계획

메모리 관리

단기 메모리

사용자 지정 MemoryHookProvider를 사용하는 모든 에이전트에 대해 기본적으로 활성화됩니다.

  • Strands 콜백 핸들러를 통해 대화 이벤트 캡처

  • 컨텍스트 격리를 위해 actorId 및 sessionId별로 구성

  • 세션 내에서 대화 컨텍스트를 유지합니다.

  • AgentCore 메모리와 자동 통합

장기 메모리

strands_tools의 AgentCore 메모리 도구를 사용하는 선택적 기능:

  • Agent Builder UI의 단순 토글

  • 기본 설정을 사용한 의미 체계 메모리 전략

  • 자연 도구 호출을 통한 에이전트 제어 액세스

  • 세션 간에 추출된 인사이트를 저장합니다.

  • conversationId를 sessionId로 사용

관찰성

AWS OpenTelemetry Distro(ADOT)

에이전트는 컨테이너 빌드 중에 자동으로 계측됩니다.

  • 에이전트 작업을 위한 자동 트레이스 생성

  • 서비스 경계를 넘어 분산 추적

  • 상관관계 IDs 사용한 구조화된 로깅

  • CloudWatch 트랜잭션 검색과 통합

인증 흐름

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

워크플로 빌더

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

워크플로 아키텍처

주요 구성 요소

  • 감독자 에이전트: 사용자 요청을 수신하고 특수 에이전트에게 위임하는 진입점 에이전트

  • 전문 에이전트: 감독자를 위한 도구로 등록된 Agent Builder 사용 사례

  • 에이전트 레지스트리: 에이전트 구성 및 메타데이터를 저장하는 DynamoDB 테이블

  • 오케스트레이션 계층: 에이전트의 SDK 구현을 도구 패턴으로 스트랜드합니다.

에이전트 인스턴스화

로컬 에이전트 생성

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

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

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

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

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

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