Mit Aufforderungen definieren Sie, wie Ihre Aktion Nutzern antwortet und wie sie zum Weitermachen aufgefordert werden. Während Sie Ihre Aktion erstellen, können Sie Aufforderungen und verschiedenen Orten in Szenen Aufforderungen hinzufügen. Aufforderungen können so einfach wie eine Text- oder Sprachantwort sein oder komplexer sein und umfangreiche Inhalte wie Karten, Bilder und Tabellen enthalten.
Antworttypen
Für jede Aufforderung stehen Ihnen eine Reihe von ansprechenden Antworttypen zur Verfügung, die Assistant den Nutzern präsentieren kann:
- Einfache Antworten: Einfache Antworten werden in Form einer Chat-Sprechblase und in Form von Sprachausgabe oder Speech Synthese Markup Language (SSML) erstellt. Nur einfache Antworten werden auf allen Gerätetypen unterstützt.
- Umfassende Antworten: Rich-Antworten enthalten visuelle oder funktionale Elemente, die die Nutzerinteraktionen mit Ihren Aktionen verbessern. Mit Rich-Antworten können Sie auch tabellarische Daten anzeigen oder längere Audioinhalte wiedergeben.
- Antworten zur visuellen Auswahl: Visuelle Auswahlantworten bieten Nutzern eine visuelle Oberfläche, über die sie zwischen mehreren Optionen wählen können, die sich am einfachsten durch ihren Titel oder ein Bild unterscheiden lassen.
- Medienantworten: Mit Medienantworten können Sie mit Ihren Aktionen länger Audioinhalte als SSML abspielen und stellen eine visuelle Komponente mit Mediensteuerelementen dar.
- Interaktiver Canvas: Der interaktive Canvas liefert Antworten als Vollbild-Webansichten und fungiert als interaktive Webanwendung, die Assistant als Antwort an den Nutzer in der Unterhaltung sendet. Canvas verwendet ein etwas anderes Format für Aufforderungen, um zusätzliche Flexibilität von Webstandards wie HTML, CSS und JavaScript zu ermöglichen.
Jeder dieser Antworttypen hat das gleiche grundlegende Aufforderungsformat und hat Zugriff auf die unten beschriebenen allgemeinen Funktionen.
Format einer Aufforderung
In Ihrem Actions-Projekt definieren Sie Aufforderungen im YAML- oder JSON-Format. Jede Aufforderung kann bis zu zwei einfache Antworten enthalten und kann optional eine umfangreiche Antwort definieren. Antworten werden folgendermaßen definiert:
first_simple: Einfache Text- oder Sprachantwort, die an den Nutzer gesendet wird.content: Zusätzlicher Rich-Suchergebnisinhalt, der nach einfachen Antworten gesendet werden soll.last_simpleDie endgültige Text- oder Sprachantwort, die an den Nutzer gesendet wird.canvas: verweist auf eine Webanwendung, die in Interactive Canvas integriert werden kann.
Standardmäßig werden Aufforderungen in der oben aufgeführten Reihenfolge in einer Aufforderungswarteschlange aneinander angehängt. Bevor der Nutzer antworten kann, zeigt Assistant dem Nutzer alle Aufforderungen in der Eingabeaufforderung an.
Außerdem bieten Sie mit den folgenden Funktionen zusätzliche Flexibilität:
- Kandidaten: Mit Kandidaten können Sie Antworten auf Basis der Gerätefunktionen eines Nutzers definieren. Assistant kann beispielsweise Rich-Antworten nur dann anzeigen, wenn ein Nutzer mit deiner Aktion auf einem Display-fähigen Gerät interagiert.
- Varianten: Varianten sind alternative Varianten einer einzelnen Nachricht. Assistant kann beispielsweise jedes Mal, wenn ein Nutzer Ihre Aktion aufruft, zwischen fünf verschiedenen Varianten von Willkommensnachrichten wählen.
- Vorschläge: Bei Vorschlägen erhalten Nutzer auf kompatiblen Geräten Chips, wenn Assistant die Aufforderung anzeigt.
Eine Standardaufforderung verwendet einen Kandidaten, eine Variante und eine first_simple-Antwort.
Kandidaten
In einer Aufforderung können Sie mit dem candidates-Objekt Antworten definieren, die auf den Gerätefunktionen eines Nutzers basieren. Assistant kann beispielsweise Rich-Antworten nur dann anzeigen, wenn ein Nutzer mit deiner Aktion auf einem Display-fähigen Gerät interagiert. Um die Gerätetypen zu definieren, auf denen Assistant einen Kandidaten zurückgeben kann, verwende die Property selector des candidates-Objekts.
Im folgenden Beispiel enthält das Attribut selector die Informationen zu den Gerätefunktionen. Die im ersten Kandidaten festgelegten Aufforderungen werden an Nutzer auf einem Gerät gesendet, die Rich-Antworten rendern können. Der zweite Kandidaten enthält Aufforderungen für Nutzer, die nur Text- und Sprachantworten empfangen können.
YAML
candidates:
- selector:
surface_capabilities:
capabilities:
- RICH_RESPONSE
first_simple:
variants:
- speech: Here's a simple message.
content:
card:
title: Image card title
text: Some details about the image
image:
url: 'https://www.example.com/image/'
- first_simple:
variants:
- speech: Text explains what the image might have shown in more detail.
JSON
{
"candidates": [{
"selector": {
"surface_capabilities": {
"capabilities": ["RICH_RESPONSE"]
}
},
"first_simple": {
"variants": [{
"speech": "Here's a simple message."
}]
},
"content": {
"card": {
"title": "Image card title",
"text": "Some details about the image",
"image": {
"url": "https://www.example.com/image/"
}
}
}
}, {
"first_simple": {
"variants": [{
"speech": "Text explains what the image might have shown in more detail."
}]
}
}]
}
Sie können eine oder mehrere Anforderungen für die Fähigkeiten eines bestimmten Kandidaten angeben. In der folgenden Liste werden die einzelnen verfügbaren Funktionsanforderungen beschrieben:
SPEECH: Das Gerät kann per Sprachausgabe oder SSML mit dem Nutzer sprechen.RICH_RESPONSE: Auf dem Gerät können Rich-Antworten wie Karten, Listen und Tabellen angezeigt werden.LONG_FORM_AUDIO: Das Gerät kann lange Medien wie Musik und Podcasts wiedergeben.INTERACTIVE_CANVAS: Das Gerät kann eine interaktive Canvas-Antwort anzeigen.WEB_LINK: Das Gerät kann Weblinks in Rich-Antworten verwenden, um einen Webbrowser zu öffnen.HOME_STORAGE: Auf dem Gerät können Daten aus dem Speicher für zu Hause gespeichert werden.
Varianten
Mit Varianten lassen sich mehrere Versionen einer Antwort definieren. Wenn Assistant die Anfrage an einen Nutzer sendet, wird eine der Varianten zufällig ausgewählt. Wir empfehlen, Nutzern alternative Antworten zu geben, wenn sie mit deiner Aktion interagieren.
Geben Sie beispielsweise verschiedene Varianten von Willkommensnachrichten an, damit Nutzer nicht jedes Mal dieselbe Antwort hören, wenn sie Ihre Aktion aufrufen:
YAML
candidates:
- first_simple:
variants:
- speech: Hello.
- speech: Hi there.
- speech: Welcome.
JSON
{
"candidates": [{
"first_simple": {
"variants": [{
"speech": "Hello."
},{
"speech": "Hi there."
},{
"speech": "Welcome."
}]
}
}]
}
Vorschläge
Vorschläge erscheinen auf kompatiblen Geräten mit Chips, wenn Assistant die Aufforderung anzeigt. Mit Chips für Vorschläge können Sie Nutzerantworten hervorheben, um die Unterhaltung fortzusetzen oder zu gestalten. Wenn ein Nutzer auf ein Vorschlagsfenster tippt, wird der angezeigte Text so wiedergegeben, als ob der Nutzer ihn eingegeben hätte.
Sie können in einer Eingabeaufforderung maximal acht Vorschläge mit jeweils maximal 25 Klartextzeichen enthalten.
Wenn Sie einen Vorschlag hinzufügen möchten, geben Sie ein Suggestion-Objekt an, in dem alle Vorschläge in einem separaten title-Feld enthalten sind. Jeder Titel muss unter den verschiedenen Chips für Vorschläge eindeutig sein. In Actions Builder wird dieses Objekt in YAML und JSON als suggestions dargestellt.
So können Sie beispielsweise neben einer Frage die Vorschläge „Ja“ und „Nein“ angeben:
YAML
candidates:
- first_simple:
variants:
- speech: 'Welcome, do you want to play a game?'
suggestions:
- title: 'Yes'
- title: 'No'
JSON
{
"candidates": [{
"first_simple": {
"variants": [{
"speech": "Welcome, do you want to play a game?"
}]
},
"suggestions": [{
"title": "Yes"
}, {
"title": "No"
}]
}]
}