피드백 서비스 개요

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

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

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

핵심 개념

  • thought 의견 항목: 최종 사용자가 제공한 개별 정성적 데이터를 추적합니다. 각 항목은 바이너리 감정, 특정 의견 라벨, 선택적 자유 형식 텍스트를 캡처합니다.
  • 의견 유형: 최종 사용자의 바이너리 감정으로, thumbs_up 및 thumbs_down로 표시됩니다.
  • 세션 ID (session_id) 및 이벤트 ID(event_id): 의견을 특정 대화 차례 또는 이벤트에 연결하는 필수 필드입니다.
  • 의견 컨텍스트: 스크립트 또는 대화 로그를 저장하는 의견 항목에 연결된 선택적 리소스로, 원래 세션이 삭제되더라도 컨텍스트를 보존합니다. 이 리소스는 포함할 항목에 따라 전체 대화 또는 사용자가 선택한 메시지를 저장할 수 있습니다.
  • 의견 라벨: 운영 문제의 성격 또는 성공적인 결과를 지정하는 분류입니다.
    • 긍정적인 의견 라벨 (일반적으로 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

시작하기 전에

의견 서비스를 사용하려면 다음이 필요합니다.

  • 기존 Agent Runtime 인스턴스 자세한 내용은 에이전트 개발 키트 (ADK) 에이전트 개발을 참조하세요.
  • 선택사항: 콘솔에서 trace 이벤트 옆에 의견 항목을 보려면 Agent Runtime 인스턴스에 trace가 사용 설정되어 있는지 확인합니다.

필요한 역할 가져오기

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

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

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

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

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

다음 단계