Utwórz aplikację Google Chat Dialogflow CX, która rozumie język naturalny i odpowiednio na nie reaguje.

Z tego artykułu dowiesz się, jak za pomocą Dialogflow utworzyć aplikację Google Chat, która rozumie język naturalny i odpowiada na nie. W tym przewodniku używana jest usługa Dialogflow CX, która oferuje bezpośrednią integrację z Google Chat w wersji przedpremierowej dla programistów. Możesz też użyć Dialogflow ES do utworzenia aplikacji Google Chat w języku Dialogflow ES, postępując zgodnie z instrukcjami Dialogflow ES Google Chat.

Weźmy na przykład aplikację Google Chat ułatwiającą wypożyczanie samochodów. Użytkownik może napisać: „Chcę wynająć samochód”. Aplikacja Google Chat może odpowiedzieć na pytanie „Gdzie chcesz odebrać pojazd?”, co rozpoczyna rozmowę z użytkownikiem przypominającą ludzką rozmowę. Podczas rezerwowania samochodu aplikacja Google Chat rozumie ludzką wypowiedź i reaguje w ten sposób.

To tylko jeden przykład. Aplikacje do obsługi czatu Dialogflow są przydatne we wszystkich rodzajach interakcji. Jeśli wymaga ono naturalnej mowy ludzkiej, powstała aplikacja dialogowa Dialogflow. Gotowe agenty pomagają w szybkim rozpoczęciu pracy i pokazują możliwości Dialogflow, takie jak:

• Rezerwuj loty
• Umawianie się na wizyty lekarskie
• Zamów jedzenie z dostawą
• Odpowiedz na pytania dotyczące katalogu produktów, np. czy produkty są dostępne w innych kolorach

Cele

• skonfigurować środowisko,
• utworzyć i wdrożyć agenta Dialogflow CX;
• utworzyć i wdrożyć aplikację do obsługi czatu obsługiwaną przez agenta Dialogflow CX;
• Przetestuj aplikację Google Chat.

Wymagania wstępne

• konto Google Workspace z dostępem do Google Chat.
• Projekt Google Cloud.
• Sprawdź, czy masz włączone płatności w projekcie Cloud. Dowiedz się, jak sprawdzić stan rozliczeń projektów.

Architektura

Poniższy diagram przedstawia architekturę aplikacji do obsługi czatu utworzonej przy użyciu Dialogflow:

Na poprzednim diagramie użytkownik korzystający z aplikacji Dialogflow udostępnia następujący przepływ informacji:

1. Użytkownik wysyła wiadomość w Google Chat do aplikacji Google Chat na czacie lub w pokoju czatu.
2. Agent wirtualny Dialogflow, który działa w Google Cloud, odbiera i przetwarza wiadomość w celu wygenerowania odpowiedzi.
3. Opcjonalnie za pomocą webflow Dialogflow agent Dialogflow może wchodzić w interakcje z zewnętrznymi usługami, takimi jak system zarządzania projektami czy narzędzie do zgłaszania zgłoszeń.
4. Agent Dialogflow wysyła odpowiedź do usługi aplikacji Google Chat w Google Chat.
5. Odpowiedź zostanie dostarczona do pokoju czatu.

Konfigurowanie środowiska

1. W konsoli Google Cloud włącz Google Chat API i Dialogflow API.

   Włączanie interfejsów API

2. Sprawdź, czy interfejsy API włączasz w odpowiednim projekcie Cloud, a następnie kliknij Dalej.

3. Sprawdź, czy włączasz właściwe interfejsy API, a następnie kliknij Włącz.

Tworzenie agenta Dialogflow CX

Agent Dialogflow CX to agent wirtualny, który obsługuje jednoczesne rozmowy z użytkownikami. To moduł rozumienia języka naturalnego, który rozumie niuanse ludzkiego języka. Dialogflow przekształca tekst podczas rozmowy przez użytkownika na uporządkowane dane, które są w stanie zrozumieć aplikacje i usługi. Zaprojektujesz i utworzysz agenta Dialogflow do obsługi typów rozmów wymaganych w Twoim systemie.

Agent Dialogflow jest jak ludzki agent centrum obsługi telefonicznej. Trenujesz je tak, aby obsługiwały oczekiwane scenariusze rozmowy, a trenowanie nie musi być zbyt jednoznaczne.

Aby utworzyć agenta Dialogflow CX:

1. W konsoli Dialogflow CX otwórz konsolę Dialogflow CX. Kliknij Menu menu > Dialogflow CX.

   Otwórz konsolę Dialogflow CX

2. Wybierz projekt Google Cloud. Aby znaleźć projekt, być może trzeba będzie kliknąć Wszystkie i wyszukać go.

3. Teraz możesz wybrać gotowego agenta lub utworzyć własnego. Jeśli wolisz później szczegółowo przyjrzeć się dostosowywaniu agentów, wybierz jeden z gotowych agentów, który pomoże Ci też poznać możliwości agentów.

   Aby wybrać gotowego agenta, wykonaj te czynności:

   1. Kliknij Użyj gotowych agentów.

   2. Wybierz gotowego agenta. Na potrzeby tego przewodnika wybierz Podróże: wypożyczenie samochodu.

      Agenty są oceniane jako początkujące, średniozaawansowane i zaawansowane w zależności od liczby funkcji, z których korzysta, oraz od poziomu zaawansowania logiki rozmowy. Wybór pośredniego lub zaawansowanego agenta może wymagać dostosowań i ustawień danego agenta, w tym włączenia funkcji i interfejsów API w konsoli Google Cloud.

   3. Kliknij Import as agent (Importuj jako agent).

   Aby utworzyć własnego agenta, wykonaj te czynności:

   1. Kliknij Utwórz agenta.
   2. Wybierz Wygeneruj automatycznie, aby utworzyć agenta magazynu danych, lub wybierz Utwórz własny, aby utworzyć inne rodzaje agentów.

   Szczegółowy przewodnik dotyczący procesu tworzenia agenta znajdziesz w artykule Tworzenie agenta Dialogflow CX.

4. Skonfiguruj podstawowe ustawienia agenta:

   1. W polu Wyświetlana nazwa wpisz wyświetlaną nazwę.
   2. Wybierz preferowaną lokalizację. Jeśli chcesz zmienić zaawansowane ustawienia lokalizacji, kliknij Edytuj.
   3. Wybierz preferowaną strefę czasową.
   4. Wybierz domyślny język agenta. Po utworzeniu agenta nie możesz zmienić jego domyślnego języka.

5. Kliknij Utwórz. Dialogflow CX rozpoczyna tworzenie agenta, a następnie wyświetla domyślny przepływ uruchamiania agenta.

6. Opcjonalnie dostosuj agenta. Szczegółowy opis procesu dostosowywania agenta znajdziesz w artykule o tworzeniu agenta Dialogflow CX.

7. Przetestuj agenta:

   1. Kliknij Testuj agenta.
   2. Kliknij Testuj agenta w środowisku.
   3. W środowisku wybierz Wersja robocza.
   4. W sekcji Flow (Przepływ) wybierz Default Start Flow (Domyślny przepływ rozpoczęcia).
   5. Na stronie wybierz Strona startowa.
   6. Na pasku tworzenia wiadomości Porozmawiaj z pracownikiem obsługi klienta wpisz Hello i naciśnij Enter. Pracownik obsługi klienta odpowiada, przedstawiając się.
   7. Dokończ test, przeprowadzając przykładową rozmowę testową.

8. Zostanie utworzony agent Dialogflow CX. Wróć do konsoli Dialogflow CX. Kliknij Menu menu > Dialogflow CX.

   Otwórz konsolę Dialogflow CX

9. W sekcji Agenty kliknij more_vert > Kopiuj nazwę. Zapisz ją tak, jak będzie używana podczas konfigurowania aplikacji Google Chat.

Utwórz aplikację do obsługi czatu i połącz ją z agentem Dialogflow

Po utworzeniu agenta Dialogflow CX wykonaj te czynności, aby przekształcić go w aplikację do obsługi czatu:

1. W konsoli Google Cloud otwórz Google Chat API. Wyszukaj „Google Chat API” i kliknij Google Chat API, a następnie Zarządzaj.

   Przejdź do Google Chat API

2. Kliknij Konfiguracja i skonfiguruj aplikację Google Chat:

   1. W polu Nazwa aplikacji wpisz Dialogflow App.
   2. W polu Avatar URL wpisz https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
   3. W polu Opis wpisz Responds to real human conversation.
   4. W sekcji Funkcjonalność wybierz Odbieranie wiadomości 1:1 i Dołączanie do pokoi i rozmów grupowych.
   5. W sekcji Ustawienia połączenia wybierz Dialogflow.
   6. W sekcji Ustawienia Dialogflow wybierz Dialogflow CX.
   7. W polu Nazwa zasobu klienta lub środowiska wklej nazwę agenta Dialogflow CX skopiowaną na końcu artykułu Tworzenie agenta Dialogflow CX.
   8. Udostępnij tę aplikację do obsługi czatu określonym osobom i grupom w Twojej domenie i wpisz swój adres e-mail.
   9. W sekcji Logi wybierz Rejestruj błędy w usłudze Logging.

3. Kliknij Zapisz.

Aplikacja Google Chat jest gotowa do odbierania wiadomości i odpowiadania na nie.

Testowanie aplikacji Google Chat

przetestować aplikację Dialogflow CX Chat, wysyłając do niej wiadomość w Google Chat.

1. Otwórz Google Chat na koncie Google Workspace podanym podczas dodawania siebie jako zaufanego testera.

   Otwórz Google Chat

2. Kliknij add Nowy czat.
3. W polu Dodaj co najmniej 1 osobę wpisz nazwę aplikacji do obsługi czatu.

4. W wynikach wybierz swoją aplikację do obsługi czatu. Otworzy się czat.

5. W nowym czacie z aplikacją wpisz Hello i naciśnij enter.

   Aplikacja Dialogflow Chat odpowiada, przedstawiająca się.

6. Dokończ test, przeprowadzając przykładową rozmowę testową.

Przykładowa rozmowa testowa

