Présentation des intents (Dialogflow)

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.