Na tej stronie dowiesz się, jak utworzyć aplikację Google Chat, która będzie: rozumienia i odpowiadania w języku naturalnym za pomocą Dialogflow. W tym przewodniku: Dialogflow CX, który ma bezpośrednią integrację z Google Chat, Możesz też użyć Dialogflow ES, aplikację Google Chat Dialogflow ES, obserwując Czat Google w Dialogflow ES Google.
Weźmy na przykład aplikację Google Chat, która pomaga wypożyczać w samochodach. Użytkownik może napisać „Chcę wynająć samochód”. Aplikacja do obsługi czatu może odpowiedzieć na takie pytanie: „Skąd chcesz odebrać pojazd?” która zaczyna przypominać ludzki rozmowy z użytkownikiem, w której aplikacja Google Chat rozumie ludzką mowę i reaguje na nie podczas rezerwacji wynajmu samochodu.
To tylko jeden przykład. Aplikacje Dialogflow Chat są przydatne różne typy interakcji. Jeśli wymaga naturalnej mowy, Aplikacja Dialogflow Chat. gotowe agenty pomogą Ci szybko zacząć i pokażesz, co potrafi Dialogflow, na przykład:
- Rezerwuj loty
- Umawianie wizyt u lekarza
- Zamów jedzenie z dostawą
- Odpowiedz na pytania o katalog produktów detalicznych, np. czy są dostępne w innych kolorach
- .
-
Rysunek 2. Przetestowanie agenta w Dialogflow CX w celu sprawdzenia, czy logika i konfiguracja agenta działają zgodnie z oczekiwaniami. Diagram przedstawia sekwencyjny zbiór stron tematycznych dotyczących określonych kroków w rozmowie, takich jak ustawienie miejsca odbioru i zwrotu w przypadku wypożyczenia samochodu, oraz konfiguruje logikę, która je łączy. Rozmowa jest testowana za pomocą symulatora. -
Rysunek 3. Konfigurowanie aplikacji Google Chat do przetwarzania odpowiedzi przy użyciu agenta Dialogflow CX na stronie konfiguracji interfejsu Chat API w konsoli Google Cloud. -
Rysunek 4. Rozmowa na temat rezerwacji samochodu z aplikacji Dialogflow Chat w Google Chat.
Cele
- skonfigurować środowisko,
- utworzyć i wdrożyć agenta Dialogflow CX,
- Utwórz i wdróż aplikację Google Chat wykorzystującą Agent Dialogflow CX.
- Przetestuj aplikację Google Chat.
Wymagania wstępne
- Firmy lub przedsiębiorstwa Konto Google Workspace z dostępem do Google Chat.
- Projekt Google Cloud z włączonymi płatnościami. Aby sprawdzić, czy w istniejącym projekcie są włączone płatności: Więcej informacji można znaleźć w sekcji Weryfikowanie lub stan płatności w projektach. Aby utworzyć projekt i skonfigurować płatności, zobacz Utwórz projekt Google Cloud.
Architektura
Poniższy diagram przedstawia architekturę Aplikacja do obsługi czatu utworzona przy użyciu Dialogflow:
Na poprzednim diagramie użytkownik wchodził w interakcję z Dialogflow W aplikacji Google Chat przepływ informacji jest następujący:
- Użytkownik wysyła wiadomość w Google Chat do w aplikacji Google Chat na czacie lub na czacie. Pokój czatu.
- Agent wirtualny Dialogflow, który znajduje się w Google Cloud, odbiera i przetwarza wiadomość w celu wygenerowania odpowiedzi.
- Opcjonalnie przy użyciu parametru Webhook Dialogflow, agent Dialogflow może wchodzić w interakcje z zewnętrznymi usługami innych firm, takimi jak w ramach systemu zarządzania projektami lub narzędzia do zarządzania zgłoszeniami.
- Agent Dialogflow wysyła odpowiedź do Usługa aplikacji Google Chat w Google Chat.
- Odpowiedź jest dostarczana do pokoju czatu.
Konfigurowanie środowiska
Zanim zaczniesz korzystać z interfejsów API Google, musisz je włączyć w projekcie Google Cloud. W jednym projekcie Google Cloud możesz włączyć 1 lub więcej interfejsów API.W konsoli Google Cloud włącz interfejsy Google Chat API i Dialogflow API.
Sprawdź, czy interfejsy API są włączone we właściwym Projekt Cloud, a następnie kliknij Dalej.
Sprawdź, czy włączasz odpowiednie interfejsy API, a następnie kliknij Włącz.
Tworzenie agenta Dialogflow CX
O Agent Dialogflow CX to agent wirtualny, który obsługuje równoczesne rozmowy z użytkownikami. To moduł zrozumienia języka naturalnego, rozumie niuanse ludzkiego języka. Dialogflow tłumaczy tekst użytkowników podczas rozmowy z uporządkowanymi danymi, . Projektujesz i tworzysz agenta Dialogflow do obsługi typów rozmów wymaganych przez system.
Agent Dialogflow jest jak człowiek centrum obsługi telefonicznej. Szkolisz je obydwu do obsługi oczekiwanych scenariuszy rozmów, a trenowanie nie musi przesadnie wulgarny.
Aby utworzyć agenta Dialogflow CX:
W konsoli Dialogflow CX otwórz konsolę Dialogflow CX. Kliknij Menu > Dialogflow CX.
Wybierz projekt Google Cloud. Aby znaleźć swój projekt, konieczne może być: kliknij Wszystkie i wyszukaj dany element.
Możesz teraz wybrać gotowego agenta lub tworzyć własne. Jeśli wolisz poznać agenta szczegóły, wybierz gotowe agenty, Dzięki nim można się też dowiedzieć, co mogą robić agenty.
Aby wybrać gotowego agenta, wykonaj te czynności:
- Kliknij Użyj gotowych agentów.
Wybierz gotowego agenta. W tym przewodniku wybierz Podróże: wynajem samochodów.
Agenci są oceniani jako początkujący, Średnio zaawansowany lub zaawansowany w zależności od liczby funkcji, z których korzysta agent. a także po wyrafinowaniu logiki jej konwersacji. Wybieranie pośredni lub zaawansowany agent może wymagać dostosowywanie i ustawienia, w tym włączenie funkcji i interfejsów API konsoli Google Cloud.
Kliknij Importuj jako agent.
Aby utworzyć własnego agenta, wykonaj te czynności:
- Kliknij Utwórz agenta.
- Kliknij Generuj automatycznie, aby utworzyć agent magazynu danych lub wybierz Utwórz własne, aby utworzyć inne rodzaje agentów.
Szczegółowy przewodnik po procesie tworzenia agentów znajdziesz w artykule Tworzenie agenta Dialogflow CX
Skonfiguruj podstawowe ustawienia agenta:
- W polu Wyświetlana nazwa wpisz wyświetlaną nazwę.
- Wybierz preferowaną opcję location. Jeśli chcesz zmienić ustawienia zaawansowane ustawienia lokalizacji, kliknij Edytuj.
- Wybierz preferowaną strefę czasową.
- Wybierz domyślny język agenta. Po utworzeniu agenta nie możesz zmienić domyślnego języka.
Kliknij Utwórz. Dialogflow CX rozpocznie tworzenie agenta, po czym wyświetla domyślny proces startowy agenta.
Opcjonalnie dostosuj agenta. Szczegółowy przewodnik po agenta procesu dostosowywania znajdziesz Tworzenie agenta Dialogflow CX
Sprawdzoną metodą jest przetestowanie agenta:
- Kliknij Testuj agenta.
- Wybierz Przetestuj agenta w środowisku.
- W sekcji Środowisko wybierz Wersja robocza.
- W sekcji Flow wybierz Default Start Flow (Domyślny przepływ uruchamiania).
- Na stronie Strona wybierz Strona początkowa.
- W pasku tworzenia wiadomości Porozmawiaj z pracownikiem obsługi klienta wpisz
Hello
i naciśnij Enter. Pracownik obsługi klienta przedstawia się, przedstawiając swoją odpowiedź. - Przeprowadź przykładową rozmowę testową.
Zostanie utworzony agent Dialogflow CX. Wróć do konsoli Dialogflow CX. Kliknij Menu > Dialogflow CX.
.W sekcji Agents (Agenty) kliknij > Skopiuj nazwę. Zapisz tę nazwę jako użyć go podczas konfigurowania aplikacji Google Chat.
.
Tworzenie aplikacji do obsługi czatu i łączenie jej z agentem Dialogflow
Po utworzeniu agenta Dialogflow CX wykonaj te czynności, aby przekształcić go w Aplikacja do obsługi czatu:
W konsoli Google Cloud otwórz interfejs Google Chat API. Wyszukaj „Google Chat API”. oraz kliknij Google Chat API, a następnie Zarządzaj.
Kliknij Konfiguracja i skonfiguruj aplikację Google Chat:
- W polu Nazwa aplikacji wpisz
Dialogflow App
. - W polu URL awatara wpisz
https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
- W polu Opis wpisz
Responds to real human conversation
. - W sekcji Funkcjonalność wybierz Odbieraj wiadomości 1:1. Dołączanie do pokoi i rozmów grupowych
- W sekcji Ustawienia połączenia wybierz Dialogflow.
- W sekcji Ustawienia Dialogflow wybierz Dialogflow CX.
- W polu Agent or Environment resource name (Nazwa zasobu agenta lub środowiska) wklej agenta Dialogflow CX nazwa skopiowana na końcu argumentu Tworzenie agenta Dialogflow CX
- Udostępnianie tej aplikacji Google Chat określonym osobom i grupom w swojej domenie i wpisz swój adres e-mail.
- W sekcji Logi wybierz Rejestruj błędy w usłudze Logging.
- W polu Nazwa aplikacji wpisz
Kliknij Zapisz.
Aplikacja Google Chat jest gotowa do odbierania i odbierania wiadomości wiadomości w Google Chat.
Testowanie aplikacji Google Chat
Przetestuj aplikację Dialogflow CX Chat, wysyłając do niej wiadomość Google Chat.
Otwórz Google Chat za pomocą konta Google Workspace, którego używasz dodane podczas dodawania siebie jako zaufanego testera.
- Kliknij Nowy czat.
- W polu Dodaj co najmniej jedną osobę wpisz nazwę swojego aplikacja Google Chat.
Z wyników wybierz aplikację Google Chat. A Direct
W nowym czacie z aplikacją wpisz
Hello
i naciśnijenter
.W odpowiedzi aplikacji Dialogflow Chat przedstawia
- Ukończ test przykładowej rozmowy testowej.
Przykładowa rozmowa testowa
Aby przetestować aplikację Dialogflow CX Chat w W konsoli Dialogflow CX lub w Google Chat przeprowadź następującą rozmowę. To wyjaśnienie pomoże Ci zrozumieć, jak agent Dialogflow CX interpretuje w języku naturalnym użytkownika i generuje własną odpowiedź w języku naturalnym na każdym etapie rozmowy. Ta przykładowa rozmowa jest oparta na: gotowy agent Podróże: wypożyczalnia samochodów.
Dialog | Wyjaśnienie |
---|---|
Użytkownik: Dzień dobry, Pracownik obsługi klienta: Cześć. Jestem wirtualnym agentem wynajmu samochodów. Mogę pomogą Ci rozpocząć nową rezerwację wynajmu samochodu. Jak mogę pomóc dzisiaj? |
|
Użytkownik: Chcę wynająć samochód. Pracownik obsługi klienta: Skąd chcesz odebrać pojazd? |
|
Użytkownik: Las Vegas Pracownik obsługi klienta: Odbiór będzie w Las Vegas. Pracownik obsługi klienta: czy miejsce zwrotu jest inne niż miejsce odbioru? |
|
Użytkownik: tak. Oddam samochód w Los Angeles. Pracownik obsługi klienta: Dobrze, miejsce zwrotu będzie w Los Angeles. Pracownik obsługi klienta: Kiedy chcesz odebrać pojazd? |
|
Użytkownik: Chcę odebrać samochód 5 marca w południe. Pracownik obsługi klienta: Kiedy chcesz wysiąść z pojazdu? |
|
Użytkownik: 15 marca w południe. Pracownik obsługi klienta: Potwierdź: Odbierzesz pojazd za Las Vegas 5 marca 2024 r. o 12:00:00 i oddanie materiału w Los Angeles 15.03.2024 12:00:00 Czy to się zgadza? |
|
Użytkownik: tak, dziękuję. Pracownik obsługi klienta: Świetnie! Wybierzmy teraz pojazd. Pracownik obsługi klienta: Potrzebujesz klasy ekonomicznej czy luksusowej pojazdem? |
|
Użytkownik: Ekonomia. Pracownik obsługi klienta: Potrzebujesz auta z cymbalem czy ciężarówki z cymbalem? |
|
Użytkownik: Cymbal truck. Pracownik obsługi klienta: Cymbal truck kosztuje 50,33 USD dziennie. Może pomieścić do 4 osób i ma radio AM/FM. Czy chcesz przejść do płatności? Użytkownik: tak, proszę. |
|
Pracownik obsługi klienta: Jakiego typu karty będziesz używać? Użytkownik: Altostrat Pracownik obsługi klienta: wpisz numer karty. Użytkownik: 1234 1234 1234 1234 Pracownik obsługi klienta: Jakie imię i nazwisko ma karta? Użytkownik: Karol Pracownik obsługi klienta: jaki jest adres na potrzeby rozliczeń? Użytkownik: 1800 Amphibious Blvd. Mountain View, CA Pracownik obsługi klienta: Jaki jest kod pocztowy na potrzeby rozliczeń? Użytkownik: 94045 Pracownik obsługi klienta: Wybierzesz samochód Cymbal w Las Vegas o 12:00:00 5 marca 2024 roku o godzinie 12:00:00. 15 marca 2024 r. o 12:00:00. Łączna kwota za tę podróż wyniesie 175,38 USD. Pracownik obsługi klienta: Dziękuję za wypożyczenie i życzę miłego dnia. |
|
Wysyłanie wiadomości z kart z Dialogflow
Dialogflow może odpowiedzieć z użyciem: text lub karty. Aby odpowiedzieć kartą wybierz ładunek niestandardowy cale realizacją zamówień.
Poniższy kod JSON pokazuje, jak wysłać wiadomość z karty jako ładunek niestandardowy w realizacja:
JSON
{
'cardsV2': [{
'cardId': 'createCardMessage',
'card': {
'header': {
'title': 'A card message!',
'subtitle': 'Sent from Dialogflow',
'imageUrl': 'https://developers.google.com/chat/images/chat-product-icon.png',
'imageType': 'CIRCLE'
},
'sections': [
{
'widgets': [
{
'buttonList': {
'buttons': [
{
'text': 'Read the docs!',
'onClick': {
'openLink': {
'url': 'https://developers.google.com/workspace/chat'
}
}
}
]
}
}
]
}
]
}
}]
}
Ograniczenia i uwagi
- Zdarzenia interakcji z Google Chat
mają ograniczoną obsługę i kilka kwestii:
- Poniżej
typy zdarzeń interakcji
są obsługiwane:
MESSAGE
ADDED_TO_SPACE
CARD_CLICKED
- W przypadku zdarzeń
MESSAGE
iADDED_TO_SPACE
dane wejściowe zapytania wysyłane do funkcji Agent Dialogflow odpowiada wartości polaargumentText
w wiadomość w Google Chat. Jeśli wiadomość zawiera ukośnik Command to wartość używane jest poletext
. - W przypadku zdarzeń
CARD_CLICKED
dane wejściowe zapytania zostały wysłane do agenta Dialogflow jest w formacieCARD_CLICKED.functionName
, gdziefunctionName
odpowiada wartości polafunction
funkcji Obiekt Action do elementu interaktywnego karty (np. przycisku). - Pełny ładunek JSON każdego zdarzenia interakcji z Google Chat
jest wysyłana do Dialogflow jako ładunek niestandardowy w parametrze zapytania oraz
można uzyskać za pomocą
Webhook Dialogflow
wysyłając zapytanie o wartość pola
WebhookRequest.payload
.
- Poniżej
typy zdarzeń interakcji
są obsługiwane:
- Uwagi na temat odpowiadania na
polecenia ukośnika i
otrzymujesz dane z kart lub okien:
- Gdy aplikacje Dialogflow Chat otrzymają wiadomość z ukośnikiem
dane wejściowe zapytania będą zawierać tylko wartość z pola
text
. Poletext
zaczyna się od nazwy polecenia po ukośniku (np./command
), której możesz użyć do skonfigurowania intencji agenta Dialogflow. aby wykryć polecenie po ukośniku. - Jeśli agent Dialogflow musi przetworzyć ładunek JSON zdarzenia interakcji z Google Chat, można to zrobić za pomocą webhook Dialogflow aby zbadać ładunek niestandardowy w parametrze zapytania.
- Aby wyświetlić okno z sekcji
agent Dialogflow, w odpowiedzi za pomocą jednego niestandardowego ładunku JSON,
zawiera wiadomość zawierającą
DIALOG
reakcja na działanie. - Aby przetworzyć dane wprowadzane z kart, agent Dialogflow może wykryć
intencje rozpoczynające się od tekstu
CARD_CLICKED
i odpowiadające pojedynczy niestandardowy ładunek JSON zawierający odpowiednie action.
- Gdy aplikacje Dialogflow Chat otrzymają wiadomość z ukośnikiem
dane wejściowe zapytania będą zawierać tylko wartość z pola
- Podgląd linków nie jest obsługiwany.
- Jeśli agent Dialogflow odpowiedział tylko jedną wiadomością,
jest wysyłane synchronicznie do Google Chat. Jeśli agent Dialogflow odpowie
jeśli masz wiele wiadomości, wszystkie są wysyłane do Google Chat
asynchronicznie przez wywołanie metody
create
w zasobiespaces.messages
w interfejsie Chat API po jednym razie dla każdej z tych metod . - Podczas korzystania z integracji Dialogflow CX z Google Chat musisz skonfigurować agenta Dialogflow i aplikację Chat; w tym samym projekcie Google Cloud. Jeśli chcesz skonfigurować Dialogflow i Google Chat w różnych projektach Cloud, możesz skonfiguruj serwer pośredniczący, który ułatwi nawiązywanie połączenia. Aby dowiedzieć się, jak to zrobić, zobacz to Przykład integracji czatu z Dialogflow CX w GitHubie.
Rozwiązywanie problemów
Gdy aplikacja Google Chat lub card zwraca błąd, Interfejs czatu wyświetla komunikat „Coś poszło nie tak”. lub „Nie można przetworzyć żądania”. Czasami interfejs Google Chat nie wyświetla się żaden komunikat o błędzie, ale aplikacja Google Chat lub zwraca nieoczekiwany wynik; na przykład wiadomość w formie karty .
Komunikat o błędzie może nie wyświetlać się w interfejsie Google Chat, opisowe komunikaty o błędach i dane dziennika, które pomogą Ci w naprawianiu błędów gdy logowanie błędów aplikacji Google Chat jest włączone. Aby uzyskać pomoc w wyświetlaniu, debugowania i naprawiania błędów, zapoznaj się z artykułem Rozwiązywanie problemów z błędami w Google Chat
Czyszczenie danych
Aby uniknąć obciążenia konta Google Cloud opłatami za używanych w tym samouczku, zalecamy usunięcie Projekt w chmurze.
- W konsoli Google Cloud otwórz stronę Zarządzanie zasobami. Kliknij Menu > Uprawnienia Administracja > Zarządzaj zasobami.
- Na liście projektów wybierz projekt do usunięcia, a następnie kliknij Usuń .
- W oknie wpisz identyfikator projektu i kliknij Wyłącz, aby go usunąć. nad projektem.
Powiązane artykuły
- Dialogflow CX pobiera:
maszyna stanowa
do projektowania agenta Dialogflow, dając jasny i zrozumiały
kontrolę nad rozmową,
lepsze wrażenia użytkownika oraz
w procesie programowania. Tworzenie interfejsu Dialogflow
aplikację do obsługi czatu, zalecamy użycie Dialogflow CX.
- Więcej informacji o tworzeniu i konfigurowaniu agentów znajdziesz w artykule Agenty Dialogflow CX
- Szczegółowe instrukcje dotyczące tworzenia i konfigurowania agentów, zobacz Tworzenie agenta Dialogflow CX
- Twórz aplikacje na potrzeby Google Chat za pomocą Gemini. Ćwiczenie z programowania: przykład tworzenia danych Dialogflow CX pracownik obsługi klienta sklepu, zobacz aplikację do obsługi czatu od firmy ćwiczenie w Codelabs
- Twórz aplikacje na potrzeby Google Chat za pomocą Gemini. Ćwiczenie z programowania: przykład tworzenia Dialogflow CX agent konwersacyjny, wyświetlanie opinii w aplikacji Google Chat z ćwiczenia w Codelabs
- Dialogflow ES to inny sposób korzystania z Dialogflow z aplikacją Google Chat.