

# 기본 제공 도구
<a name="Built-in-tools"></a>

CloudWatch를 사용하면 에이전트가 `Code interpreter tool` 및 `Browser use tool` 같은 기본 제공 도구를 어떤 방식으로 사용하여 작업을 완료하는지 시각적으로 파악할 수 있습니다. CloudWatch에서는 각 도구에 대한 모니터링 기능을 제공합니다. Amazon Bedrock AgentCore 기본 제공 도구에 대한 자세한 내용은 [Amazon Bedrock AgentCore 기본 제공 도구를 사용하여 애플리케이션과 상호 작용](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/built-in-tools.html) 섹션을 참조하세요.

**Topics**
+ [Code Interpreter 도구](#Code-interpreter-tool)
+ [브라우저 사용 도구](#Browser-use-tool)

## Code Interpreter 도구
<a name="Code-interpreter-tool"></a>

다음과 같은 작업에 Code Interpreter 도구를 사용할 수 있습니다.
+ 코드 실행 성공률, 런타임 기간, 리소스 사용량 추적
+ 메모리 사용량 및 컴퓨팅 리소스 할당 모니터링
+ 코드 실행 패턴 및 최적화 기회 분석
+ 실패한 실행에 대한 오류 발생률 및 디버깅 정보 관찰
+ 보안 샌드박스 격리 및 규정 준수 지표 추적

![Code Interpreter 도구 보기](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/monitoring/images/Code_interpreter.png)

+ **도구** - 브라우저 도구를 통해 수행된 가져오기 작업 및 API 직접 호출을 모니터링할 수 있습니다. 대시보드를 보려면 **이름**에서 도구를 선택합니다.

  **세부 정보 보기**를 선택하여 리소스 세부 정보를 봅니다.  
![Code Interpreter 도구 세부 정보](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/monitoring/images/Built-in-tools-details.png)
  + **시작된 세션** - 에이전트가 시작한 Code Interpreter 세션의 총 수입니다. 각 세션은 에이전트가 코드를 실행하고, 데이터를 분석하고, 출력을 생성할 수 있는 샌드박스 환경을 나타냅니다. 이 지표를 모니터링하여 Code Interpreter 사용량 및 용량 계획을 추적할 수 있습니다.
  + **연결**- Code Interpreter 런타임 환경에 대한 활성 연결 수입니다. 여기에는 성공한 연결 및 연결 시도가 둘 다 포함되므로, 리소스 사용률 및 동시 사용 패턴을 추적하는 데 도움이 됩니다.
  + **연결 오류** - 시스템 문제, 리소스 제약 또는 구성 문제로 인해 Code Interpreter 환경에 연결하는 데 실패한 횟수입니다. 연결 오류율이 높으면 조사가 필요한 인프라 문제가 발생했을 가능성이 있습니다.
  + **연결 스로틀** - 허용된 한도 또는 리소스 제약 조건을 초과했기 때문에 스로틀링된 연결 요청 수입니다. 이 지표를 모니터링하면 Code Interpreter 사용량이 언제 용량 한도에 근접하는지, 그리고 언제 규모 조정을 해야 하는지 식별할 수 있습니다.
  + **청구된 총 CPU 시간** - Code Interpreter 세션에서 사용한 총 컴퓨팅 시간이며, CPU 시간 단위로 측정됩니다. 이 지표는 리소스 비용을 추적하고, 에이전트 워크로드 전반에서 코드 실행 효율성을 최적화하는 데 도움이 됩니다.
  + **청구된 총 메모리 시간** - 시간 경과에 따른 Code Interpreter 세션별 총 메모리 사용량이며, 메모리 시간 단위로 측정됩니다. 이 지표를 사용하여 비용을 추적하고, 최적화가 필요할 수 있는 메모리 집약적 코드 실행 패턴을 식별할 수 있습니다.
+ **도구 세션** - 도구가 사용된 모든 연결된 세션을 살펴봅니다.  
![도구 세션 보기](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/monitoring/images/Tool-sessions.png)

  **총 세션**에서 **세션 ID**를 선택하여 세션 대시보드를 봅니다.
+ **트레이스** - 관찰성이 활성화된 에이전트에 대한 샘플 트레이스를 살펴봅니다.  
![트레이스 보기](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/monitoring/images/Traces-view.png)

  **트레이스**에서 **트레이스 ID**를 선택하여 트레이스 세부 정보를 살펴봅니다.

![트레이스 요약 보기](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/monitoring/images/Trace-summary.png)


## 브라우저 사용 도구
<a name="Browser-use-tool"></a>

다음과 같은 작업에 브라우저 사용 도구를 사용할 수 있습니다.
+ 브라우저 탐색 패턴, 페이지 로드 시간, 상호 작용 성공률 추적
+ 브라우저 세션 기간 및 리소스 사용률 관찰
+ 가져오기 오류 분석 및 브라우저 자동화 문제 해결
+ 브라우저 세션 기간 및 리소스 사용률 관찰
+ 보안 샌드박스 성능 및 격리 효과 추적

**참고**  
**도구**, **도구 세션**, **트레이스** 탭의 사용 방식과 필드 항목은 **Code Interpreter 도구**와 유사합니다. 해당 필드에 대한 자세한 내용은 [Code Interpreter 도구](#Code-interpreter-tool) 섹션을 참조하세요.