Aby przetestować aplikację Dialogflow CX Chat w konsoli Dialogflow CX lub w Google Chat, przeprowadź tę rozmowę. Dzięki wyjaśnieniom łatwiej zrozumiesz, jak agent Dialogflow CX interpretuje język naturalny użytkownika i tworzy własne odpowiedzi w tym języku na każdym etapie rozmowy. Ta przykładowa rozmowa opiera się na gotowym agenta o nazwie Podróże: wypożyczalnia samochodów.

Wysyłaj wiadomości z kart z Dialogflow

Dialogflow może odpowiadać, wysyłając tekst lub wiadomości na karta. Aby odpowiedzieć za pomocą wiadomości z kartą, określ ją jako ładunek niestandardowy w ramach realizacji.

Poniższy kod JSON pokazuje, jak wysłać wiadomość karty jako niestandardowy ładunek w ramach realizacji:

{
  '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 są obsługiwane w ograniczonym zakresie i należy wziąć pod uwagę kilka kwestii:
  • Obsługiwane są te typy zdarzeń interakcji:
    • MESSAGE
    • ADDED_TO_SPACE
  • Dane wejściowe zapytania wysłane do agenta Dialogflow odpowiadają wartości pola argumentText w wiadomości Google Chat. Jeśli wiadomość zawiera polecenie po ukośniku, zamiast tego używana jest wartość z pola text.
  • Pełny ładunek JSON każdego zdarzenia interakcji w Google Chat jest wysyłany do Dialogflow jako ładunek niestandardowy w parametrze zapytania. Można go otworzyć za pomocą webflow dialogu, wysyłając zapytanie o wartość w polu WebhookRequest.payload.
• Polecenia po ukośniku mają ograniczoną obsługę:
  • Polecenia po ukośniku otwierające okna dialogowe nie są obsługiwane przez aplikacje Dialogflow Chat.
  • Gdy aplikacje do obsługi czatu Dialogflow otrzymają wiadomość po ukośniku, dane wejściowe zapytania będą zawierać tylko wartość pola text. Pole text zaczyna się od nazwy polecenia po ukośniku (np. /command), za pomocą którego możesz skonfigurować intencję agenta Dialogflow do wykrywania polecenia po ukośniku.
  • Jeśli agent Dialogflow musi przetworzyć ładunek JSON zdarzenia interakcji z poleceniem ukośnika, może to zrobić przy użyciu webhooka Dialogflow do sprawdzenia ładunku niestandardowego w parametrze zapytania.
• Podgląd linków nie jest obsługiwany.
• Jeśli agent Dialogflow odpowie tylko 1 wiadomością, zostanie ona wysłana synchronicznie do Google Chat. Jeśli agent Dialogflow odpowiada, wszystkie wiadomości są wysyłane do Google Chat asynchronicznie przez wywołanie metody create w zasobie spaces.messages w interfejsie Chat API dla każdej wiadomości.

Rozwiązywanie problemów

Gdy aplikacja lub karta Google Chat zwróci błąd, interfejs czatu wyświetli komunikat „Coś poszło nie tak” lub „Nie udało się przetworzyć Twojej prośby”. Czasami w interfejsie Google Chat nie pojawia się żaden komunikat o błędzie, ale aplikacja lub karta Google Chat zwraca nieoczekiwany wynik, na przykład komunikat na karcie może się nie pojawić.

Mimo że komunikat o błędzie może nie wyświetlać się w interfejsie Google Chat, dostępne są opisowe komunikaty o błędach i dane dziennika, które pomogą Ci naprawić błędy występujące po włączeniu logowania błędów w aplikacjach do obsługi czatu. Informacje o wyświetlaniu, debugowaniu i naprawianiu błędów znajdziesz w artykule Rozwiązywanie problemów z Google Chat i ich naprawianie.

Czyszczenie danych

Aby uniknąć obciążenia konta Google Cloud opłatami za zasoby zużyte w tym samouczku, zalecamy usunięcie projektu Cloud.

1. W konsoli Google Cloud otwórz stronę Zarządzanie zasobami. Kliknij Menu menu > Administracja > Zarządzaj zasobami.

   Otwórz menedżera zasobów

2. Na liście projektów wybierz projekt, który chcesz usunąć, a następnie kliknij Usuń delete.
3. W oknie wpisz identyfikator projektu i kliknij Wyłącz, aby usunąć projekt.

Powiązane artykuły

• Dialogflow CX wykorzystuje maszynę stanu do projektowania agentów Dialogflow, co zapewnia wyraźną i wyraźną kontrolę nad rozmową, zapewnia użytkownikom lepsze wrażenia i usprawnia proces programowania. Podczas tworzenia aplikacji do obsługi czatu Dialogflow zalecamy użycie Dialogflow CX.
  • Więcej informacji o tworzeniu i konfigurowaniu agentów znajdziesz w sekcji Agenty Dialogflow CX.
  • Szczegółowy przewodnik z instrukcjami tworzenia i konfigurowania agentów znajdziesz w artykule Tworzenie agenta Dialogflow CX.
• Dialogflow ES to kolejny sposób korzystania z Dialogflow z użyciem aplikacji do obsługi czatu.