Consulta los comentarios en la consola de Google Cloud

En esta página, se describe cómo ver los comentarios de los usuarios finales recibidos en la Google Cloud consola.

Antes de comenzar

Para ver las entradas de comentarios en la Google Cloud consola, asegúrate de lo siguiente:

  • Tu instancia de Agent Runtime tiene seguimiento habilitado.
  • Tu agente está configurado para usar OpenTelemetry (OTel) para generar intervalos de seguimiento y controlar la propagación del contexto de seguimiento. La IU de la consola asigna entradas de comentarios a seguimientos con el atributo de intervalo generado por OpenTelemetry gcp.vertex.agent.event_id.

Ver comentarios

El servicio de comentarios está integrado con la pestaña Seguimientos en la Google Cloud consola. En la pestaña Seguimientos, puedes ver y filtrar seguimientos que tienen comentarios adjuntos en las pestañas Vista de sesiones y Vista de seguimientos.

Para ver las entradas de comentarios de tu agente, haz lo siguiente:

  1. En la Google Cloud consola, navega a la página **Agent Platform > Agentes**.
  2. En el menú de navegación de la izquierda, selecciona Implementaciones.

  3. Selecciona el agente.

    Ir a Implementaciones

    Las instancias de Agent Engine que forman parte del proyecto seleccionado aparecen en la lista. Puedes usar el campo Filtro para filtrar la lista por la columna especificada.

  4. Haz clic en el nombre de la instancia de Agent Engine.

  5. Haz clic en la pestaña Seguimientos. Usa la Vista de sesiones o la Vista de seguimientos para encontrar seguimientos con comentarios:

    • Vista de sesiones:
      1. Filtra la lista de sesiones por la columna Comentarios.
      2. Haz clic en la sesión que deseas ver para mostrar su lista de seguimientos.
      3. Selecciona un ID de seguimiento que muestre una insignia de ícono de comentarios.
    • Vista de seguimientos:
      1. Haz clic en la pestaña Vista de seguimientos.
      2. Filtra la lista de seguimientos por la columna Comentarios.
      3. Selecciona un ID de seguimiento que muestre una insignia de ícono de comentarios.

  6. En el panel de detalles del seguimiento, haz clic en la pestaña Comentarios para ver los detalles de los comentarios, como el tipo de comentario, los comentarios, las etiquetas, el ID y la hora de creación.

Limitaciones de la IU

  • Requisitos del ID de evento: La IU solo admite el seguimiento y la asignación de entradas de comentarios que usan el UUID generado por OpenTelemetry (gcp.vertex.agent.event_id) recuperado de los intervalos de seguimiento.
  • Envíos duplicados: Si se envían varias entradas de comentarios con la misma session_id y event_id combinación, la IU de la consola solo muestra la última entrada de comentarios recibida.

Integración en Cloud Trace

Cuando un usuario envía comentarios, el servicio de comentarios exporta intervalos de telemetría a Cloud Trace. Para ubicar los comentarios de los usuarios junto con los eventos de ejecución del motor de razonamiento, busca y filtra estos intervalos exportados por sus atributos. Para obtener detalles sobre cómo encontrar y ver estos seguimientos, consulta la guía Configura el seguimiento.

Debido a que los seguimientos son inmutables, borrar o actualizar una entrada de comentarios no afecta los seguimientos exportados anteriormente.

Cada seguimiento de telemetría de comentarios contiene un intervalo llamado gcp.vertex.agent.feedback con los siguientes atributos de intervalo y recurso:

Atributo Tipo de atributo Descripción
gcp.project_id Recurso ID del proyecto de la Google Cloud consola.
cloud.resource.id Recurso ID de la instancia del motor de razonamiento.
gcp.vertex.agent.feedback.type Intervalo Tipo de comentario (THUMBS_UP, THUMBS_DOWN, o FEEDBACK_TYPE_UNSPECIFIED).
gen_ai.conversation_id Intervalo ID de sesión asociado con la interacción.
gcp.vertex.agent.event_id Intervalo ID de evento asociado con el turno de conversación específico.
gcp.vertex.agent.feedback.entry.name Intervalo Ruta de acceso al recurso de la entrada de comentarios creada.
gcp.vertex.agent.feedback.labels Intervalo Es opcional. Lista de etiquetas de comentarios.

¿Qué sigue?