Afficher les commentaires dans la console Google Cloud

Cette page explique comment afficher les commentaires des utilisateurs finaux reçus dans la Google Cloud console.

Avant de commencer

Pour afficher les entrées de commentaires dans la Google Cloud console, assurez-vous des points suivants :

  • Le traçage est activé pour votre instance Agent Runtime .
  • Votre agent est configuré pour utiliser OpenTelemetry (OTel) afin de générer des segments de trace et de gérer la propagation du contexte de trace. L'interface utilisateur de la console mappe les entrées de commentaires aux traces à l'aide de l'attribut de segment généré par OpenTelemetry gcp.vertex.agent.event_id.

Voir les commentaires

Le service de commentaires est intégré à l'onglet Traces de la Google Cloud console. Dans l'onglet Traces, vous pouvez afficher et filtrer les traces auxquelles des commentaires sont associés dans les onglets Vue des sessions et Vue des traces.

Pour afficher les entrées de commentaires de votre agent :

  1. Dans la Google Cloud console, accédez à la page **Agent Platform > Agents**.
  2. Dans le menu de navigation de gauche, sélectionnez Déploiements.

  3. Sélectionnez votre agent.

    Accéder à la page "Déploiements"

    Les instances Agent Engine qui font partie du projet sélectionné apparaissent dans la liste. Vous pouvez utiliser le champ Filtrer pour filtrer la liste par colonne spécifiée.

  4. Cliquez sur le nom de votre instance Agent Engine.

  5. Cliquez sur l'onglet Traces. Utilisez la Vue des sessions ou la Vue des traces pour trouver les traces avec des commentaires :

    • Vue des sessions:
      1. Filtrez la liste des sessions par la colonne Commentaires.
      2. Cliquez sur la session que vous souhaitez afficher pour afficher sa liste de traces.
      3. Sélectionnez un ID de trace qui affiche un badge d'icône de commentaire.
    • Vue des traces:
      1. Cliquez sur l'onglet Vue des traces.
      2. Filtrez la liste des traces par la colonne Commentaires.
      3. Sélectionnez un ID de trace qui affiche un badge d'icône de commentaire.

  6. Dans le volet des détails de la trace, cliquez sur l'onglet Commentaires pour afficher les détails des commentaires, tels que le type de commentaire, les commentaires, les libellés, l'ID et l'heure de création.

Limites de l'interface utilisateur

  • Exigences concernant l'ID d'événement : l'interface utilisateur n'est compatible qu'avec le suivi et le mappage des entrées de commentaires qui utilisent l'UUID généré par OpenTelemetry (gcp.vertex.agent.event_id) récupéré à partir des segments de trace.
  • Envois en double : si plusieurs entrées de commentaires sont envoyées avec la même combinaison session_id et event_id, l'interface utilisateur de la console n'affiche que la dernière entrée de commentaires reçue.

Intégration à Cloud Trace

Lorsqu'un utilisateur envoie des commentaires, le service de commentaires exporte des segments de télémétrie vers Cloud Trace. Pour localiser les commentaires des utilisateurs à côté des événements d'exécution du moteur de raisonnement, recherchez et filtrez ces segments exportés par leurs attributs. Pour savoir comment trouver et afficher ces traces, consultez le guide Configurer le traçage.

Étant donné que les traces sont immuables, la suppression ou la mise à jour d'une entrée de commentaires n'affecte pas les traces précédemment exportées.

Chaque trace de télémétrie de commentaires contient un segment nommé gcp.vertex.agent.feedback avec les attributs de ressource et de segment suivants :

Attribut Type d'attribut Description
gcp.project_id Ressource ID du projet d'un projet de la Google Cloud console.
cloud.resource.id Ressource ID de l'instance du moteur de raisonnement.
gcp.vertex.agent.feedback.type Segment Type de commentaire (THUMBS_UP, THUMBS_DOWN, ou FEEDBACK_TYPE_UNSPECIFIED).
gen_ai.conversation_id Segment ID de session associé à l'interaction.
gcp.vertex.agent.event_id Segment ID d'événement associé au tour de conversation spécifique.
gcp.vertex.agent.feedback.entry.name Segment Chemin d'accès de ressource de l'entrée de commentaires créée.
gcp.vertex.agent.feedback.labels Segment Facultatif. Liste des libellés de commentaires.

Étape suivante