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, ce qui est défini par votre modèle de conversation. Vous pouvez définir des appels comme suit:
Main invocation (Appel principal) : cette est le seul appel obligatoire pour votre projet Actions. Les utilisateurs disent une expression comme "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 : Il s'agit d'appels facultatifs qui vous permettent de définir des phrases d'entraînement dans un l'intention personnalisée, afin que les utilisateurs puissent créer des liens profonds vers une partie spécifique de votre conversationnelle. Les utilisateurs peuvent énoncer une expression similaire à "Ok Google, parler à <nom à afficher> à <deep link phrase>" pour faire correspondre les types de (par exemple, "Ok Google, parle à Facts about Google" pour obtenir faits).
Intents intégrés : Il s'agit d'appels facultatifs qui vous permettent d'exploiter modèles d'appel. 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, l'utilisateur peut dire "Ok Google, joue à un jeu" et L'Assistant Google peut présenter votre action comme une option d'appel.
Créer l'appel principal
Chaque projet Actions possède un appel principal par défaut faisant office d'appel principal par défaut
point d'entrée de votre projet Actions.Le modèle de langage de cet appel
est associé au nom à afficher de votre projet. Il suffit donc aux utilisateurs de saisir
une phrase semblable à "Ok Google, parle à <nom à afficher>" pour utiliser
appel. Lorsque des utilisateurs appellent vos actions de cette manière, l'Assistant
l'environnement d'exécution correspond à l'intent système actions.intent.MAIN.
Pour créer l'appel principal:
Créer des appels de liens profonds
Pour créer des appels de liens profonds, vous devez créer des intents utilisateur globaux avec l'entraînement Expressions qui définissent l'entrée utilisateur que vous souhaitez définir pour le lien profond. Les utilisateurs prononcent votre nom à afficher en combinaison avec l'expression du lien profond un appel de lien profond (par exemple, "Ok Google, parle à <display nom> par <deep link phrase>")
Créer des appels implicites
L'appel implicite permet aux utilisateurs d'appeler votre action sans utiliser la méthode nom à afficher. Pour trouver des actions correspondantes, Google utilise des signaux comme les utilisateurs demander à l'Assistant d'effectuer une action semblable à une phrase d'appel des intents configurés, ou lorsque l'utilisateur se trouve dans un contexte où vos actions est approprié.
Gérer les événements d'appel
Lorsque l'Assistant correspond à l'un de vos intents globaux, il déclenche un événement que vous que vous pouvez traiter avec un gestionnaire. Les sections suivantes décrivent ce que votre gestionnaire pouvez réaliser (vous pouvez choisir une seule des trois ou une combinaison des trois).
Déclencher un webhook
Votre gestionnaire d'intent peut déléguer une tâche à 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:
Requêtes
Votre gestionnaire d'intent peut répondre par une invite statique. En général, les invites pour Les intents d'appel accueillent l'utilisateur, l'orientent sur la façon d'utiliser l'action, ou répondre avec les informations dont l'utilisateur a besoin immédiatement (actions ponctuelles).
Pour gérer une correspondance d'intent d'appel avec une requête, procédez comme suit:
Effectuer une transition vers une scène
Votre gestionnaire d'intent peut passer à une scène pour traiter l'appel correspondant. l'intention. Cela vous offre la plus grande flexibilité pour exécuter la logique. Pour effectuer la transition vers une scène: