Un modèle d'appel spécifie la manière dont les utilisateurs appellent les actions dans votre projet. Lorsque les utilisateurs appellent une action, ils entament une conversation avec celle-ci, qui est définie par votre modèle de conversation. Vous pouvez définir des appels de différentes manières:
Appel principal : il s'agit du seul appel obligatoire pour votre projet Actions. Les utilisateurs prononcent une phrase semblable à "Ok Google, parle à <nom à afficher>" pour correspondre à cet intent, que vous gérez généralement en saluant l'utilisateur avec un message de bienvenue.
Appels de liens profonds : ces appels facultatifs vous permettent de définir des phrases d'entraînement dans un intent personnalisé, afin que les utilisateurs puissent utiliser un lien profond vers une partie spécifique de votre conversation. Les utilisateurs peuvent dire une expression semblable à "Ok Google, parle à <nom à afficher> pour <expression du lien profond>" pour répondre à ces types d'intents (par exemple, "Ok Google, parle à Facts about Google pour obtenir des informations sur l'entreprise").
Intents intégrés : ces appels facultatifs vous permettent d'exploiter des modèles d'appel définis par le système. En déclarant la prise en charge d'un intent intégré, les utilisateurs peuvent découvrir et appeler votre projet Actions sans avoir à spécifier votre nom à afficher. Par exemple, les utilisateurs peuvent dire "Ok Google, jouer à un jeu" et l'Assistant Google peut présenter votre action comme option d'appel.
Créer l'appel principal
Chaque projet Actions possède un appel principal par défaut qui sert de point d'entrée par défaut dans votre projet Actions. Le modèle de langage de cet appel est associé au nom à afficher de votre projet. Les utilisateurs doivent donc simplement dire une phrase semblable à Ok Google, parler à <nom à afficher> pour utiliser cet appel. Lorsque les utilisateurs appellent vos actions de cette manière, l'environnement d'exécution de l'Assistant met en correspondance l'intent système actions.intent.MAIN.
Pour créer l'appel principal:
Créer des appels de lien profond
Pour créer des appels de liens profonds, vous devez créer des intents utilisateur globaux avec des phrases d'entraînement qui définissent l'entrée utilisateur que vous souhaitez définir pour le lien profond. Les utilisateurs énoncent votre nom à afficher en combinaison avec l'expression du lien profond pour lancer un appel de lien profond (par exemple, "Ok Google, parle à <nom à afficher> de <expression du lien profond>").
Créer des appels implicites
L'appel implicite permet aux utilisateurs d'appeler votre action sans utiliser le nom à afficher de votre projet. Pour trouver les actions correspondantes, Google utilise des signaux tels que les utilisateurs qui demandent à l'Assistant de faire une phrase d'appel pour l'un de vos intents configurés, ou lorsque l'utilisateur se trouve dans un contexte où vos actions seraient appropriées.
Gérer les événements d'appel
Lorsque l'Assistant établit une correspondance avec l'un de vos intents globaux, il déclenche un événement que vous pouvez traiter avec un gestionnaire. Les sections suivantes décrivent ce que votre gestionnaire peut effectuer (vous pouvez choisir une ou plusieurs combinaisons des trois).
Déclencher un webhook
Votre gestionnaire d'intents peut déléguer à un service Web en déclenchant un événement de webhook. Pour déclencher un webhook et faire en sorte qu'un service Web gère l'appel:
Invites
Votre gestionnaire d'intent peut répondre par une invite statique. En règle générale, les invites d'intents d'appel accueillent l'utilisateur, l'orientent vers l'utilisation de l'action ou répondent immédiatement avec les informations dont l'utilisateur a besoin (actions uniques).
Pour gérer une correspondance d'intent d'appel avec une requête:
Ajouter une transition vers une scène
Votre gestionnaire d'intent peut passer à une scène pour traiter l'intent d'appel correspondant. Vous bénéficiez ainsi d'une plus grande flexibilité pour exécuter la logique. Pour passer à une scène: