Un projet Actions regroupe toutes vos actions dans un seul conteneur. Vous publiez ce projet sur Actions on Google afin que l'Assistant Google sache comment découvrir et appeler vos expériences de conversation.
Utilisez les composants de bas niveau suivants pour créer 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 l'annuaire de l'Assistant afin que les utilisateurs puissent les découvrir et les appeler.
Les intents représentent une tâche à effectuer, comme une entrée utilisateur ou un événement système à traiter. Les intents utilisateur sont les types d'intent les plus courants. Ces intents vous permettent de déclarer des expressions d'entraînement qui sont naturellement développées par le moteur de compréhension du langage naturel (NLU, Natural Language Understanding) pour inclure beaucoup plus d'expressions similaires. La NLU s'appuie sur l'agrégation de ces expressions pour entraîner un modèle de langage utilisé par l'Assistant pour correspondre aux entrées utilisateur. Lors 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 le traiter et répondre à l'utilisateur.
Les types vous permettent d'extraire des données structurées des entrées utilisateur. En annotant des expressions d'entraînement avec des types, la NLU peut extraire des données structurées et pertinentes pour vous. Vous n'avez donc pas besoin d'analyser des entrées ouvertes.
Les scènes traitent les intents et sont les principaux exécuteurs logiques pour vos actions. Ils peuvent effectuer le remplissage d'emplacements, évaluer la logique conditionnelle, renvoyer des invites à l'utilisateur et même appeler des services Web externes pour effectuer la logique métier. Combinées aux intents, les scènes vous permettent de détecter efficacement une entrée utilisateur ou des événements système spécifiques, ainsi que d'exécuter la logique correspondante.
Les invites définissent les 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 à des services Web (traitement), tels que la validation des données ou la génération d'invites. Vos actions communiquent avec votre traitement via un protocole webhook basé sur JSON.
Le Canevas interactif vous permet de créer des expériences riches et immersives avec des applications Web utilisant du code 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 :
- Accédez à la console Actions.
- Cliquez sur Nouveau projet.
- Saisissez un nom pour votre projet, puis cliquez sur Créer un projet.
- Sur l'écran Quel type d'action souhaitez-vous créer ?, sélectionnez la catégorie qui représente le mieux votre projet, puis cliquez sur Suivant.
- Dans l'écran How to you want to build it (Comment souhaitez-vous créer le build), sélectionnez un mode de compilation, puis cliquez sur Start build (Commencer la compilation). Par exemple, vous pouvez commencer avec un projet vide ou un exemple.
Définir les informations sur le projet
Les paramètres et les ressources de votre projet définissent des informations le concernant, telles que la compatibilité des fonctionnalités et de la surface, les paramètres régionaux pris en charge, 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. Comprend des métadonnées et des descriptions concernant votre projet et 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. |
| Capacités de surface | Configure les surfaces sur lesquelles vos actions sont disponibles. |
| Informations détaillées sur l'entreprise | Spécifie les coordonnées de votre entreprise. |
| Validation de la marque | Associez un site Web ou une application Android qui vous appartient pour bénéficier d'avantages supplémentaires, tels que des noms d'appels réservés et des liens vers des sites Web dans vos actions. |
| Version | Configure différentes versions de test et de production de votre action pour les tests et la production. |
| Associations à l'Assistant | Autorisez les utilisateurs à appeler vos actions à partir de vos propriétés Web. |
Pour définir les informations sur le projet:
- Accédez à la console Actions, puis ouvrez votre projet.
Cliquez sur l'onglet Déployer pour spécifier les informations sur le projet.
Figure 2 : Spécifiez les informations sur le projet dans la section "Déployer" de la console.
Tester des projets dans le simulateur
La console Actions fournit un simulateur dans lequel vous pouvez prévisualiser vos actions. Le simulateur vous permet d'afficher des informations de débogage, de définir les capacités de l'appareil, de simuler des paramètres régionaux, etc.
Pour tester un projet:
- Accédez à la console Actions et ouvrez votre projet.
- Cliquez sur l'onglet Test pour accéder au simulateur.