Présentation de la console de l'agent IA de commande de repas

Ce document présente la console de l'agent IA pour la commande de repas , une interface Web qui vous permet de configurer, de tester et de surveiller vos agents IA pour la commande de repas.

Hiérarchie des ressources dans la console

La console de l'agent IA pour la commande de repas organise votre environnement de commande en une hiérarchie à trois niveaux qui correspond directement aux ressources de l'API de l'agent IA pour la commande de repas :

• Projet : Google Cloud projet dans lequel l'API de l'agent IA pour la commande de repas est activée et où les contrôles d'accès au niveau du projet sont gérés.
• Marque : ressource Brand de premier niveau représentant la marque de votre restaurant et la configuration partagée de l'agent.
• Magasin : ressource Store individuelle représentant un établissement physique, ses remplacements au niveau du magasin et son Menu associé.

Fonctionnalités clés de la console

Après avoir sélectionné un Google Cloud projet et une marque dans la console de l'agent IA pour la commande de repas, vous pouvez utiliser le menu de navigation pour gérer et observer votre agent de commande dans les domaines suivants :

• Aperçu : surveillez l'état opérationnel, les performances de l'agent et les métriques de performances commerciales sur tous les canaux, y compris le volume de sessions, le taux de confinement, la distribution des résultats et les performances des ventes incitatives.
• Historique des commandes : inspectez les sessions de commande individuelles, filtrez les sessions par magasin, plage de dates ou résultat de la session, examinez les transcriptions de navigation détaillée avec les mises à jour du panier et écoutez l'audio de la session.
• Personnalisation de l'agent : configurez le comportement de l'agent à l'échelle de la marque et pour chaque magasin, y compris les messages de bienvenue, les caractéristiques vocales, les règles de désambiguïsation et les stratégies de vente incitative.
• Magasins et menus : affichez et gérez les établissements, parcourez les éléments de menu ingérés, les groupes de modificateurs et les modificateurs, et inspectez les journaux d'ingestion de menu.
• Aperçu de l'agent : testez les flux de commande de manière interactive à l'aide de la voix ou du texte par rapport à une configuration de magasin et de menu sélectionnée avant de déployer les modifications en production.
• Évaluation : définissez des ensembles de données de test et des scénarios de test, configurez des contextes d’évaluation et des comparateurs d’assertions, exécutez des simulations par lot automatisées et examinez l’historique d’exécution.

Historique des commandes

La page Historique des commandes vous permet d'examiner les sessions de commande effectuées pour une marque, d'enquêter sur les escalades ou les erreurs, et d'analyser la façon dont l'agent a géré les commandes des clients.

Filtrer et exporter des sessions

Dans le tableau de la liste des sessions, chaque ligne affiche l'ID de commande, l'horodatage de début, l'ID du magasin, la durée de la session, le libellé du résultat et l'analyse d'intervention automatisée. Vous pouvez affiner les sessions et exporter des données à l'aide des commandes de la barre d'outils :

• Tous les filtres : filtrez les sessions par ID de session, plage de dates, ID de magasin, libellé de résultat, catégorie d’intervention ou texte de l’énoncé.
• Exporter : téléchargez la liste des sessions filtrées au format CSV pour la création de rapports et l'analyse hors connexion.

Inspecter les détails de la session

Cliquez sur n'importe quelle ligne du tableau Historique des commandes pour ouvrir le panneau Détails de la commande de cette session :

• Récapitulatif et résultat de la session : affichez l'ID de la session, les métadonnées du magasin, la classification globale des résultats (tels que SUCCESS ou les résultats escaladés) et les signaux d'analyse d'intervention expliquant toute intervention humaine ou raison d'échec.
• Transcription de la conversation et lecture audio : écoutez l'enregistrement complet de la session ou l'audio de chaque tour de parole tout en lisant la transcription tour par tour du client et de l'agent.
• Mises à jour de l'état du panier : inspectez la façon dont les articles et les modificateurs du panier du client ont changé à chaque tour de parole, et comparez la commande envoyée par l'agent à la commande finale au point de vente.

Magasins et menus

Les pages Magasins et Menus vous permettent de gérer vos établissements physiques, de parcourir les menus associés à chaque magasin, d'inspecter les hiérarchies de modificateurs et d'examiner l'état d'ingestion des menus.

Gérer les établissements

La page Établissements liste tous les magasins configurés pour la marque. Le tableau affiche l'ID, le nom à afficher, l'adresse physique, les tags attribués, l'état opérationnel (tel que Active ou Disabled) et la date de la dernière mise à jour de chaque magasin.

Sur la page Établissements, vous pouvez effectuer les opérations suivantes :

• Filtrer et rechercher des magasins : filtrez les magasins par état, plage de dates de la dernière mise à jour, emplacement géographique (ville ou état), tags ou ID de magasin. Vous pouvez également effectuer une recherche par ID de magasin, nom ou adresse postale.
• Effectuer des actions par lot : sélectionnez plusieurs magasins à l'aide des cases à cocher du tableau pour ajouter des tags, désactiver des magasins ou supprimer des magasins désactivés en bloc.
• Configurer les paramètres du magasin : cliquez sur l'icône des paramètres de n'importe quel magasin pour ouvrir sa page Paramètres du magasin. Vous pouvez y configurer les détails du magasin, les horaires d'ouverture, les plages horaires, ainsi que la personnalisation de l'agent et les remplacements de vente incitative au niveau du magasin.

Parcourir les menus et les hiérarchies d'articles

La page Menus liste les versions de menu ingérées pour votre marque et vos magasins. Chaque entrée affiche l'ID du menu, l'ID du magasin associé, le nom à afficher, l'horodatage de la dernière mise à jour et les tags. Le menu actif actuel est identifié par un badge Dernier.

Cliquez sur Afficher le menu dans n'importe quelle entrée de menu pour ouvrir le Navigateur de menu interactif :

• Basculer entre les vues de menu : basculez entre une arborescence hiérarchique et une vue sous forme de liste des éléments de menu, des modificateurs et des groupes de modificateurs dans le menu.
• Examiner les détails des articles et des modificateurs : vérifiez les prix des articles, les ajustements de prix des modificateurs, les numéros de combos, les tailles de combos, les quantités par défaut, les contraintes de sélection des modificateurs (telles que les nombres minimal et maximal), les images des articles et l'état de disponibilité (tel que "Rupture de stock" ou "Indisponible").
• Comparaison de menus : sélectionnez jusqu'à deux menus dans tous les magasins pour les comparer côte à côte, les différences étant mises en évidence pour afficher les entrées ajoutées, supprimées ou modifiées.

Aperçu de l'agent

La page Aperçu de l'agent fournit un simulateur interactif pour tester votre agent IA de commande avant de déployer les modifications de configuration sur les canaux destinés aux clients.

Configurer un scénario de test

Avant de commencer une commande simulée, définissez les paramètres de votre scénario de test sur la page Configuration du scénario :

• Magasin : sélectionnez l'établissement cible. L'agent charge le menu actif, les prix, le fuseau horaire et les remplacements de personnalisation spécifiques au magasin.
• Tranche horaire : choisissez Auto pour déterminer automatiquement la tranche horaire à partir de l'heure actuelle, ou sélectionnez une tranche horaire spécifique (telle que "Petit-déjeuner" ou "Déjeuner") pour tester la disponibilité du menu limitée dans le temps.
• Canal : choisissez le canal de commande simulé, tel que Drive, Mobile, Téléphone ou Web.
• Personnalisation de l'agent et stratégie de vente incitative : sélectionnez des profils de personnalisation ou des stratégies de vente incitative spécifiques pour tester la façon dont l'agent applique des comportements à l'échelle de la marque ou expérimentaux.
• Mode d'interaction : sélectionnez Voix pour interagir via l'audio en temps réel à l'aide de votre micro, ou Texte pour tester via une interface de chat.

Tester la commande conversationnelle

Cliquez sur Démarrer la commande pour lancer la session de simulation interactive :

• Conversation en temps réel : en mode vocal, parlez dans votre micro pour converser naturellement avec l'agent. L'agent fournit une transcription vocale tour par tour, une lecture audio et une prise en charge de l'interruption ("barge-in"). En mode texte, saisissez les énoncés du client dans le champ de saisie du chat.
• Suggestions interactives : cliquez sur les chips d'articles et de modificateurs suggérés dans le flux de transcription pour simuler les sélections des clients en un seul clic.
• Suivi du panier en direct : ouvrez le panneau latéral Panier pour observer les mutations du panier en temps réel, tour par tour. Vous pouvez afficher les articles ajoutés, les modificateurs configurés et les quantités de modificateurs, les prix détaillés et le total de la commande en cours.
• Référence au menu dans la session : ouvrez le panneau latéral Menu pendant une session pour parcourir les articles disponibles et les prix de base en même temps que la conversation active.
• Comparaison des sessions historiques : cliquez sur Sessions historiques pour accéder directement à l'Historique des commandes et comparer les résultats simulés aux interactions réelles des clients.

