Intencje to obiekty przekazu, które opisują, jak coś zrobić. Z zamiarów możesz korzystać na 2 sposoby:
- Dostarczając realizacji intencji lub
- Przez wysłanie prośby o zrealizowanie intencji przez Asystenta Google.
Proces, w ramach którego dostarczasz intencję, różni się w przypadku tworzenia treści za pomocą Dialogflow i tworzenia treści za pomocą pakietu Actions SDK. W obu przypadkach podajesz nazwę intencji i adres URL webhooka realizacji. Informuje to Actions on Google, że możesz obsługiwać zapytania użytkowników pasujące do intencji.
Aby zażądać realizacji intencji, określ ją w obiekcie possibleIntents, odpowiadając Asystentowi. W kolejnym żądaniu do realizacji Asystent zwraca Ci wynik przetworzonej intencji. Więcej informacji znajdziesz w omówieniu korzystania z usług pomocy.
Typowe intencje
W tabeli poniżej znajdziesz intencje, które Asystent chce zrealizować.
| Nazwa intencji | Wykorzystanie | Zdarzenie Dialogflow |
|---|---|---|
actions.intent.MAIN |
Wymagane: każdy pakiet akcji deklaruje tylko 1 intencję, która jest punktem wejścia użytkownika do rozmowy. | WELCOME lub GOOGLE_ASSISTANT_WELCOME |
actions.intent.TEXT |
Uzyskiwanie reprezentacji żądania użytkownika w formie tekstowej. Najczęściej używasz go podczas rozmów z użytkownikami. | |
actions.intent.CANCEL |
Intencję otrzymujesz, gdy zdecydujesz się na otrzymywanie intencji anulowania w pakiecie działań. Gdy użytkownicy wypowiedzą globalne polecenie anulowania, takie jak „close”, otrzymasz tę intencję w następnym żądaniu w ramach realizacji, więc możesz odpowiedzieć z końcową wiadomością i dokonać czyszczenia w logice realizacji. | actions_intent_CANCEL |
actions.intent.NO_INPUT |
Intencję otrzymujesz, gdy włączysz otrzymywanie intencji bez danych wejściowych w pakiecie działań. Jeśli użytkownicy nie odpowiedzą na prompt, otrzymasz tę intencję w następnym żądaniu realizacji. | actions_intent_NO_INPUT |
Pomocnicy
W tabeli poniżej znajdziesz listę obsługiwanych pomocy, o których możesz poprosić Asystenta.
| Nazwa intencji | Wykorzystanie | Zdarzenie Dialogflow |
|---|---|---|
actions.intent.PERMISSION |
Uzyskaj imię i nazwisko, przybliżoną lub dokładną lokalizację użytkownika lub wszystkie te 3 opcje. | actions_intent_PERMISSION |
actions.intent.OPTION |
Odbierz wybrany element z interfejsu listy lub karuzeli. Jeśli użytkownik nie wybierze opcji w interfejsie listy lub karuzeli, otrzyma mowę lub tekst pasujący do klucza w interfejsie listy lub karuzeli. | actions_intent_OPTION |
actions.intent.DATETIME |
Poproś użytkownika o podanie daty i godziny. | actions_intent_DATETIME |
actions.intent.SIGN_IN |
Wysyła prośbę o łączenie kont w celu połączenia konta użytkownika. | actions_intent_SIGN_IN |
actions.intent.PLACE |
Uzyskanie od użytkownika adresu lub zapisanej lokalizacji. | actions_intent_PLACE |
actions.intent.CONFIRMATION |
Uzyskaj potwierdzenie od użytkownika (np. odpowiedź na pytanie „tak lub nie”). | actions_intent_CONFIRMATION |
actions.intent.NEW_SURFACE |
Prosi użytkownika o uprawnienia do przekazywania do innego panelu Asystenta. | actions_intent_NEW_SURFACE |
Intencje wbudowane
Intencje wbudowane modelują niektóre z typowych sposobów, w jakie użytkownicy wyrażają zadania, które próbują wykonać, lub poszukiwane informacje, takie jak zamówienie posiłku, zarezerwowanie przejazdu czy sprawdzenie salda konta. Więcej informacji znajdziesz w dokumentacji intencji wbudowanych.
Dodatkowe intencje
Większość akcji związanych z rozmowami powstaje z wykorzystaniem połączenia typowych intencji, elementów pomocniczych i odpowiedzi. Działania obejmujące dodatkowe funkcje, takie jak transakcje lub codzienne aktualizacje, mają jednak dostęp do intencji specyficznych dla tych funkcji.
Pomocnicy ds. transakcji
W tabeli poniżej znajdziesz listę pomocników związanych z obsługą zakupów, o których wykonanie możesz poprosić Asystenta. Więcej informacji o implementowaniu tych i innych powiązanych intencji znajdziesz w dokumentacji funkcji transakcji.
| Nazwa intencji | Wykorzystanie | Zdarzenie Dialogflow |
|---|---|---|
actions.intent.DELIVERY_ADDRESS |
Uzyskaj od użytkownika adres dostawy. | actions_intent_DELIVERY_ADDRESS |
actions.intent.TRANSACTION_REQUIREMENTS_CHECK |
Sprawdź, czy zostały spełnione wszystkie wymagania dotyczące transakcji. | actions_intent_TRANSACTION_REQUIREMENTS_CHECK |
actions.intent.TRANSACTION_DECISION |
Pytanie użytkownika, czy transakcja powinna zostać zrealizowana. | actions_intent_TRANSACTION_DECISION |
actions.intent.DIGITAL_PURCHASE_CHECK |
Weryfikuje konfigurację transakcji użytkownika. Służy do uniknięcia oferowania produktów cyfrowych użytkownikom, w przypadku których transakcja się nie powiedzie. | actions_intent_DIGITAL_PURCHASE_CHECK |
actions.intent.COMPLETE_PURCHASE |
Wysyła prośbę o zakup. Rezultatem jest wynik zakupu z informacją, czy i w jaki sposób transakcja zakończyła się powodzeniem lub niepowodzeniem. | actions_intent_COMPLETE_PURCHASE |
Zamiary zaangażowania użytkowników
W tabeli poniżej opisujemy intencje związane z funkcjami związanymi z zaangażowaniem użytkowników. Więcej informacji na temat wdrażania tych i innych podobnych zamiarów znajdziesz w dokumentacji funkcji zaangażowania użytkowników.
| Nazwa intencji | Realizacja | Realizacja żądania | Wykorzystanie | Zdarzenie Dialogflow |
|---|---|---|---|---|
actions.intent.REGISTER_UPDATE |
X | Wyświetla użytkownikowi prośbę o zarejestrowanie się na aktualizacje. | actions_intent_REGISTER_UPDATE |
|
actions.intent.CONFIGURE_UPDATES |
X | Intencję otrzymujesz, gdy użytkownik próbuje zarejestrować się w celu uzyskania aktualizacji (tzn. powinna zostać wysłana intencja REGISTER_UPDATE). | actions_intent_CONFIGURE_UPDATES |
Zamiary niestandardowe
Możesz tworzyć własne intencje definiowania skrótów do rozmowy, aby pomóc użytkownikom sprawniej wykonywać zadania. Intencje te znajdują się we własnej przestrzeni nazw. Określasz, jak użytkownicy wywołują intencje, a Twój pakiet akcji jest jedynym, który może je obsługiwać.
Więcej informacji znajdziesz w artykule o definiowaniu działań w Dialogflow lub o korzystaniu z pakietu Actions SDK. Więcej informacji o pakietach działań znajdziesz w dokumentacji pakietu działań.
Intencje dotyczące inteligentnego domu
Jeśli tworzysz akcję w inteligentnym domu, możesz zdefiniować obsługę intencji w nieco inny sposób. Więcej informacji znajdziesz w dokumentacji intencji inteligentnego domu.