Un projet Actions regroupe toutes vos actions dans un seul conteneur. Toi
publiez ce projet sur Actions on Google pour que l'Assistant Google sache comment découvrir
et d'appeler vos expériences de conversation.
Figure 1. Structure du projet Actions
Vous allez utiliser les composants de bas niveau suivants pour créer votre projet Actions:
Les paramètres et ressources définissent les métadonnées du projet.
et des ressources comme
les icônes de projet. Google utilise ces informations pour publier
vos actions dans le répertoire de l'Assistant, pour que les utilisateurs puissent les découvrir et les appeler
de l'IA générative.
Les intents représentent une tâche à exécuter, comme une
une entrée utilisateur ou un événement
système à traiter. Le type le plus courant
que vous utiliserez sont des intents utilisateur. Ces intents vous permettent de déclarer l'entraînement
Expressions étendues naturellement par la NLU (Natural Language Understanding, compréhension du langage naturel)
pour inclure beaucoup d'autres expressions similaires. La NLU utilise l'agrégation
ces phrases pour entraîner un modèle de langage que l'Assistant utilisera pour trouver des correspondances
saisie. Pendant une conversation, si certaines entrées utilisateur correspondent à la langue de l'intent
l'environnement d'exécution de l'Assistant envoie l'intent à votre action, afin qu'il puisse
les traiter et répondre à l'utilisateur.
Les types vous permettent d'extraire des données structurées d'une entrée utilisateur. Par
annotant les phrases d'entraînement avec des types, la NLU peut extraire des données pertinentes, structurées
des données pour vous, afin que vous n'ayez pas à
analyser les entrées ouvertes.
Scenes (Scènes) traite les intents et constitue les principaux exécuteurs logiques pour
vos actions. Il peut remplir des cases, évaluer la logique conditionnelle, renvoyer
des invites, et même faire appel à des services Web externes pour effectuer
la logique métier. Combinées aux intents, les scènes offrent un moyen efficace
détecter des entrées utilisateur ou des événements système spécifiques, et exécuter
logique.
Les requêtes 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
(traitement), comme la validation de données ou la génération de requêtes. Vos actions
communiquer avec votre fulfillment via un protocole de webhook basé sur JSON.
Interactive Canvas vous permet de créer
et des expériences immersives avec des applications Web utilisant HTML, CSS et JavaScript.
Créer un projet
Vous devez créer un projet dans la console Actions avant de pouvoir développer pour
Assistant Google. Pour créer un projet :
Attribuez un nom à votre projet, puis cliquez sur Créer un projet.
Sur l'écran What type 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 Suivant.
Sur l'écran How do you want to build it (Comment souhaitez-vous la compiler), sélectionnez une méthode de compilation
et cliquez sur Commencer à créer. Par exemple, vous pouvez commencer par
projet ou avec un échantillon.
<ph type="x-smartling-placeholder">
Définir les informations du projet
Les paramètres et les ressources de votre projet définissent des informations sur votre projet, telles que
la compatibilité avec les fonctionnalités et les surfaces, les paramètres régionaux pris en charge, le nom à afficher, la description,
des logos, et plus encore. Le tableau suivant décrit les principaux paramètres et ressources
que vous fournissez. Actions on Google utilise cette
pour déployer et publier votre projet sur l'Assistant
annuaire.
Nom
Description
Informations de l'annuaire
Fournit des informations permettant à Actions on Google de publier vos
dans le répertoire de l'Assistant. Inclut des métadonnées et des descriptions
sur votre projet et les ressources images 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 la 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 que vous possédez pour bénéficier d'avantages supplémentaires
tels que les noms d'appel réservés et les liens vers des sites Web dans vos actions.
Version
Configure différentes versions de test et de production pour votre action
pour les tests et la production.
Liens de l'Assistant
Autorisez les utilisateurs à appeler vos actions depuis vos propriétés Web.
Pour définir les informations sur le projet:
Tester des projets dans le simulateur
La console Actions fournit un simulateur dans lequel vous pouvez prévisualiser vos actions. La
vous permet d'afficher les informations de débogage, de définir les fonctionnalités de l'appareil, de simuler
paramètres régionaux, etc.
Figure 3. Les principales zones du simulateur: (1) entrée utilisateur,
(2) la vue de l'appareil, (3) les options et paramètres et (4) le journal des conversations.
Pour tester un projet:
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eAn Actions project enables the creation of conversational experiences for Google Assistant by packaging all actions into a single container for publishing.\u003c/p\u003e\n"],["\u003cp\u003eBuilding an Actions project involves utilizing components such as intents, types, scenes, prompts, webhooks and more for defining user interactions and logic.\u003c/p\u003e\n"],["\u003cp\u003eDefining project information in the Actions console, including directory information, locales and surfaces, is crucial for publishing and deploying to the Assistant directory.\u003c/p\u003e\n"],["\u003cp\u003eThe Actions console simulator provides a comprehensive environment for testing projects with features such as debugging, device settings, and locale simulation.\u003c/p\u003e\n"]]],[],null,["# Build projects\n\nActions Builder Actions SDK \n\nAn Actions project packages all of your Actions into a single container. You\npublish this project to Actions on Google so Google Assistant knows how to discover\nand invoke your conversational experiences.\n**Figure 1**. Actions project structure\n\nYou use the following low-level components to build your Actions project:\n\n- [**Settings and resources**](#define_project_information) define project metadata\n and resources like project icons. Google uses this information to publish\n your Actions to the Assistant directory, so that users can discover and invoke\n them.\n\n- [**Intents**](../intents) represent a task to be carried out, such as some\n user input or a system event that needs processing. The most common type of\n intent you'll use are user intents. These intents let you declare training\n phrases that are naturally expanded by the NLU (natural language understanding)\n engine to include many more, similar phrases. The NLU uses the aggregation of\n these phrases to train a language model that the Assistant uses to match user\n input. During a conversation, if some user input matches the intent's language\n model, the Assistant runtime sends the intent to your Action, so that it can\n process it and respond to the user.\n\n- [**Types**](../types) let you extract structured data from user input. By\n annotating training phrases with types, the NLU can extract relevant, structured\n data for you, so you don't have to parse open-ended input.\n\n- [**Scenes**](../scenes) process intents and are the main logic executors for\n your Actions. They can do slot-filling, evaluate conditional logic, return\n prompts to the user, and even call on external web services to carry out\n business logic. In combination with intents, scenes give you a powerful way to\n detect specific user input or system events and to carry out corresponding\n logic.\n\n- [**Prompts**](../prompts) define static or dynamic responses that you use to\n respond back to users.\n\n- [**Webhooks**](../webhooks) let you delegate extra work to web services\n (fulfillment), such as validating data or generating prompts. Your Actions\n communicate with your fulfillment through a JSON-based, webhook protocol.\n\n- [**Interactive Canvas**](/assistant/interactivecanvas) lets you create rich\n and immersive experiences with web apps that utilize HTML, CSS, and JavaScript.\n\nCreate a project\n----------------\n\nYou must create a project in the Actions console before you can develop for\nGoogle Assistant. To create a project:\n\n1. Go to the [Actions console](//console.actions.google.com/).\n2. Click **New project**.\n3. Enter a name for your project and click **Create Project** .\n4. In the **What kind of Action do you want to build?** screen, select a category that best represents your project and click **Next**.\n5. In the **How do you want to build it** screen, select a way to build and click **Start building**. For example, you can start with an empty project or with a sample.\n\n| **Key Point:** If you are building for Interactive Canvas, follow these additional steps:\n|\n| 1. If you did not select the **Game** card on the **What type of Action\n| do you want to build?** screen, click **Deploy** in the top navigation. Under **Additional Information** , select the **Games \\& fun** category. Click **Save**.\n| 2. Click **Develop** in the top navigation of the Actions console.\n| 3. Click **Interactive Canvas** in the left navigation.\n| 4. Under **Does your Action use Interactive Canvas?** , select **Yes**.\n| 5. **Optional** : Enter your web app URL into the **Set your default web app URL** field. This action adds a default `Canvas` response with the URL field to your Main invocation.\n| 6. Click **Save**.\n\n\u003cbr /\u003e\n\nDefine project information\n--------------------------\n\n| **Note:** See the [Directory information](/assistant/console/directory-information) documentation for more details on how to manage project information.\n\nYour project's settings and resources define information about your project like\nfeature and surface support, supported locales, display name, description,\nlogos, and more. The following table describes the main settings and resources\nyou provide. Actions on Google uses this\ninformation to deploy and publish your project to the [Assistant\ndirectory](//assistant.google.com/explore).\n\n| Name | Description |\n|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Directory information | Provides information so that Actions on Google can publish your project to the Assistant directory. Includes metadata and desecriptions about your project and image resources for logos and banner images. |\n| Location targeting | Configures the locales that your Actions are available in. |\n| Surface capabilities | Configures the surfaces that your Actions are available on. |\n| Company details | Specifies contact information for your company. |\n| Brand verification | Connect a website or Android app that you own to gain extra benefits such as reserved invocation names and website linking within your Actions. |\n| Release | Configures different testing and production releases for your Action for testing and production. |\n| Assistant links | Let users invoke your Actions from your web properties. |\n\nTo define project information:\n\nTest projects in the simulator\n------------------------------\n\n| **Note:** See the [Actions simulator](/assistant/console/simulator) documentation for complete information about testing your projects.\n\nThe Actions console provides a simulator to preview your Actions in. The\nsimulator lets you see debug information, set device capabilities, simulate\nlocale, and more.\n**Figure 3.** The main areas of the simulator: (1) user input, (2) device view, (3) options and settings, and (4) conversation log.\n\nTo test a project:"]]
