Projets de compilation

Un projet Actions regroupe toutes vos actions dans un seul conteneur. Vous publiez ce projet sur Actions on Google pour que l'Assistant Google sache comment découvrir et appeler vos expériences de conversation.

composants du projet Actions
Figure 1. Structure du projet Actions

Vous utilisez les composants de bas niveau suivants pour compiler votre projet Actions:

  • Les paramètres et ressources définissent les métadonnées et les ressources du projet, telles que les icônes de projet. Google utilise ces informations pour publier vos actions dans le répertoire de l'Assistant, afin que les utilisateurs puissent les découvrir et les appeler.

  • Les intents représentent une tâche à exécuter, comme une entrée utilisateur ou un événement système qui doit être traité. Le type d'intent le plus courant que vous utiliserez sont les intents utilisateur. Ces intents vous permettent de déclarer des phrases d'entraînement naturellement développées par le moteur de compréhension du langage naturel (NLU) pour inclure de nombreuses autres expressions similaires. La NLU utilise l'agrégation de ces expressions pour entraîner un modèle de langage que l'Assistant utilise pour faire correspondre l'entrée utilisateur. Au cours d'une conversation, si une entrée utilisateur correspond au modèle de langage de l'intent, l'environnement d'exécution de l'Assistant envoie l'intent à votre action afin qu'il puisse la traiter et répondre à l'utilisateur.

  • Les types vous permettent d'extraire des données structurées d'une entrée utilisateur. En annotant les phrases d'entraînement avec des types, la NLU peut extraire des données structurées pertinentes et vous évite d'avoir à analyser les entrées ouvertes.

  • Les Scenes (Scènes) traitent les intents et constituent les principaux exécuteurs de logique pour vos actions. Ils peuvent remplir des emplacements, évaluer une logique conditionnelle, renvoyer des invites à l'utilisateur et même appeler des services Web externes pour exécuter la logique métier. Combinées à des intents, les scènes vous permettent de détecter efficacement des entrées utilisateur ou des événements système spécifiques, et d'exécuter la logique correspondante.

  • Les invites définissent des réponses statiques ou dynamiques que vous utilisez pour répondre aux utilisateurs.

  • Les webhooks vous permettent de déléguer des tâches supplémentaires aux services Web (fulfillment), comme la validation des données ou la génération des invites. Vos actions communiquent avec votre traitement via un protocole de webhook basé sur JSON.

  • Interactive Canvas vous permet de créer des expériences riches et immersives à l'aide d'applications Web qui utilisent le langage HTML, CSS et JavaScript.

Créer un projet

Vous devez créer un projet dans la console Actions avant de pouvoir développer pour l'Assistant Google. Pour créer un projet :

  1. Accédez à la console Actions.
  2. Cliquez sur Nouveau projet.
  3. Saisissez un nom pour votre projet, puis cliquez sur Créer un projet.
  4. Sur l'écran What kind of Action do you want to build? (Quel type d'action voulez-vous créer ?), sélectionnez la catégorie qui représente le mieux votre projet, puis cliquez sur Next (Suivant).
  5. Sur l'écran How do you want to build it (Comment voulez-vous le compiler), sélectionnez une méthode de compilation, puis cliquez sur Start build (Commencer à compiler). Par exemple, vous pouvez commencer avec un projet vide ou avec un exemple.

Définir les informations du projet

Les paramètres et ressources de votre projet définissent des informations sur votre projet, telles que la compatibilité des caractéristiques et des surfaces, les paramètres régionaux compatibles, le nom à afficher, la description, les logos, etc. Le tableau suivant décrit les principaux paramètres et ressources que vous fournissez. Actions on Google utilise ces informations pour déployer et publier votre projet dans le répertoire de l'Assistant.

Nom Description
Informations de l'annuaire Fournit des informations permettant à Actions on Google de publier votre projet dans le répertoire de l'Assistant. Inclut des métadonnées et des descriptions sur votre projet, ainsi que des ressources image pour les logos et les images de bannière.
Ciblage géographique Configure les paramètres régionaux dans lesquels vos actions sont disponibles.
Fonctionnalités de surface Configure les surfaces sur lesquelles vos actions sont disponibles.
Informations détaillées sur l'entreprise Indique les coordonnées de votre entreprise.
Validation de la marque Associez un site Web ou une application Android que vous possédez pour bénéficier d'avantages supplémentaires, tels que des noms d'appel réservés et des liens vers des sites Web dans vos actions.
Version Configure différentes versions de test et de production pour votre action à des fins de test et de production.
Liens de l'Assistant Permettez aux utilisateurs d'appeler vos actions à partir de vos propriétés Web.

Pour définir les informations du projet:

  1. Accédez à la console Actions, puis ouvrez votre projet.
  2. Cliquez sur l'onglet Déployer pour spécifier les informations du projet.

    Figure 2. Spécifiez les informations relatives au projet dans la section "Déployer" de la console.

Projets de test dans le simulateur

La console Actions propose un simulateur dans lequel vous pouvez prévisualiser vos actions. Il vous permet de consulter les informations de débogage, de définir les fonctionnalités de l'appareil, de simuler des paramètres régionaux, etc.

Figure 3. Principales zones du simulateur: (1) entrées utilisateur, (2) vue de l'appareil, (3) options et paramètres, et (4) journal des conversations.

Pour tester un projet:

  1. Accédez à la console Actions et ouvrez votre projet.
  2. Cliquez sur l'onglet Test pour accéder au simulateur.