Actions on Google umożliwia rozszerzanie funkcjonalności Asystenta Google za pomocą Actions. Działania umożliwiają użytkownikom wykonywanie różnych zadań w interfejsie konwersacyjnym, od prostych poleceń włączających niektóre światła lub dłuższe rozmowy, na przykład granie w quizy.
SDK Actions to metoda tworzenia rozmów bez użycia Dialogflow. Jeśli korzystasz z Pakietu SDK Actions, służy on do mapowania intencji na ich realizację. Musisz też podać wzorce zapytań w pakiecie działań, aby zdefiniować przykładowe wyrażenia, które mogą używać użytkownicy.
interfejs wiersza poleceń
Gdy programujesz w pakiecie SDK Actions, do testowania i aktualizowania projektu możesz używać interfejsu wiersza poleceń gactions. Interfejs wiersza poleceń gactions ułatwia też tworzenie pakietu działań i zarządzanie nim.
Tworzenie działań w pakiecie działań
Działania możesz tworzyć w pakiecie Action, mapując intencje na realizację. Akcja określa punkt początkowy, w którym można rozpocząć rozmowę z unikalnym identyfikatorem o nazwie intencja. Intencje mapują się na realizacje, które przetwarzają intencję.
Załóżmy, że chcesz utworzyć projekt zawierający działania, które umożliwiają zakup określonych towarów, sprawdzenie stanu zamówień i wyświetlenie ofert dnia. Możesz zdefiniować intencje, które są aktywowane, mówiąc:
- „OK Google, porozmawiaj z przykładową akcją”.
- „OK Google, zadzwoń do przykładowej firmy, aby kupić buty”.
- „OK Google, porozmawiaj z ExampleAction, aby sprawdzić moje zamówienie”.
- „OK Google, porozmawiaj z przykładową akcją, aby wyświetlić dzisiejsze oferty”.
Plik JSON pakietu działań może wyglądać tak:
{
"actions": [
{
"name": "MAIN",
"intent": {
"name": "actions.intent.MAIN"
},
"fulfillment": {
"conversationName": "ExampleAction"
}
},
{
"name": "BUY",
"intent": {
"name": "com.example.ExampleAction.BUY",
"parameters": [{
"name": "color",
"type": "org.schema.type.Color"
}],
"trigger": {
"queryPatterns": [
"find some $org.schema.type.Color:color sneakers",
"buy some blue suede shoes",
"get running shoes"
]
}
},
"fulfillment": {
"conversationName": "ExampleAction"
}
},
{
"name": "ORDER_STATUS",
"intent": {
"name": "com.example.ExampleAction.ORDER_STATUS",
"trigger": {
"queryPatterns": [
"check on my order",
"see order updates",
"check where my order is"
]
}
},
"fulfillment": {
"conversationName": "ExampleAction"
}
},
{
"name": "DAILY_DEALS",
"intent": {
"name": "com.example.ExampleAction.DAILY_DEALS",
"trigger": {
"queryPatterns": [
"hear about daily deals",
"buying some daily deals",
"get today's deals"
]
}
},
"fulfillment": {
"conversationName": "ExampleAction"
}
}
],
"conversations": {
"ExampleAction": {
"name": "ExampleAction",
"url": "https://www.example.com/ExampleAction"
}
}
}
Tworzenie i wdrażanie webhooka realizacji zamówień
Po wywołaniu działania w projekcie usługa Actions on Google wywołuje Twoją realizację, aby rozpocząć rozmowę z użytkownikami na potrzeby wykonania działania.
W każdym żądaniu do webhooka realizującego zadanie otrzymujesz dane wejściowe użytkownika w postaci ciągu tekstowego. Aby przetworzyć intencję, zwykle analizujesz dane wejściowe i zwracasz odpowiedź. Dalej jest wymiana informacji do momentu zakończenia akcji.
Prześlij pakiet działań
Po utworzeniu pakietu działań i wdrożeniu jego realizacji możesz przesłać pakiet działań do konsoli Actions. Konsola Actions korzysta z projektów akcji, aby grupować akcje konwersacyjne za pomocą metadanych, takich jak stan sprawdzania i wyświetlana nazwa w katalogu Asystenta. Projekt umożliwia też definiowanie metadanych dotyczących działania oraz zarządzanie i śledzenie tego działania w ramach procesu zatwierdzania.
Po utworzeniu projektu możesz przesłać pakiet działań, który określa wszystkie Twoje działania za pomocą interfejsu wiersza poleceń gactions.
Prześlij projekt do zatwierdzenia i udostępnij go użytkownikom
Przykłady
Aby zobaczyć ukończone projekty, wyświetl przykłady pakietu SDK działań w Node.js i Java.