View a markdown version of this page

온라인 평가 가져오기 - Amazon Bedrock AgentCore

온라인 평가 가져오기

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

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

수명 주기 상태

온라인 평가 구성의 status 필드는 수명 주기 상태를 보고합니다. 수명 주기 상태는 평가 작업이 추적을 능동적으로 처리하는지 여부를 제어하는 executionStatus 필드와는 별개입니다.

  • ACTIVE - 구성이 완전히 프로비저닝되어 사용할 준비가 되었습니다.

  • CREATING - 구성이 프로비저닝되고 있습니다. 업데이트하거나 삭제하기 ACTIVE 전에 로 전환될 때까지 기다립니다.

  • CREATE_FAILED - 생성이 성공적으로 완료되지 않았습니다. 이 상태에서는 구성을 업데이트할 수 없습니다.를 호출DeleteOnlineEvaluationConfig하여 구성을 제거한 다음 새 구성을 생성합니다.

  • UPDATING - 업데이트가 진행 중입니다. 추가 변경을 수행하기 전에 작업이 완료될 때까지 기다립니다.

  • UPDATE_FAILED - 최신 업데이트가 적용되지 않았습니다. 를 UpdateOnlineEvaluationConfig 다시 호출하여 재시도하거나를 사용하여 구성을 제거할 수 있습니다DeleteOnlineEvaluationConfig.

  • DELETING - 구성이 제거되고 있습니다.

  • ERROR - 작업이 필요한 문제가 발생했습니다. failureReason 필드를 확인하여 문제를 식별합니다. 일반적인 원인으로는 IAM 역할 액세스 부족, 로그 그룹 권한 누락, 서비스 할당량 초과 등이 있습니다. 문제를 해결한 후를 호출UpdateOnlineEvaluationConfig하여 다시 시도하거나를 호출DeleteOnlineEvaluationConfig하여 구성을 제거합니다.

AgentCore SDK 및 AWS SDK용 코드 샘플

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

AgentCore SDK
  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']}")
AWS SDK
  1. import boto3 client = boto3.client('bedrock-agentcore-control') response = client.get_online_evaluation_config( onlineEvaluationConfigId='your_config_id' )
AWS CLI
  1. aws bedrock-agentcore-control get-online-evaluation-config \ --online-evaluation-config-id your_config_id

콘솔

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

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

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

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

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

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