온라인 평가 생성
CreateOnlineEvaluationConfig API는 라이브 트래픽을 사용하여 에이전트의 성능을 지속적으로 모니터링하는 새로운 온라인 평가 구성을 생성합니다. 이 비동기 작업은 에이전트 추적이 정상 작업 중에 생성될 때 에이전트 추적을 평가하도록 서비스를 설정합니다.
온라인 평가를 생성할 때 고유한 구성 이름, 모니터링할 데이터 소스(CloudWatch 로그 그룹 목록 또는 에이전트 엔드포인트), 적용할 평가자 목록(기본 제공 평가자와 사용자 지정 평가자를 합친 최대 10명)을 지정합니다. 또한 실행을 위해 IAM 서비스 역할 ARN을 제공합니다. enableOnCreate 파라미터는 필수이며 생성 즉시 평가가 실행되기 시작할지( executionStatus = true) 아니면 명시적으로 활성화될 때까지 비활성화된 상태로 유지될지( executionStatus = false) 결정합니다.
실행 상태 제어
executionStatus 파라미터는 평가 작업이 트레이스를 능동적으로 처리하는지 여부를 결정합니다.
-
ENABLED - 평가 작업이 지속적으로 실행되어 수신 추적을 처리하고 평가 결과를 생성합니다.
-
비활성화됨 - 평가 구성이 존재하지만 작업이 일시 중지되었습니다. 트레이스는 처리되거나 평가되지 않습니다.
CLI를 사용하여 실행 상태를 제어할 수 있습니다.
# Pause a running online evaluation agentcore pause online-eval "your_config_name" # Resume a paused online evaluation agentcore resume online-eval "your_config_name"
평가자 보호
를 ENABLED 로 executionStatus 설정하여 평가 구성을 생성하면 선택한 사용자 지정 평가자가 자동으로 잠깁니다. 잠긴 후:
-
수정 불가 - 평가자의 구성, 프롬프트 또는 설정을 업데이트할 수 없습니다. 변경해야 하는 경우 새 평가자를 복제합니다.
-
삭제 불가 - 평가 작업이 평가자를 사용하는(실행 중인) 동안에는 평가자를 삭제할 수 없습니다.
AgentCore CLI, AgentCore SDK 및 AWS SDK용 코드 샘플
다음 코드 샘플은 다양한 개발 접근 방식을 사용하여 온라인 평가 구성을 생성하는 방법을 보여줍니다. 개발 환경 및 기본 설정에 가장 적합한 방법을 선택합니다.
예
콘솔
Amazon Bedrock AgentCore 콘솔의 시각적 인터페이스를 사용하여 온라인 평가 구성을 생성할 수 있습니다. 이 방법은 평가 설정을 구성하는 데 도움이 되는 안내 양식 및 검증을 제공합니다.
AgentCore 온라인 평가를 생성하려면
-
Amazon Bedrock AgentCore 콘솔을 엽니다.
-
왼쪽 탐색 창에서 평가를 선택합니다.
-
평가 구성 생성을 선택합니다.
-
(선택 사항) 평가 이름에 온라인 평가 구성의 이름을 입력합니다.
-
(선택 사항) 평가 구성을 생성한 후 활성화하려면 평가 이름 아래의 확인란을 선택합니다.
-
(선택 사항) 평가 구성 설명에 AgentCore 평가 구성에 대한 설명을 입력합니다.
-
(선택 사항) 세션 유휴 제한 시간에 1~60분의 기간을 입력합니다. 기본값은 15분입니다.
-
-
데이터 소스에서 다음 중 하나를 선택합니다.
-
에이전트 엔드포인트로 정의 - AgentCore 런타임에서 이전에 생성한 에이전트를 선택하거나 에이전트를 선택하여 새 에이전트를 생성합니다. 그런 다음 에이전트에서 엔드포인트를 선택합니다.
-
CloudWatch 로그 그룹 선택 - 최대 5개의 로그 그룹을 선택합니다. 관찰성을 위해 에이전트가 사용하는 서비스 이름을 입력합니다. AgentCore 런타임에서 호스팅되는 에이전트의 경우 서비스 이름은 <agent-runtime-name>.<agent-runtime-endpoint-name> 형식을 따릅니다. AgentCore 런타임 외부에서 실행되는 에이전트의 경우 서비스 이름은 OTEL_RESOURCE_ATTRIBUTES 환경 변수에 구성됩니다.
-
-
평가자에서 기본 제공 평가자와 사용자 지정 평가자를 포함하여 평가 구성당 최대 10명의 평가자를 선택합니다.
-
(선택 사항) 필터의 경우 평가할 세션을 식별하기 위해 최대 5개의 필터를 추가합니다.
-
(선택 사항) 샘플링에서 0.01%에서 100% 사이의 백분율을 선택하여 평가되는 세션의 백분율을 제어합니다. 기본값은 10%입니다.
-
Amazon Bedrock IAM 역할에서 다음 중 하나를 선택합니다.
-
기존 역할 사용 - 이미 필요한 권한이 있는 IAM 서비스 역할을 선택합니다.
-
새 역할 생성 - 새 IAM 서비스 역할을 생성합니다.
-
-
평가 구성 생성을 선택하여 AgentCore 온라인 평가 구성을 생성합니다.