Model wywołania określa sposób, w jaki użytkownicy mogą wywoływać działania w projekcie. Gdy użytkownicy wywołują akcję, rozpoczynają z nią rozmowę, która jest definiowana przez model rozmowy. Wywołania możesz definiować na te sposoby:
Wywołanie główne – to jedyne wywołanie wymagane w przypadku projektu Actions. Użytkownicy podają wyrażenia podobne do tych: „OK Google, porozmawiaj z <wyświetlana nazwa>”, aby odzwierciedlić tę intencję. Właściwie to zawrzesz w wiadomości powitalnej.
Wywołania precyzyjnych linków – są to opcjonalne wywołania, które umożliwiają definiowanie wyrażeń do trenowania w niestandardowej intencji, dzięki czemu użytkownicy mogą tworzyć precyzyjne linki do konkretnych części rozmowy. Użytkownicy mogą używać zwrotów podobnych do tego: „OK Google, porozmawiaj z <wyświetlaną nazwą> na <wyrażenie z precyzyjnym linkiem>” (np. „OK Google, porozmawiaj z informacjami o Google, aby poznać informacje o firmie”).
Intencje wbudowane – są to opcjonalne wywołania, które umożliwiają korzystanie ze zdefiniowanych przez system modeli wywołań. Zadeklarując obsługę intencji wbudowanej, użytkownicy mogą wykrywać i wywoływać projekt w Actions bez konieczności podawania wyświetlanej nazwy. Na przykład użytkownik może powiedzieć „OK Google, włącz grę”, a Asystent Google może wyświetlić akcję jako opcję wywołania.
Tworzenie wywołania głównego
Każdy projekt w Actions ma domyślne, główne wywołanie, które pełni funkcję domyślnego punktu wejścia do projektu w Actions.Model językowy tego wywołania jest powiązany z wyświetlaną nazwą projektu, więc użytkownicy muszą wypowiedzieć wyrażenie podobne do „OK Google, porozmawiaj z <wyświetlaną nazwą>”, aby użyć tego wywołania. Gdy użytkownicy wywołają akcję w ten sposób, środowisko wykonawcze Asystenta odpowiada intencji systemowej actions.intent.MAIN.
Aby utworzyć wywołanie główne:
Tworzenie wywołań precyzyjnych linków
Aby utworzyć wywołania precyzyjnych linków, tworzysz globalne intencje użytkownika zawierające frazy treningowe definiujące dane wejściowe użytkownika, które chcesz ustawić dla precyzyjnego linku. Użytkownicy podają Twoją wyświetlaną nazwę w połączeniu z wyrażeniem z precyzyjnym linkiem, aby wykonać wywołanie precyzyjnego linku (np. „OK Google, porozmawiaj z <nazwa_reklamowa>, aby <wyrażenie z precyzyjnym linkiem>”)).
Utwórz wywołania niejawne
Wywołanie niejawne pozwala użytkownikom wywoływać akcję bez używania wyświetlanej nazwy projektu. Aby znaleźć pasujące działania, Google wykorzystuje sygnały, np. gdy użytkownicy proszą Asystenta o wykonanie czegoś podobnego do wyrażenia wywołania jednego ze skonfigurowanych intencji lub gdy użytkownik znajduje się w kontekście, w którym akcje byłyby odpowiednie.
Obsługa zdarzeń wywołania
Gdy Asystent pasuje do jednej z intencji globalnych, wywołuje zdarzenie, które możesz przetworzyć za pomocą modułu obsługi. Czynności, które wykonuje Twój moduł obsługi, są opisane w kolejnych sekcjach (możesz wybrać jedną z nich lub dowolną ich kombinację).
Aktywowanie webhooka
Moduł obsługi intencji może przekazać dostęp do usługi internetowej przez wywołanie zdarzenia webhooka. Aby aktywować webhooka i ustawić usługę sieciową do obsługi wywołania:
Prośby
Moduł obsługi intencji może odpowiedzieć statyczną promptem. Zwykle prompty związane z intencjami wywołania powitają użytkownika, wskazują mu, jak używać akcji, lub odpowiadają na informacje, których potrzebuje użytkownik, natychmiast (działania „one-shot”).
Aby obsługiwać dopasowanie intencji wywołania do promptu:
Przejście do sceny
Moduł obsługi intencji może przejść do sceny, aby przetworzyć pasującą intencję wywołania. Zapewnia to największą elastyczność przy wykonywaniu logiki. Aby przejść do sceny: