Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]
Un agent qui semble correct dans l’onglet Build peut toujours échouer dans la conversation. Les instructions sont des conseils, pas des garanties : le modèle les interprète, et l’écart entre ce que vous avez écrit et ce que fait l’agent n’apparaît que lorsque vous lui parlez réellement. Utilisez l’onglet Aperçu pour tester votre agent à la fois sur le chat web et la voix avant de le publier.
Canaux de test
L’onglet Aperçu propose deux façons de tester votre agent :
- Chat Web : Un panneau de discussion textuel. C’est là que vous devriez passer la plupart de votre temps de test. C’est plus rapide que la voix, la transcription complète est visible, et vous obtenez une trace de raisonnement en même temps que le chat.
- Appel vocal : Une conversation vocale en direct avec votre agent. La voix a des modes de défaillance que le texte ne révèle jamais, donc testez-la séparément même si le chat fonctionne correctement.
Sélectionnez Chat Web ou Appel Vocal en haut de l’onglet Aperçu pour passer d’un canal de test à l’autre. Un panel de transcription en direct apparaît en parallèle de la conversation.
Avant de commencer
- Enregistrez vos modifications. Le volet Aperçu exécute votre agent sauvegardé, pas les modifications non enregistrées dans l’onglet Build .
- Sachez reconnaître ce qui est « correct ». Notez le résultat attendu avant d’envoyer le premier message.
- Ouvre la carte d’activité. Il est à côté de la discussion instantanée et montre le routage, les appels d’outils et l’exécution du thème. C’est ainsi que l’on distingue une défaillance de raisonnement d’une défaillance de plomberie.
- Commencez une nouvelle session de test entre les scénarios. Le contexte se transmet et contaminera votre prochain résultat.
Les cinq couches à tester
Travaillez vers l’extérieur à partir de la couche la plus simple. Une défaillance dans une couche initiale aura des répercussions en cascade, donc corrigez les problèmes dans l’ordre.
| Couche | Ce que vous testez | Comment savoir que cela fonctionne |
|---|---|---|
| Salutation et étendue | L’agent se présente et comprend son propre travail | Le message d’ouverture correspond à votre description ; il accepte les demandes relevant du périmètre |
| Routing | L’orchestrateur choisit le bon sous-agent | La carte d’activité montre le spécialiste qui devait être appelé |
| Outils et sujets | Les actions s’exécutent effectivement et renvoient les données | Les vraies valeurs reviennent, pas les espaces réservés ni le silence |
| Connaissances | Les réponses sont fondées sur vos sources | Les citations apparaissent et correspondent à vos sources configurées |
| Balises de sécurité | Refus, escalade et mise en attente des règles métier | L’agent refuse, fait remonter ou signale exactement comme demandé |
Tests dans le chat web
Parcourez d’abord le scénario nominal
Lit un utilisateur réaliste avec un objectif de bout en bout, pas un testeur qui teste les fonctionnalités au hasard. Par exemple, pour un agent de voyage, cela signifie réserver un vrai voyage de bout en bout plutôt que de demander « pouvez-vous réserver des vols ? »
- Ouvrir l’objectif naturellement, comme un vrai utilisateur le ferait.
- Répondez aux questions de l’agent en tant qu’utilisateur coopératif.
- Suivez le flux jusqu’à une vraie conclusion : une réservation, un résumé, une résolution.
- Demandez un récapitulatif à la fin, puis vérifiez chaque fait par rapport à la transcription.
Alors casse-la exprès
Le cas nominal prouve que l’assistant peut travailler. Ces scénarios prouvent qu’il tombe en panne de façon sûre.
| Test | Éléments à envoyer | Que devrait-il se passer |
|---|---|---|
| Détails manquants | Ignorer un champ obligatoire nécessaire à l’assistant | Il demande exactement ce champ, une seule fois |
| Changement d’avis | Annuler une décision en cours de processus | Il se met à jour sans perdre le contexte précédent |
| Hors périmètre | Posez une question en dehors de son domaine | Elle décline et redirige, sans improviser |
| Escalade | Déclenchez une règle de transfert documentée | Il bascule au lieu de tenter d’exécuter la tâche |
| Règle métier | Dépasser une limite définie, comme le budget | Il signale explicitement le conflit |
| Mémoire de session | Demandez-lui de répéter un détail d’avant | Il se souvient avec précision, sans redemander |
Lire le journal d’activité, pas seulement y répondre
Le chat vous dit ce que l’agent a dit. La carte Activité vous indique ce qu’elle a fait. Lorsqu’une réponse semble fausse, la carte vous indique où la corriger :
- Un mauvais spécialiste invoqué → vos instructions de routage ou descriptions de sous-agents sont ambiguës.
- Bon spécialiste, mauvais résultat → les instructions du sous-assistant doivent être améliorées.
- L’outil a fonctionné mais n’a rien renvoyé → l’outil ou le sujet est cassé, pas la demande.
- Aucun appel d’outil → l’assistant a répondu à partir du modèle au lieu de vos données. Considérez chaque valeur de cette réponse comme non vérifiée.
Tests vocaux
La voix n’est pas une conversation instantanée en ligne avec audio associé. Il y a des modes de défaillance : le texte n’apparaîtra jamais, donc testez-le séparément même si la conversation instantanée passe proprement.
- Accordez l’accès au microphone, puis lancez la conversation vocale et confirmez que le statut atteint un état d’écoute connecté.
- Formulez une demande complète naturellement au lieu de lire un script mot par mot.
- Regardez la transcription en direct. Si la reconnaissance vocale vous entend mal, la réponse de l’agent répond à une question différente de celle que vous avez posée.
- Interrompez l’agent en plein milieu de sa phrase pour vérifier que le barge-in arrête la lecture et se met à écouter.
- Restez silencieux plusieurs secondes pour confirmer qu’il vous invite de nouveau poliment au lieu de raccrocher.
- Demandez un code de confirmation et vérifiez qu’il est écrit caractère par caractère, pas lu comme un mot.
Ce qu’il faut écouter
- Longueur : Tout ce qui dépasse environ trois phrases est trop long pour être suivi à l’oreille.
- Listes et URLs : Elles doivent être résumées et ne doivent jamais être lues à voix haute élément par élément.
- Dates et numéros : « Mardi, 24 mars » fonctionne ; « 2026-03-24 » ne fonctionne pas.
- Confirmation des données critiques : les noms, dates et codes doivent être confirmés en les répétant avant que l’assistant n’agisse sur la base de celles-ci.
Si Speech se comporte comme votre canal de discussion, vos instructions spécifiques à chaque canal ne font pas leur travail. Les instructions de parole et de conversation instantanée sont configurées séparément sur chaque assistant, dans la section Instructions, dans les onglets Parole et Conversation instantanée. Voir l’aperçu des paramètres vocaux et de conversation.
Tip
Faites vos scénarios critiques plus d’une fois, et faites au moins une longue session. Les défaillances intermittentes restent des échecs, et ce sont elles qui arrivent en production.
Quand quelque chose échoue
- Reproduisez-le. Commencez une nouvelle session et réexécutez le même parcours, en notant si elle échoue à chaque fois ou de façon intermittente.
- Localisez-le à l’aide de la carte d’activité : routage, outil, connaissance ou instruction.
- Réparez une chose à la fois. Changer plusieurs instructions en même temps rend impossible de savoir ce qui a fonctionné.
- Sauvegardez, commencez une nouvelle session, puis refaites exactement le même scénario.
- Relancez vos autres scénarios réussis. Les modifications des instructions ont des effets secondaires.
Liste de contrôle des articles prêts à expédier
- Le cas nominal aboutit de bout en bout sans assistance.
- Chaque fait du résumé final peut être rattaché à quelque chose qu’un outil ou une source de connaissances a réellement retourné.
- Aucun texte de substitution n’apparaît nulle part dans une réponse visible par l’utilisateur.
- L’agent rapporte honnêtement une défaillance quand un outil ne retourne rien.
- Les règles d’escalade et de refus s’appliquent de manière fiable.
- Les réponses vocales sont courtes et les codes sont épelés.
- Des scénarios critiques ont été exécutés plus d’une fois, y compris une session longue.