Tester votre action conversationnelle

L'environnement de développement Actions Builder et le SDK Actions proposent plusieurs méthodes pour tester votre projet Actions à chaque étape du cycle de développement, des tests de développement interactifs aux tests bêta pour les utilisateurs finaux.

Utilisez les fonctionnalités suivantes pour améliorer la qualité et la fiabilité de votre action, du développement initial à sa publication:

  • Les tests manuels via le simulateur vous permettent de tester votre action dans la console Actions au fur et à mesure que vous la développez.
  • Les tests automatisés à l'aide de frameworks de test et de l'API Actions vous permettent de générer des tests automatisés et reproductibles.
  • Les tests utilisateur disponibles avec les versions alpha et bêta en version limitée vous permettent de bénéficier de tests et de commentaires concrets.

Tests manuels avec le simulateur

Le simulateur de la console Actions vous permet de tester votre action manuellement via une interface Web conviviale qui simule des appareils et leurs paramètres. Dans la console, cliquez sur Test (Tester) pour activer le simulateur afin d'effectuer des tests sur le projet actuellement sélectionné.

Figure 1. Interface du simulateur de la console Actions affichant les options de saisie.

Le simulateur vous permet de spécifier l'appareil cible (écran connecté, téléphone, enceinte), le mode de saisie (tactile, voix, clavier), la langue et l'emplacement de l'environnement de test manuel. Ces options vous permettent de tester rapidement et de manière interactive les fonctionnalités de votre action sur différents appareils et dans différentes régions.

En savoir plus sur le simulateur de la console Actions

Tests automatisés avec l'API Actions

L'écriture de tests automatisés pour votre action peut vous aider à vous assurer que la logique de conversation de votre action fonctionne comme prévu, même lorsque de nouvelles modifications du code sont introduites, sans avoir à tester manuellement le code vous-même à chaque fois.

La bibliothèque de test Node.js utilise l'API Actions pour interagir avec le code de votre projet. La bibliothèque de tests vous permet de définir une suite de tests qui envoie des requêtes à votre action et effectue des assertions sur ce résultat pour vérifier les informations spécifiques à l'état de conversation de votre action.

L'API Actions fournit des points de terminaison REST qui vous permettent de créer un brouillon de votre action, d'interagir avec elle de manière programmatique à l'aide de requêtes et de rechercher des données d'intent mis en correspondance pour une requête donnée. Si vous souhaitez utiliser directement ces points de terminaison, vous pouvez télécharger la bibliothèque cliente de l'API Node.js Actions.

La bibliothèque de test vous permet de tester une seule série de conversation en envoyant une requête à l'aide de la fonction sendQuery. Cette méthode utilise une requête textuelle en entrée et produit une sortie structurée qui contient le contenu de l'invite présentée à l'utilisateur, ainsi que d'autres informations de diagnostic expliquant comment la requête a été traitée. Vous pouvez utiliser des méthodes d'assertion intégrées dans l'objet de test de sortie pour vérifier le comportement de votre action, comme l'intent correspondant et la scène actuelle.

L'exemple suivant présente un test qui affirme qu'une action est déclenchée avec la réponse de bienvenue appropriée:

it('starts Action and enters the Welcome scene', async function() {
    testManager.setTestSurface('SMART_DISPLAY');
    await testManager.sendQuery('Talk to my test app');
    testManager.assertSpeech('Hello World!');
    testManager.assertText('Hello World!');
    testManager.assertIntent('actions.intent.MAIN');
    testManager.assertScene('Welcome');
    await testManager.sendStop();
    testManager.assertConversationEnded();
});

Consultez l'exemple fonctionnel complet de la suite de tests écrite en Node.js pour notre exemple de code des composants de conversation.

Pour savoir comment vous lancer avec ce framework de test, consultez les instructions de la bibliothèque de test Node.js.

Tests utilisateur avec les versions alpha et bêta

La console Actions offre des options pour publier votre action dans des canaux de publication limités afin de la tester par un ensemble d'utilisateurs de votre choix. Dans la console, vous pouvez publier votre action dans les versions alpha et bêta, ce qui permet à un nombre limité d'utilisateurs de la tester et de donner leur avis au début du processus de développement. Cette fonctionnalité vous permet d'identifier et de résoudre les problèmes techniques ou liés à l'expérience utilisateur avant de publier votre action en production.

Figure 2. L'interface "Versions" de la console Actions vous permet de configurer les versions alpha et bêta de votre action.

La version alpha vous permet de diffuser votre action auprès d'un ensemble de 20 utilisateurs désignés par les développeurs, qui peuvent ensuite la tester sur des appareils dotés de l'Assistant Google. Les versions alpha sont idéales pour les tests internes, car elles ne nécessitent pas de processus d'examen des actions de Google. Les testeurs alpha ont immédiatement accès à votre action lorsqu'elle est disponible sur cette version.

La version bêta vous permet de diffuser votre action auprès d'un ensemble de 200 utilisateurs désignés par les développeurs, qui peuvent ensuite la tester sur des appareils dotés de l'Assistant Google. Les versions bêta sont idéales pour donner accès à des utilisateurs externes à votre organisation lorsque votre projet a fait l'objet d'un examen complet par Google. Lorsque vous êtes satisfait du résultat de votre test bêta, vous pouvez déployer la version bêta en production, car elle a déjà été examinée pour vérifier qu'elle respecte les règles de Google.

Pour en savoir plus sur les versions disponibles, consultez la documentation sur les versions de la console Actions.