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.