Ein Aufrufmodell gibt an, wie Nutzer die Aktionen in Ihrem Projekt aufrufen. Wenn Nutzer eine Aktion aufrufen, beginnen sie eine Unterhaltung mit der Aktion. die durch Ihr Unterhaltungsmodell definiert sind. Sie können Aufrufe definieren, auf folgende Arten:
Hauptaufruf: Dies ist der einzige erforderliche Aufruf für Ihr Actions-Projekt. Nutzer sagen einen Satz ähnlich wie "Ok Google, sprich mit <Anzeigename>", um diesen Intent zuzuordnen. Dies geschieht normalerweise durch die Begrüßung des Nutzers mit einer Willkommensnachricht.
Deeplink-Aufrufe: Dies sind optionale Aufrufe, mit denen Sie Trainingsformulierungen in einem Nutzer mit gemeinsamer Absicht über einen Deeplink zu einem bestimmten Bereich Ihrer Website Gespräch. Nutzer können einen Satz wie etwa "Ok Google, sprich mit <Anzeigename> <Tiefenlink-Wortgruppe>" hinzu, um diese Art von Inhalt Intents (z. B. "Ok Google, sprich mit Fakten über Google, um Unternehmen Fakten“)
Integrierte Intents: Dies sind optionale Aufrufe, mit denen Sie systemdefinierte Aufrufmodellen. Wenn Sie die Unterstützung für einen integrierten Intent deklarieren, können Nutzer Actions-Projekt ermitteln und aufrufen, ohne Ihr Anzeigename. Nutzer können beispielsweise "Ok Google, ein Spiel spielen" sagen und Google Assistant kann deine Aktion als Aufrufoption anzeigen.
Hauptaufruf erstellen
Jedes Actions-Projekt hat einen standardmäßigen Hauptaufruf, der als Standard dient
in Ihr Actions-Projekt ein.Das Sprachmodell für diesen Aufruf
mit dem Anzeigenamen Ihres Projekts verknüpft ist, sodass Nutzer
ähnlich wie "Ok Google, sprich mit <Anzeigename>", um diese Funktion zu verwenden
. Wenn Nutzer deine Aktionen auf diese Weise aufrufen, zeigt Assistant
Laufzeit mit dem System-Intent actions.intent.MAIN
übereinstimmt.
So erstellen Sie den Hauptaufruf:
Deeplink-Aufrufe erstellen
Zum Erstellen von Deeplink-Aufrufen erstellen Sie globale Nutzer-Intents mit Training Wortgruppen für die Nutzereingabe, die Sie für den Deeplink festlegen möchten. Nutzer nennen Ihren Anzeigenamen in Kombination mit der Deeplink-Wortgruppe, die angezeigt werden soll einen Deeplink-Aufruf ausführen (z. B. "Ok Google, sprich mit <Display Name> zu <Tiefenlink-Wortgruppe>")
Implizite Aufrufe erstellen
Mit dem impliziten Aufruf können Nutzer Ihre Aktion aufrufen, ohne das Ereignis Anzeigename. Google verwendet Signale wie Nutzer*innen, um passende Aktionen zu finden Sie Assistant bitten, etwas zu tun, das der Aufrufphrase für eine Person ähnelt oder wenn sich der Nutzer in einem Kontext befindet, in dem deine Aktionen wäre angemessen.
Aufrufereignisse verarbeiten
Wenn Assistant mit einem deiner globalen Intents übereinstimmt, löst er ein Ereignis aus, das du mit einem Handler verarbeiten kann. In den folgenden Abschnitten wird beschrieben, was Ihr Handler die Sie ausführen können (Sie können eine davon oder eine beliebige Kombination davon auswählen).
Webhook auslösen
Der Intent-Handler kann eine Delegation an einen Webdienst vornehmen, indem er ein Webhook-Ereignis auslöst. So lösen Sie einen Webhook aus und lassen den Aufruf von einem Webdienst verarbeiten:
Prompts
Der Intent-Handler kann mit einer statischen Aufforderung antworten. Üblicherweise werden Aufforderungen Aufruf-Intents heißen Nutzende willkommen und zeigen ihnen, wie die Aktion verwendet werden soll. sofort mit den Informationen antworten, die der Nutzer benötigt (One-Shot-Aktionen).
So verarbeiten Sie die Übereinstimmung eines Aufruf-Intents mit einer Eingabeaufforderung:
Übergang zu einer Szene
Der Intent-Handler kann zu einer Szene wechseln, um den übereinstimmenden Aufruf zu verarbeiten Nutzerabsicht verstehen. Dadurch sind Sie bei der Ausführung der Logik am flexibelsten. So wechseln Sie zu einer Szene: