# 온라인 평가 가져오기
<a name="get-online-evaluations"></a>

`GetOnlineEvaluationConfig` API는 기존 온라인 평가 구성의 전체 세부 정보와 현재 상태를 검색합니다. 이 동기 작업은 데이터 소스, 평가자, 실행 상태 및 운영 메타데이터를 포함한 전체 구성을 반환합니다.

이 API를 사용하여 구성의 수명 주기 상태(`ACTIVE`, , `CREATING`, `CREATE_FAILED``UPDATING`, `DELETING`, 또는 `ERROR`)를 모니터링하고`UPDATE_FAILED`, 현재 실행 상태(`ENABLED` 또는 `DISABLED`)를 확인하고, 평가자 목록, 데이터 소스 설정 및 출력 대상을 포함한 모든 구성 파라미터를 검색합니다.

## 수명 주기 상태
<a name="lifecycle-status"></a>

온라인 평가 구성의 `status` 필드는 수명 주기 상태를 보고합니다. 수명 주기 상태는 평가 작업이 추적을 능동적으로 처리하는지 여부를 제어하는 `executionStatus` 필드와는 별개입니다.
+  `ACTIVE` - 구성이 완전히 프로비저닝되어 사용할 준비가 되었습니다.
+  `CREATING` - 구성이 프로비저닝되고 있습니다. 업데이트하거나 삭제하기 `ACTIVE` 전에 로 전환될 때까지 기다립니다.
+  `CREATE_FAILED` - 생성이 성공적으로 완료되지 않았습니다. 이 상태에서는 구성을 업데이트할 수 없습니다.를 호출`DeleteOnlineEvaluationConfig`하여 구성을 제거한 다음 새 구성을 생성합니다.
+  `UPDATING` - 업데이트가 진행 중입니다. 추가 변경을 수행하기 전에 작업이 완료될 때까지 기다립니다.
+  `UPDATE_FAILED` - 최신 업데이트가 적용되지 않았습니다. 를 `UpdateOnlineEvaluationConfig` 다시 호출하여 재시도하거나를 사용하여 구성을 제거할 수 있습니다`DeleteOnlineEvaluationConfig`.
+  `DELETING` - 구성이 제거되고 있습니다.
+  `ERROR` - 작업이 필요한 문제가 발생했습니다. `failureReason` 필드를 확인하여 문제를 식별합니다. 일반적인 원인으로는 IAM 역할 액세스 부족, 로그 그룹 권한 누락, 서비스 할당량 초과 등이 있습니다. 문제를 해결한 후를 호출`UpdateOnlineEvaluationConfig`하여 다시 시도하거나를 호출`DeleteOnlineEvaluationConfig`하여 구성을 제거합니다.

## AgentCore SDK 및 AWS SDK용 코드 샘플
<a name="get-online-evaluation-code-samples"></a>

다음 코드 샘플은 다양한 개발 접근 방식을 사용하여 온라인 평가 구성 세부 정보를 가져오는 방법을 보여줍니다. 개발 환경 및 기본 설정에 가장 적합한 방법을 선택합니다.

**Example**  

1. 

   ```
   from bedrock_agentcore_starter_toolkit import Evaluation
   
   # Initialize the evaluation client
   eval_client = Evaluation()
   
   config_id = "config-abc123"
   print(f"\nUsing config_id: {config_id}")
   
   config_details = eval_client.get_online_config(config_id)
   # Display configuration details
   print(f"Config Name: {config_details['onlineEvaluationConfigName']}")
   print(f"Config ID: {config_details['onlineEvaluationConfigId']}")
   print(f"Status: {config_details['status']}")
   ```

1. 

   ```
   import boto3
   
   client = boto3.client('bedrock-agentcore-control')
   
   response = client.get_online_evaluation_config(
       onlineEvaluationConfigId='your_config_id'
   )
   ```

1. 

   ```
   aws bedrock-agentcore-control get-online-evaluation-config \
       --online-evaluation-config-id your_config_id
   ```

## 콘솔
<a name="get-online-evaluation-console"></a>

콘솔 인터페이스를 통해 특정 온라인 평가 구성에 대한 자세한 정보를 볼 수 있습니다.

 **온라인 평가 구성 세부 정보를 가져오는 방법** 

1. Amazon Bedrock AgentCore 콘솔을 엽니다.

1. 탐색 창에서 **평가를** 선택합니다.

1. **평가 구성** 카드에서 생성한 평가 구성을 나열하는 테이블을 봅니다.

1. 특정 평가 구성에 대한 정보를 보려면 구성 이름을 선택하여 세부 정보를 확인합니다.