Les intents sont des objets de messagerie qui décrivent comment faire. Vous pouvez utiliser les intents de deux manières:
- En fournissant le traitement pour un intent, ou
- En demandant le traitement d'un intent par l'Assistant Google.
Le processus par lequel vous fournissez le traitement pour un intent est différent pour les développeurs qui compilent avec Dialogflow et pour les développeurs qui utilisent le SDK Actions. Toutefois, dans les deux cas, vous fournissez le nom de l'intent et l'URL de votre webhook de fulfillment. Cela indique à Actions on Google que vous pouvez accepter les requêtes utilisateur qui correspondent à l'intent.
Pour demander le traitement d'un intent, vous devez le spécifier dans l'objet possibleIntents lorsque vous répondez à l'Assistant. Dans la requête suivante, l'Assistant vous renvoie le résultat de l'intent traité. Pour en savoir plus, consultez la présentation de l'utilisation des outils d'aide.
Intents courants
Le tableau suivant décrit les intents que l'Assistant vous demande de traiter.
| Nom de l'intent | Utilisation | Événement Dialogflow |
|---|---|---|
actions.intent.MAIN |
Obligatoire: chaque package d'actions déclare un seul intent comme point d'entrée pour que les utilisateurs puissent lancer des conversations. | WELCOME ou GOOGLE_ASSISTANT_WELCOME |
actions.intent.TEXT |
Permet d'obtenir la représentation sous forme de texte brut d'une requête d'un utilisateur. Vous l'utilisez la plupart du temps lors d'une conversation avec des utilisateurs. | |
actions.intent.CANCEL |
Vous recevez cet intent lorsque vous activez la réception d'intents d'annulation dans votre package d'actions. Lorsque les utilisateurs énoncent une commande d'annulation globale telle que "quit", vous recevez cet intent dans la prochaine requête de votre traitement. Vous pouvez donc répondre par un message final et effectuer tout nettoyage dans votre logique de traitement. | actions_intent_CANCEL |
actions.intent.NO_INPUT |
Vous recevez cet intent lorsque vous activez la réception d'intents sans entrée dans votre package d'actions. Lorsque les utilisateurs ne répondent pas à une invite, vous recevez cet intent dans la prochaine requête de votre traitement. | actions_intent_NO_INPUT |
Assistants
Le tableau suivant décrit les aides compatibles que vous pouvez demander à l'Assistant de traiter.
| Nom de l'intent | Utilisation | Événement Dialogflow |
|---|---|---|
actions.intent.PERMISSION |
Obtenez son nom complet, sa position approximative, sa position exacte, ou les trois. | actions_intent_PERMISSION |
actions.intent.OPTION |
Recevoir l'élément sélectionné dans une interface utilisateur de liste ou de carrousel Si l'utilisateur ne sélectionne pas l'élément dans l'interface utilisateur de liste ou du carrousel, il peut recevoir une saisie vocale ou textuelle correspondant à la touche associée à la liste ou à l'interface du carrousel. | actions_intent_OPTION |
actions.intent.DATETIME |
Obtenez une date et une heure saisies par l'utilisateur. | actions_intent_DATETIME |
actions.intent.SIGN_IN |
Demande un flux d'association de comptes pour associer le compte d'un utilisateur. | actions_intent_SIGN_IN |
actions.intent.PLACE |
Obtenez une adresse ou une position enregistrée auprès de l'utilisateur. | actions_intent_PLACE |
actions.intent.CONFIRMATION |
Obtenez une confirmation de la part de l'utilisateur (par exemple, une réponse à une question oui ou non). | actions_intent_CONFIRMATION |
actions.intent.NEW_SURFACE |
Demande à l'utilisateur l'autorisation de transmettre le contenu à une autre surface Assistant. | actions_intent_NEW_SURFACE |
Intents intégrés
Les intents intégrés modélisent certaines des manières courantes par lesquelles les utilisateurs expriment les tâches qu'ils essaient d'effectuer ou les informations qu'ils recherchent, comme commander un repas, réserver un trajet ou vérifier le solde d'un compte. Pour en savoir plus, consultez la documentation de référence sur les intents intégrés.
Intents supplémentaires
La plupart des actions de conversation sont conçues avec une combinaison des intents, des assistants et des réponses courants. Toutefois, les actions qui intègrent des fonctionnalités supplémentaires telles que des transactions ou des mises à jour quotidiennes ont accès à des intents spécifiques à ces fonctionnalités.
Outils d'aide aux transactions
Le tableau suivant décrit les assistants liés à la gestion des achats que vous pouvez demander à l'Assistant de traiter. Pour en savoir plus sur la mise en œuvre de ces intents et d'autres intents associés, consultez la documentation sur la fonctionnalité de transactions.
| Nom de l'intent | Utilisation | Événement Dialogflow |
|---|---|---|
actions.intent.DELIVERY_ADDRESS |
Obtenez l'adresse de livraison saisie par l'utilisateur. | actions_intent_DELIVERY_ADDRESS |
actions.intent.TRANSACTION_REQUIREMENTS_CHECK |
Vérifiez que toutes les conditions d'une transaction sont remplies. | actions_intent_TRANSACTION_REQUIREMENTS_CHECK |
actions.intent.TRANSACTION_DECISION |
Demande à l'utilisateur si la transaction doit avoir lieu. | actions_intent_TRANSACTION_DECISION |
actions.intent.DIGITAL_PURCHASE_CHECK |
Valide la configuration de la transaction de l'utilisateur. Permet d'éviter de proposer aux utilisateurs des produits numériques qui entraîneront un échec de la transaction. | actions_intent_DIGITAL_PURCHASE_CHECK |
actions.intent.COMPLETE_PURCHASE |
Démarre une demande d'achat. Cela se traduit par un résultat d'achat décrivant si la transaction a réussi ou échoué, et comment. | actions_intent_COMPLETE_PURCHASE |
Intents d'engagement utilisateur
Le tableau suivant décrit les intents associés aux fonctionnalités d'engagement utilisateur. Pour en savoir plus sur la mise en œuvre de ces intents et d'autres intents associés, consultez la documentation sur les fonctionnalités d'engagement utilisateur.
| Nom de l'intent | Fournir le traitement | Traitement de la requête | Utilisation | Événement Dialogflow |
|---|---|---|---|---|
actions.intent.REGISTER_UPDATE |
X | Demande à l'utilisateur de s'inscrire aux mises à jour. | actions_intent_REGISTER_UPDATE |
|
actions.intent.CONFIGURE_UPDATES |
X | Vous recevez cet intent lorsque l'utilisateur tente de s'inscrire aux mises à jour (en d'autres termes, un intent REGISTER_UPDATE doit être envoyé). | actions_intent_CONFIGURE_UPDATES |
Intents personnalisés
Vous pouvez créer vos propres intents pour définir des raccourcis dans la conversation afin d'aider les utilisateurs à effectuer les tâches plus efficacement. Ces intents se trouvent dans votre propre espace de noms. Vous définissez la manière dont les utilisateurs les déclenchent, et votre package d'actions est le seul à pouvoir les prendre en charge.
Pour en savoir plus, découvrez comment définir des actions dans Dialogflow ou avec le SDK Actions. Pour en savoir plus sur les packages d'actions, consultez la documentation de référence sur les packages d'actions.
Intents pour la maison connectée
Si vous créez une action pour la maison connectée, vous définissez la prise en charge des intents d'une manière légèrement différente. Pour en savoir plus, consultez la documentation sur les intents de maison connectée.