Aufrufmodelle erstellen

Ein Aufrufmodell gibt an, wie Nutzer die Aktionen in Ihrem Projekt aufrufen. Wenn Nutzer eine Aktion aufrufen, beginnen sie damit, was durch Ihr Unterhaltungsmodell definiert wird. Sie können Aufrufe auf folgende Arten definieren:

  • Hauptaufruf: Dies ist der einzige erforderliche Aufruf für das Actions-Projekt. Nutzer sagen einen Satz ähnlich wie "Ok Google, sprich mit <Anzeigename>", um diesen Intent zuzuordnen. Dieser Vorgang erfolgt in der Regel, indem Sie den Nutzer mit einer Willkommensnachricht begrüßen.

  • Deeplinks: Dies sind optionale Aufrufe, mit denen Sie Trainingsformulierungen in einem benutzerdefinierten Intent definieren können, damit Nutzer über Deeplinks zu einem bestimmten Teil Ihrer Unterhaltung gelangen können. Nutzer können eine Formulierung wie "Ok Google, sprich mit <Anzeigename> zu <Deep-Link-Wortgruppe>" sagen, um diese Arten von Intents abzugleichen (z. B. "Ok Google, sprich mit Fakten über Google, um Informationen zum Unternehmen zu erhalten").

  • Integrierte Intents: Dies sind optionale Aufrufe, mit denen Sie systemdefinierte Aufrufmodelle nutzen können. Wenn Sie die Unterstützung für einen integrierten Intent deklarieren, können Nutzer Ihr Actions-Projekt finden und aufrufen, ohne Ihren Anzeigenamen angeben zu müssen. Nutzer können zum Beispiel "Ok Google, spiel ein Spiel" sagen und Google Assistant zeigt dann Ihre Aktion als Aufrufoption an.

Abbildung 1. Ein Aufrufmodell besteht aus allen Intents, die Unterhaltungen mit Ihren Aktionen starten können.

Hauptaufruf erstellen

Jedes Actions-Projekt hat einen standardmäßigen Hauptaufruf, der als Standardeinstiegspunkt für das Actions-Projekt dient. Das Sprachmodell für diesen Aufruf ist mit dem Anzeigenamen Ihres Projekts verknüpft. Nutzer müssen also nur einen Satz wie "Ok Google, sprich mit <Anzeigename>" sagen, um diesen Aufruf zu verwenden. Wenn Nutzer deine Aktionen auf diese Weise aufrufen, ordnet die Assistant-Laufzeit den System-Intent actions.intent.MAIN zu.

So erstellen Sie den Hauptaufruf:

Zum Erstellen von Deeplink-Aufrufen erstellen Sie globale Nutzer-Intents mit Trainingsformulierungen, die die Nutzereingabe definieren, die Sie für den Deeplink festlegen möchten. Nutzer sagen Ihren Anzeigenamen in Kombination mit der Deeplink-Wortgruppe, um einen Deeplink-Aufruf auszuführen (z. B. "Ok Google, sprich mit <Anzeigename> zu <Tiefenlink-Wortgruppe>").

Implizite Aufrufe erstellen

Mit impliziten Aufrufen können Nutzer deine Aktion aufrufen, ohne den Anzeigenamen deines Projekts zu verwenden. Um übereinstimmende Aktionen zu finden, verwendet Google Signale, z. B. wenn Nutzer Assistant auffordern, etwas zu tun, das einer Aufrufwortgruppe für einen Ihrer konfigurierten Intents ähnelt, oder wenn sich der Nutzer in einem Kontext befindet, in dem Ihre Aktionen geeignet sind.

Aufrufereignisse verarbeiten

Wenn Assistant einem Ihrer globalen Intents zugeordnet wird, löst er ein Ereignis aus, das Sie mit einem Handler verarbeiten können. In den folgenden Abschnitten wird beschrieben, welche Aufgaben Ihr Handler ausführen kann. Sie können eine dieser drei Optionen oder eine beliebige Kombination davon auswählen.

Webhook auslösen

Ihr Intent-Handler kann durch Auslösen eines Webhook-Ereignisses an einen Webdienst delegieren. So lösen Sie einen Webhook aus und lassen den Aufruf von einem Webdienst verarbeiten:

Aufforderungen

Der Intent-Handler kann mit einer statischen Aufforderung antworten. In der Regel begrüßen Aufforderungen zu Aufruf-Intents den Nutzer, zeigen ihm, wie die Aktion verwendet werden soll, oder antworten mit den Informationen, die der Nutzer sofort benötigt (One-Shot-Aktionen).

So verarbeiten Sie einen Aufruf-Intent-Abgleich mit einer Eingabeaufforderung:

Übergang zu einer Szene

Der Intent-Handler kann zu einer Szene wechseln, um den übereinstimmenden Aufruf-Intent zu verarbeiten. Dies gibt Ihnen die größte Flexibilität beim Ausführen der Logik. So wechseln Sie zu einer Szene: