Intents – Übersicht (Dialogflow)

Intents sind Nachrichtenobjekte, die beschreiben, wie eine Aktion ausgeführt wird. Sie können Intents auf zwei Arten verwenden:

  • Durch Bereitstellung der Auftragsausführung für einen Intent oder
  • Durch Anfordern der Erfüllung eines Intents durch Google Assistant.

Das Verfahren zur Bereitstellung der Auftragsausführung für einen Intent unterscheidet sich für Entwickler, die mit Dialogflow erstellen, und für Entwickler, die mit dem Actions SDK erstellen. In beiden Fällen geben Sie jedoch den Namen des Intents und die URL des Auftragsausführungs-Webhooks an. Damit teilen Sie Actions on Google mit, dass Sie Nutzerabfragen unterstützen können, die dem Intent entsprechen.

Wenn Sie die Auftragsausführung für einen Intent anfordern möchten, geben Sie den Intent im Objekt possibleIntents an, wenn Sie auf Assistant antworten. In der nachfolgenden Anfrage an die Auftragsausführung gibt Assistant das Ergebnis des verarbeiteten Intents zurück. Weitere Informationen finden Sie in der Übersicht zur Verwendung von Hilfsprogrammen.

Häufig verwendete Intents

In der folgenden Tabelle werden Intents beschrieben, die Assistant für Sie anfordert.

Intent-Name Nutzung Dialogflow-Ereignis
actions.intent.MAIN Erforderlich: Jedes Aktionspaket deklariert genau einen Intent, der als Einstiegspunkt für Nutzer zum Starten von Unterhaltungen dient. WELCOME oder GOOGLE_ASSISTANT_WELCOME
actions.intent.TEXT Rohtextdarstellung einer Nutzeranfrage abrufen. Diese Methode nutzen Sie meistens, wenn Sie sich mit Nutzern unterhalten.
actions.intent.CANCEL Sie erhalten diesen Intent, wenn Sie in Ihrem Aktionspaket den Empfang von Abbruch-Intents aktivieren. Wenn Nutzer einen globalen Abbruchbefehl wie „quit“ sagen, erhalten Sie diesen Intent in der nächsten Anfrage an die Auftragsausführung, sodass Sie mit einer abschließenden Nachricht antworten und Ihre Auftragsausführungslogik bereinigen können. actions_intent_CANCEL
actions.intent.NO_INPUT Sie erhalten diesen Intent, wenn Sie in Ihrem Aktionspaket den Empfang von No-Input-Intents aktivieren. Wenn Nutzer nicht auf eine Aufforderung reagieren, erhalten Sie diesen Intent in der nächsten Anfrage an die Auftragsausführung. actions_intent_NO_INPUT

Hilfskräfte

In der folgenden Tabelle werden die unterstützten Hilfsprogramme beschrieben, die von Assistant ausgeführt werden können.

Intent-Name Nutzung Dialogflow-Ereignis
actions.intent.PERMISSION Ermitteln Sie den vollständigen Namen, den ungefähren Standort oder den genauen Standort des Nutzers oder alle drei. actions_intent_PERMISSION
actions.intent.OPTION Sie erhalten das ausgewählte Element über die Benutzeroberfläche einer Liste oder Karussell. Wenn der Nutzer nichts aus der Listen- oder Karussell-UI auswählt, erhält er eine Sprach- oder Texteingabe, die mit dem Schlüssel in der Listen- oder Karussell-UI übereinstimmt. actions_intent_OPTION
actions.intent.DATETIME Fordern Sie eine Datum- und Uhrzeiteingabe vom Nutzer an. actions_intent_DATETIME
actions.intent.SIGN_IN Fordert einen Kontoverknüpfungsvorgang an, um das Konto eines Nutzers zu verknüpfen. actions_intent_SIGN_IN
actions.intent.PLACE Eine Adresse oder einen gespeicherten Standort vom Nutzer abrufen actions_intent_PLACE
actions.intent.CONFIRMATION Holen Sie vom Nutzer eine Bestätigung ein, z. B. eine Antwort auf eine Ja- oder Nein-Frage. actions_intent_CONFIRMATION
actions.intent.NEW_SURFACE Der Nutzer wird gebeten, die Übergabe an eine andere Assistant-Oberfläche zu erlauben. actions_intent_NEW_SURFACE

Integrierte Intents

Integrierte Intents modellieren einige gängige Methoden, mit denen Nutzer Aufgaben ausdrücken, die sie zu erledigen versuchen, oder Informationen, die sie suchen, z. B. Essen bestellen, eine Fahrt buchen oder den Kontostand überprüfen. Weitere Informationen finden Sie in der Referenz zu integrierten Intents.

Zusätzliche Intents

Die meisten Konversationsaktionen werden mit einer Kombination aus gängigen Intents, Hilfsfunktionen und Antworten erstellt. Aktionen, die zusätzliche Funktionen wie Transaktionen oder tägliche Aktualisierungen enthalten, haben jedoch Zugriff auf spezielle Intents für diese Funktionen.

Transaktionshelfer

In der folgenden Tabelle werden Hilfsprogramme für die Verarbeitung von Käufen beschrieben, die von Assistant ausgeführt werden können. Weitere Informationen zum Implementieren dieser und anderer Intents finden Sie in der Dokumentation zum Feature Transaktionen.

Intent-Name Nutzung Dialogflow-Ereignis
actions.intent.DELIVERY_ADDRESS Eine vom Nutzer eingegebene Lieferadresse abrufen. actions_intent_DELIVERY_ADDRESS
actions.intent.TRANSACTION_REQUIREMENTS_CHECK Prüfen Sie, ob alle Anforderungen für eine Transaktion erfüllt sind. actions_intent_TRANSACTION_REQUIREMENTS_CHECK
actions.intent.TRANSACTION_DECISION Fragt den Nutzer, ob die Transaktion ausgeführt werden soll. actions_intent_TRANSACTION_DECISION
actions.intent.DIGITAL_PURCHASE_CHECK Prüft die Transaktionskonfiguration des Nutzers. Damit wird verhindert, dass Nutzern digitale Waren angeboten werden, bei denen die Transaktion fehlschlägt. actions_intent_DIGITAL_PURCHASE_CHECK
actions.intent.COMPLETE_PURCHASE Startet eine Kaufanfrage. Führt zu einem Kaufergebnis, das beschreibt, ob und wie die Transaktion erfolgreich war oder fehlgeschlagen ist. actions_intent_COMPLETE_PURCHASE

Nutzer-Engagement-Intents

In der folgenden Tabelle werden Intents im Zusammenhang mit Funktionen zur Nutzerinteraktion beschrieben. Weitere Informationen zur Implementierung dieser und anderer zugehöriger Intents finden Sie in der Dokumentation zu Funktionen zur Nutzerinteraktion.

Intent-Name Auftragsausführung bereitstellen Ausführung anfordern Nutzung Dialogflow-Ereignis
actions.intent.REGISTER_UPDATE X Fordert den Nutzer auf, sich für Updates zu registrieren. actions_intent_REGISTER_UPDATE
actions.intent.CONFIGURE_UPDATES X Sie erhalten diesen Intent, wenn der Nutzer versucht, sich für Updates zu registrieren. Es sollte also ein REGISTER_UPDATE-Intent gesendet werden. actions_intent_CONFIGURE_UPDATES

Benutzerdefinierte Zielgruppen mit gemeinsamer Absicht

Sie können eigene Intents erstellen, um Verknüpfungen in die Unterhaltung zu definieren und Nutzern zu helfen, Aufgaben effizienter zu erledigen. Diese Intents befinden sich in Ihrem eigenen Namespace. Sie definieren, wie Nutzer die Intents auslösen, und nur Ihr Aktionspaket kann sie unterstützen.

Weitere Informationen finden Sie unter Aktionen in Dialogflow definieren oder mit dem Actions SDK. Weitere Informationen zu Aktionspaketen finden Sie in der Dokumentation Referenz zu Aktionspaketen.

Smart-Home-Intents

Wenn du eine Smart-Home-Aktion erstellst, ist die Unterstützung für Intents etwas anders definiert. Weitere Informationen finden Sie in der Dokumentation zu Smart-Home-Intents.