피드백 서비스 개요

Agent Platform Feedback 서비스를 사용하면 에이전트와의 상호작용에서 사용자 의견을 수집하고 분석할 수 있습니다. 자체 의견 데이터베이스를 유지보수할 필요가 없는 필수 인프라를 제공합니다. 이 서비스는 사용자 반응을 저장하고 이를 상응하는 대화 이벤트 타임라인에 연결합니다.

Feedback 서비스 API와 직접 통합하거나 SDK를 사용하여 최종 사용자로부터 에이전트에 대한 의견 수집을 시작할 수 있습니다. API 및 SDK를 사용하면 표준 CRUDL (만들기, 검색, 업데이트, 삭제, 나열) 작업을 사용하여 의견 항목을 관리하고 FeedbackContext 리소스를 통해 의견 항목에 추가 대화 세부정보를 첨부할 수 있습니다.

자세한 내용은 Python SDK 또는 REST API로 의견 관리 또는 콘솔에서 의견 보기를 참고하세요.

핵심 개념

  • 의견 항목: 최종 사용자가 제공한 개별 정성적 데이터를 추적합니다. 각 항목은 바이너리 감정, 구체적인 의견 라벨, 선택적 자유 형식 텍스트를 캡처합니다.
  • 의견 유형: 최종 사용자의 바이너리 감정으로, thumbs_up 및 thumbs_down으로 표시됩니다.
  • 세션 ID (session_id) 및 이벤트 ID (event_id): 의견을 특정 대화 턴 또는 이벤트에 연결하는 데 필요한 필드입니다.
  • 의견 컨텍스트: 원본 세션이 삭제되더라도 컨101} 텍스트를 보존하는 트랜스크립트 또는 대화 로그를 저장하는 의견 항목에 연결된 선택적 리소스입니다. 이 리소스는 포함할 항목에 따라 전체 대화 또는 사용자가 선택한 메시지를 저장할 수 있습니다.
  • 의견 라벨: 운영 문제 또는 성공적인 결과의 특성을 지정하는 분류입니다.
    • 긍정적인 의견 라벨 (일반적으로 thumbs_up과 함께 사용됨)에는 다음이 포함됩니다.
      • accurate
      • complete
      • helpful
      • on_topic
      • fast
      • safe
      • factual
      • tool_success
    • 부정적인 의견 라벨 (일반적으로 thumbs_down과 함께 사용됨)에는 다음이 포함됩니다.
      • inaccurate
      • incomplete
      • unhelpful
      • off_topic
      • too_slow
      • unsafe
      • hallucination
      • tool_error

시작하기 전에

Feedback 서비스를 사용하려면 다음이 있어야 합니다.

  • 기존 Agent Runtime 인스턴스. 자세한 내용은 에이전트 개발 키트 에이전트 개발을 참고하세요.
  • 선택사항: 콘솔에서 추적 이벤트 옆에 의견 항목을 보려면 Agent Runtime 인스턴스에 추적이 사용 설정되어 있어야 합니다.

필요한 역할 가져오기

Feedback 서비스를 사용하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참고하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

에서 Feedback 서비스에 요청하는 경우 Google Cloud서비스 계정에 필요한 권한이 있는지 확인하세요. 사용자 관리형 서비스 계정에는 Feedback 서비스와 상호작용할 수 있는 Agent Platform 사용자 (aiplatform.user) 권한이 있어야 합니다.

The Reasoning Engine Service Agent 는 의견을 관리하는 데 필요한 권한을 이미 가지고 있으므로, Agent Runtime에서 나가는 아웃바운드 요청은 이미 Feedback 서비스에 액세스할 권한을 갖습니다.

다음 단계