

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

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

Agent Builder는 프로덕션 지원 AI 에이전트를 생성하기 위한 포괄적인 구성 옵션을 제공합니다. 이 섹션에서는 Agent Builder 배포를 구성하고 관리하는 방법을 설명합니다.

## 시스템 프롬프트 구성
<a name="system-prompt-configuration"></a>

시스템 프롬프트는 에이전트의 동작, 성격 및 기능을 정의합니다. 시스템 프롬프트를 구성하려면:

1. Agent Builder 마법사에서 **에이전트 구성** 단계로 이동합니다.

1. 텍스트 편집기에서 시스템 프롬프트 템플릿을 편집합니다.

1. 다음에 대한 명확한 지침을 포함합니다.
   + 에이전트의 역할 및 목적
   + 사용 가능한 도구(MCP 서버) 사용 방법
   + 응답 형식 지정 기본 설정
   + 동작 지침

1. 필요한 경우 **기본값으로 재설정** 버튼을 사용하여 원래 템플릿을 복원합니다.

 **에이전트 프롬프트 모범 사례:** 
+ 에이전트의 기능 및 제한 사항에 대해 구체적으로 설명합니다.
+ 원하는 동작의 명확한 예를 제공합니다.
+ 도구 사용 및 호출 시기에 대한 지침 포함
+ 응답 형식 기대치 정의
+ 에이전트 동작에 대한 경계 설정

## MCP 서버 통합
<a name="mcp-server-integration"></a>

모델 컨텍스트 프로토콜(MCP) 서버는 에이전트에게 엔터프라이즈 도구 및 데이터 소스에 대한 액세스 권한을 제공합니다. MCP 서버를 구성하려면:

1. **에이전트 구성** 단계에서 **MCP 서버** 섹션을 찾습니다.

1. 드롭다운 메뉴에서 사용 가능한 MCP 서버 중에서 선택합니다.

**참고**  
에이전트 배포 전에 MCP 서버를 구성하고 액세스할 수 있어야 합니다. 에이전트는 구성된 MCP 서버에서 노출되는 도구를 자동으로 검색하고 사용합니다. 서버 설정 및 도구 구성은 MCP 설명서를 참조하세요.

## 메모리 설정
<a name="memory-settings"></a>

Agent Builder는 컨텍스트와 지식을 유지하기 위한 두 가지 유형의 메모리를 제공합니다.

 **단기 메모리** 

모든 에이전트에 대해 기본적으로 활성화됩니다.
+ 세션 내에서 대화 컨텍스트를 유지합니다.
+ 사용자 메시지 및 에이전트 응답을 자동으로 캡처합니다.
+ 적절한 격리를 위해 actorId 및 sessionId에 의해 구성됨
+ 구성 필요 없음

 **장기 메모리** 

세션 간에 인사이트를 저장하기 위한 선택적 기능:

1. **에이전트 구성** 단계에서 **메모리 구성** 섹션을 찾습니다.

1. 토글 **활성화할 장기 메모리를 활성화합니다**.

1. 활성화되면 에이전트는 다음을 수행할 수 있습니다.
   + 대화 전반에 걸쳐 중요한 정보 추출 및 저장
   + 이전 세션에서 관련 컨텍스트 검색
   + 사용자 기본 설정 및 기록에 대한 지식 구축

**참고**  
장기 메모리는 의미 체계 메모리 전략 및 기본 보존 설정과 함께 AgentCore 메모리를 사용합니다.

## Agent Builder 배포 모니터링
<a name="monitoring-agent-builder"></a>

Agent Builder는 CloudWatch 대시보드 및 지표를 통해 포괄적인 모니터링을 제공합니다.

 **CloudWatch 대시보드 액세스** 

1. AWS 계정의 CloudWatch 콘솔로 이동합니다.

1. 왼쪽 탐색 창에서 **대시보드**를 선택합니다.

1. 라는 대시보드를 찾습니다`AgentBuilder-<UseCaseId>`.

1. 실시간 지표 및 과거 성능 데이터를 봅니다.

 **로그 액세스 및 분석** 

에이전트 로그는 CloudWatch Logs에서 사용할 수 있습니다.

1. AWS 콘솔에서 CloudWatch Logs로 이동합니다.

1. 접두사가 인 로그 그룹을 찾습니다`/aws/bedrock-agentcore/runtimes/`.

1. CloudWatch Insights를 사용하여 로그를 쿼리하고 분석합니다.

1. 특정 요청 IDs 또는 오류 패턴을 검색합니다.