Expliziter Aufruf (Dialogflow)

Ein expliziter Aufruf erfolgt, wenn ein Nutzer Google Assistant bittet, deine Aktion mit dem Namen zu verwenden. Optional kann der Nutzer am Ende seines Aufrufs eine Aufrufphrase einfügen, mit der er direkt zur angeforderten Funktion gelangt.

Hinweis :Nutzer können deine Aktion über das Assistant-Verzeichnis finden, das wie ein Webshop für Actions on the Google Assistant ist. Das Verzeichnis ist eine wichtige Quelle für die Auffindbarkeit deiner Aktion. Vergiss also nicht, etwas Entwicklungszeit in die Erstellung eines guten Eintrags zu investieren.

Explizite Aufrufkomponenten

Das folgende Beispiel zeigt die verschiedenen möglichen Komponenten eines expliziten Aufrufbefehls:

Trigger-Phrase

Diese Wortgruppen starten einen expliziten Aufruf und werden von Actions on Google definiert:

• "Ok Google, sprich mit..."
• "Ok Google, sprich mit..."
• "Ok Google, ich möchte mit..."
• "Ok Google, frag..."

Informationen zu Triggerwortgruppen für jede Sprache finden Sie unter Sprachen und Sprachen.

Hinweis :Auf Android-Geräten rufen Triggerausdrücke die Aktion auf, es sei denn, sie überschneidet sich mit einem integrierten Intent von App Actions. In diesen Fällen startet Assistant anstelle der Aktion deine App, falls sie installiert ist.

Wenn ein Nutzer beispielsweise sagt: „Hey Google, zeichne, dass ich einen Burrito auf dem BeispielTracker gegessen habe“, startet Assistant die App ExampleTracker vor allen ExampleTracker-Aktionen mit einem ähnlichen Intent, wenn der integrierte Intent actions.intent.RECORD_FOOD_OBSERVATION implementiert wurde.

Aufrufname

Das ist der Name deiner Aktion, z. B. „Persönlicher Chef“. Nutzer können dies mit Triggern kombinieren, um Aktionen explizit über ihren Namen aufzurufen, z. B.: "Ok Google, let me talk to Personal Chef".

Hinweis :Es ist wichtig, die Aufrufe zu berücksichtigen, wenn Sie den Namen Ihrer Aktion festlegen. Wenn du einen cleveren Aktionsnamen hast, Assistant ihn aber nicht erkennt, haben Nutzer möglicherweise Schwierigkeiten, deine Aktion aufzurufen. Weitere Informationen finden Sie in unseren Benennungsrichtlinien und der Aufrufcheckliste.

Aufrufwortgruppe (optional)

Aufrufsätze sind ein wertvoller Mechanismus, um die Auffindbarkeit deiner Aktion zu erhöhen. Außerdem bieten sie Nutzern die Möglichkeit, Deeplinks zu deiner Unterhaltung zu erstellen, indem sie eine bestimmte Aufgabe vorgeben, die sie ausführen müssen. Diese Formulierungen veranschaulichen verschiedene Möglichkeiten, wie Nutzer die Funktionen deiner Aktion anfordern können, damit Google Assistant die Funktionen deiner Aktion besser verstehen und mit Nutzeranfragen abgleichen kann.

• „Suche Rezepte für mich“
• "empfiehl einen Wein"
• "Fahrten buchen"
• „ein Spiel spielen“
• „meditieren“

Nutzer kombinieren Ihren Aufrufnamen mit Aufrufsätzen, um explizit bestimmte Intents aufzurufen, z. B.: "Ok Google, sprich mit Personal Chef, um mir Rezepte zu finden."

Hinweis: Achten Sie darauf, dass sich Ihre Aufrufsätze auf Ihre Aktion beziehen und reale Anwendungsfälle beschreiben. Ein häufiger Fehler besteht darin, Aufrufformulierungen zu definieren, die zu allgemein sind, um spezifisch für den Zweck deiner Aktion zu sein. Dadurch werden deine Sätze weniger nützlich und die Auffindbarkeit deiner Aktion beeinträchtigt. Weitere Informationen finden Sie unter implizite Aufrufe und in der Aufrufcheckliste.

Expliziter Aufruf-Intent

Wenn deine Aktion explizit ohne Aufrufwortgruppe und Name aufgerufen wird („Ok Google, talk to Personal Chef“), wird der Intent actions.intent.MAIN in deiner Aktion ausgelöst. Ihr Actions-Projekt darf nur einen Haupt-Intent für einen expliziten Aufruf nach Name enthalten.

Wenn deine Aktion explizit mit einer Aufrufphrase und dem Namen aufgerufen wird ("Ok Google, sprich mit dem persönlichen Chef für das heutige Suppenrezept"), wird der Intent aufgerufen, der dieser Aufrufwortgruppe entspricht.

Weitere Informationen finden Sie in der Dokumentation zu Intents.