Descripción general del servicio de comentarios

El servicio de comentarios de Gemini Enterprise Agent Platform te permite recopilar y analizar los comentarios de los usuarios sobre las interacciones con tus agentes. Proporciona la infraestructura necesaria, lo que elimina la necesidad de mantener tu propia base de datos de comentarios. El servicio almacena las reacciones de los usuarios y las vincula a los cronogramas de eventos de conversación correspondientes.

Puedes comenzar a recopilar comentarios para tu agente de tus usuarios finales integrando directamente con la API del servicio de comentarios o usando el SDK. La API y el SDK te permiten administrar las entradas de comentarios con operaciones CRUDL estándar (crear, recuperar, actualizar, borrar y enumerar) y adjuntar detalles adicionales de la conversación a las entradas de comentarios a través del recurso FeedbackContext.

Para obtener más información, consulta Administra los comentarios con el SDK de Python o la API de REST o Consulta los comentarios en la consola.

Conceptos básicos

  • Entrada de comentarios: Realiza un seguimiento de los datos cualitativos discretos que proporciona un usuario final. Cada entrada captura un sentimiento binario, etiquetas de comentarios específicas y texto libre opcional.
  • Tipo de comentario: Es la opinión binaria del usuario final, representada por thumbs_up y thumbs_down.
  • ID de sesión (session_id) y de evento (event_id): Son campos obligatorios que conectan los comentarios con un turno o evento de conversación específico.
  • Contexto de los comentarios: Es un recurso opcional adjunto a una entrada de comentarios que almacena transcripciones o registros de conversaciones, lo que conserva el contexto incluso si se borra la sesión original. Este recurso puede almacenar toda la conversación o los mensajes que seleccione el usuario, según lo que elijas incluir.
  • Etiqueta de comentarios: Es una clasificación que especifica la naturaleza de un problema operativo o un resultado exitoso.
    • Las etiquetas de comentarios positivos (que suelen usarse con thumbs_up) incluyen las siguientes:
      • accurate
      • complete
      • helpful
      • on_topic
      • fast
      • safe
      • factual
      • tool_success
    • Las etiquetas de comentarios negativos (que suelen usarse con thumbs_down) incluyen las siguientes:
      • inaccurate
      • incomplete
      • unhelpful
      • off_topic
      • too_slow
      • unsafe
      • hallucination
      • tool_error

Antes de comenzar

Para usar el servicio de comentarios, asegúrate de cumplir con los siguientes requisitos:

Obtén los roles necesarios

Para obtener los permisos que necesitas para usar el servicio de comentarios, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Si realizas solicitudes al servicio de comentarios desde Google Cloud, asegúrate de que tu cuenta de servicio tenga los permisos necesarios. Las cuentas de servicio administradas por el usuario deben tener el permiso de usuario de Agent Platform (aiplatform.user) para interactuar con el servicio de comentarios.

El agente de servicio del motor de razonamiento ya tiene los permisos necesarios para administrar los comentarios, por lo que las solicitudes salientes de Agent Runtime ya deberían tener permiso para acceder al servicio de comentarios.

¿Qué sigue?