Présentation du service de commentaires

Le service Agent Platform Feedback vous permet de collecter et d'analyser les commentaires des utilisateurs à partir des interactions avec vos agents. Il fournit l'infrastructure nécessaire, ce qui vous évite d'avoir à gérer votre propre base de données de commentaires. Le service stocke les réactions des utilisateurs et les associe aux chronologies des événements de conversation correspondants.

Vous pouvez commencer à recueillir les commentaires de vos utilisateurs finaux pour votre agent en intégrant directement l'API du service Feedback ou en utilisant le SDK. L'API et le SDK vous permettent de gérer les entrées de commentaires à l'aide d'opérations CRUDL (création, récupération, mise à jour, suppression et liste) standards, et d'associer des détails de conversation supplémentaires aux entrées de commentaires via la ressource FeedbackContext.

Pour en savoir plus, consultez Gérer les commentaires avec le SDK Python ou l'API REST ou Afficher les commentaires dans la console.

Concepts fondamentaux

  • Entrée de commentaires : suit des données qualitatives discrètes fournies par un utilisateur final. Chaque entrée capture le sentiment binaire, des libellés de commentaires spécifiques et du texte libre facultatif.
  • Type de commentaires : sentiment binaire de l'utilisateur final, représenté par thumbs_up et thumbs_down.
  • **ID de session (session_id) et ID d'événement (event_id)** : champs obligatoires associant les commentaires à un tour de conversation ou à un événement spécifique.
  • Contexte des commentaires : ressource facultative associée à une entrée de commentaires qui stocke les transcriptions ou les journaux de conversation, en préservant le contexte même si la session d’origine est supprimée. Cette ressource peut stocker l' intégralité de la conversation ou les messages sélectionnés par l'utilisateur, selon ce que vous choisissez d'inclure.
  • Libellé de commentaires : classification qui spécifie la nature d'un problème opérationnel ou d'un résultat positif.
    • Les libellés de commentaires positifs (généralement utilisés avec thumbs_up) incluent les suivants :
      • accurate
      • complete
      • helpful
      • on_topic
      • fast
      • safe
      • factual
      • tool_success
    • Les libellés de commentaires négatifs (généralement utilisés avec thumbs_down) incluent les suivants :
      • inaccurate
      • incomplete
      • unhelpful
      • off_topic
      • too_slow
      • unsafe
      • hallucination
      • tool_error

Avant de commencer

Pour utiliser le service Feedback, assurez-vous de disposer des éléments suivants :

Obtenir les rôles requis

Pour obtenir les autorisations nécessaires pour utiliser le service Feedback, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Si vous envoyez des requêtes au service Feedback à partir de Google Cloud, assurez-vous que votre compte de service dispose des autorisations nécessaires. Les comptes de service gérés par l'utilisateur doivent disposer de l'autorisation Utilisateur Agent Platform (aiplatform.user) pour interagir avec le service Feedback.

L' agent de service Reasoning Engine dispose déjà des autorisations nécessaires pour gérer les commentaires. Par conséquent, les requêtes sortantes d'Agent Runtime devraient déjà être autorisées à accéder au service Feedback.

Étape suivante