Évaluation

La page Évaluation vous permet de créer et d'exécuter des suites de tests automatisées pour valider le comportement conversationnel, l'exactitude du panier et les règles métier de votre agent de commande avant de déployer les modifications auprès des clients.

Pour en savoir plus sur l'utilisation du framework et des API d'évaluation, consultez Évaluer les agents de commande à l'aide du framework d'évaluation.

Gérer les ensembles de données et les scénarios de test

L'onglet Ensembles de données et scénarios vous permet d'organiser et de gérer vos scénarios de test d'évaluation :

• Ensembles de données d'évaluation : regroupez les scénarios de test associés dans des ensembles de données nommés (tels que les suites de régression, les suites de modification de menu ou les suites de test de vente incitative). Vous pouvez créer des ensembles de données, effectuer des recherches dans des ensembles de données, et importer ou exporter des ensembles de données en tant que fichiers YAML.
• Scénarios d'évaluation : gérez les scénarios de test indépendants importés à partir de fichiers YAML ou convertis à partir de sessions de production. Les scénarios peuvent exister seuls ou être organisés en ensembles de données en les faisant glisser dans un ensemble de données.
• Scénarios de tour de parole de texte statique : définissez des conversations multitours prévisibles et reproductibles dans lesquelles des entrées de texte spécifiques du client sont fournies tour par tour.
• Scénarios de tour de parole de texte dynamique : spécifiez des instructions de commande en langage naturel de haut niveau (par exemple, commander un combo personnalisé avec des demandes alimentaires spéciales) et utilisez la simulation générative pour tester la façon dont l'agent gère les différentes formulations des clients.
• Convertir à partir de sessions historiques : sur la page Historique des commandes, vous pouvez convertir directement les sessions client terminées en scénarios d'évaluation pour reproduire les escalades et éviter les régressions.

Configurer les contextes d'évaluation et les comparateurs

Les scénarios d'évaluation s'appuient sur des contextes pour simuler des environnements de commande réalistes et sur des comparateurs pour évaluer les performances de l'agent :

• Contextes d'évaluation : configurez l'environnement d'exploitation des scénarios de test dans l'onglet Contextes , y compris l'adresse de l'établissement cible, le menu actif et la tranche horaire (tels que "Petit-déjeuner" ou "Déjeuner").
• Comparateurs de résultats de commande : définissez les états finaux attendus du panier dans l'onglet Comparateurs. L'évaluation compare la commande finale de l'agent aux articles attendus, aux sélections de modificateurs et aux quantités d'articles.
• Comparateurs de chaînes d'énoncés d'agent : vérifiez si les réponses vocales ou textuelles de l'agent contiennent les mots clés, les clauses de non-responsabilité ou la formulation spécifique requise à l'aide de la correspondance de sous-chaîne ou d'expression régulière.
• Comparateurs de jugement LLM : utilisez des assertions LLM-as-a-Judge pour évaluer des critères qualitatifs, par exemple si l'agent a salué le client poliment, clarifié les demandes ambiguës de manière appropriée ou respecté les consignes de ton de la marque.

Exécuter des évaluations et examiner l'historique

Vous pouvez exécuter des évaluations sur un ensemble de données entier ou sur des scénarios de test individuels :

• Exécution d'un ensemble de données et d'un scénario : cliquez sur Exécuter l'ensemble de données à côté d'un ensemble de données pour exécuter tous les scénarios qu'il contient, ou sélectionnez des scénarios spécifiques à l'aide des cases à cocher et cliquez sur Exécuter pour tester des scénarios individuels.
• Historique d'exécution : l'onglet Historique suit les évaluations terminées et en cours, en affichant l'horodatage d'exécution, le nom de l'ensemble de données, la durée et le taux global de réussite ou d'échec.
• Inspecter les détails de l'exécution : cliquez sur une évaluation pour examiner les résultats scénario par scénario. Vous pouvez inspecter les transcriptions de conversation tour par tour, comparer le contenu attendu du panier au contenu réel avec des différences visuelles et examiner les explications de réussite et d'échec du comparateur.