Descripción general del servicio de comentarios

El servicio de comentarios de 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 las líneas de tiempo de los eventos de conversación correspondientes.

Para comenzar a recopilar comentarios sobre tu agente de los usuarios finales, realiza una integración directamente con la API del servicio de comentarios o usa 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 comentarios con el SDK de Python o la API de REST o Visualiza 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 el sentimiento binario, las etiquetas de comentarios específicas y el texto opcional de formato libre.
  • Tipo de comentarios: Es el sentimiento binario del usuario final, representado por thumbs_up y thumbs_down.
  • ID de sesión (session_id) y ID de evento (event_id): Son campos obligatorios que conectan los comentarios con un evento o turno de conversación específico.
  • Contexto de comentarios: Es un recurso opcional adjunto a una entrada de comentarios que almacena transcripciones o registros de conversaciones, y conserva el contexto incluso si se borra la sesión original. Este recurso puede almacenar toda la conversación o los mensajes seleccionados por 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.
    • Entre las etiquetas de comentarios positivos (que suelen usarse con thumbs_up), se incluyen las siguientes:
      • accurate
      • complete
      • helpful
      • on_topic
      • fast
      • safe
      • factual
      • tool_success
    • Entre las etiquetas de comentarios negativos (que suelen usarse con thumbs_down), se 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 tener lo siguiente:

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 mediante 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 de Reasoning Engine 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?