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

Na tej stronie dowiesz się, jak utworzyć aplikację w Google Chat, która potrafi rozumieć język naturalny i odpowiadać w nim za pomocą Dialogflow. W tym przewodniku używamy Dialogflow CX, które jest bezpośrednio zintegrowane z Google Chat. Możesz też użyć Dialogflow ES, aby utworzyć aplikację Google Chat Dialogflow ES, korzystając z przewodnika Dialogflow ES Google Chat.

Rozważmy na przykład aplikację do obsługi czatu, która pomaga użytkownikom wypożyczać samochody. Użytkownik może napisać: „Chcę wypożyczyć samochód”. Aplikacja do Google Chat może odpowiedzieć na przykład pytaniem „Gdzie chcesz odebrać pojazd?”, co rozpocznie rozmowę z użytkownikiem, w której aplikacja do Google Chat będzie rozumieć i odpowiadać w sposób przypominający ludzką mowę podczas rezerwacji wypożyczenia samochodu.

To tylko jeden przykład. Aplikacje do obsługi czatu Dialogflow przydają się w różnych interakcjach. Jeśli wymaga naturalnej mowy, potrzebna jest aplikacja Dialogflow Chat. Gotowe agenty pomogą Ci szybko zacząć i zaprezentują możliwości Dialogflow, takie jak:

• Rezerwowanie lotów
• Planowanie wizyt u lekarza
• Zamawianie jedzenia z dostawą
• Odpowiadanie na pytania dotyczące katalogu produktów w sklepie, np. czy produkty są dostępne w innych kolorach.

Cele

• skonfigurować środowisko,
• Utwórz i wdroż agenta Dialogflow CX.
• Tworzenie i wdrażanie aplikacji do obsługi czatu opartej na agencie Dialogflow CX.
• Przetestuj aplikację Google Chat.

Wymagania wstępne

• Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
• projekt Google Cloud z włączonymi płatnościami; Aby sprawdzić, czy w istniejącym projekcie włączone są płatności, zapoznaj się z artykułem Sprawdzanie stanu rozliczeń projektów. Aby utworzyć projekt i skonfigurować rozliczenia, zapoznaj się z artykułem Tworzenie projektu Google Cloud.

Architektura

Poniższy diagram przedstawia architekturę aplikacji do obsługi czatu utworzonej za pomocą Dialogflow:

Na powyższym diagramie użytkownik wchodzący w interakcję z aplikacją Dialogflow Chat ma następujący przepływ informacji:

1. Użytkownik wysyła wiadomość w Google Chat do aplikacji w Google Chat na czacie lub w pokoju w Google Chat.
2. Wirtualny agent Dialogflow, który znajduje się w Google Cloud, odbiera i przetwarza wiadomość, aby wygenerować odpowiedź.
3. Opcjonalnie za pomocą elementu webhook Dialogflow agent Dialogflow może wchodzić w interakcje z zewnętrznymi usługami innych firm, takimi jak system zarządzania projektami lub narzędzie do obsługi zgłoszeń.
4. Agent Dialogflow wysyła odpowiedź z powrotem do usługi aplikacji do obsługi czatu w Google Chat.
5. Odpowiedź zostanie dostarczona do pokoju czatu.

Konfigurowanie środowiska

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

   Włączanie interfejsów API

2. Sprawdź, czy włączasz interfejsy API w odpowiednim projekcie w chmurze, a potem kliknij Dalej.

3. Sprawdź, czy włączasz odpowiednie interfejsy API, a potem kliknij Włącz.

Tworzenie agenta Dialogflow CX

Agent Dialogflow CX to wirtualny agent, który obsługuje równoczesne rozmowy z użytkownikami. Jest to moduł rozumienia języka naturalnego, który rozumie niuanse ludzkiego języka. Dialogflow tłumaczy tekst użytkownika podczas rozmowy na dane strukturalne, które mogą zrozumieć Twoje aplikacje i usługi. Projektujesz i tworzysz agenta Dialogflow, który będzie obsługiwać rodzaje rozmów wymagane w Twoim systemie.

Agent Dialogflow jest podobny do pracownika centrum obsługi telefonicznej. Trenujesz je w zakresie obsługi oczekiwanych scenariuszy rozmowy, a trenowanie nie musi być zbyt szczegółowe.

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 w chmurze Google Cloud. Aby znaleźć projekt, kliknij Wszystkie, a potem go wyszukaj.

3. Możesz teraz wybrać gotowego agenta lub utworzyć własnego. Jeśli wolisz szczegółowo zapoznać się z dostosowywaniem agentów w późniejszym czasie, wybierz jednego z gotowych agentów, którzy pomogą Ci dowiedzieć się, co mogą robić agenci.

   Aby wybrać gotowego agenta:

   1. Kliknij Use prebuilt agents (Użyj gotowych agentów).

   2. Wybierz gotowego agenta. Na potrzeby tego przewodnika wybierz Podróże: wypożyczalnia samochodów.

      Agenci są oceniani jako początkujący, średnio zaawansowani lub zaawansowani w zależności od liczby funkcji, z których korzystają, oraz od złożoności logiki rozmowy. Wybór agenta na poziomie średniozaawansowanym lub zaawansowanym może wymagać dostosowań i ustawień specyficznych dla agenta, w tym włączenia funkcji i interfejsów API w konsoli Google Cloud.

   3. Kliknij Importuj jako agent.

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

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

   Szczegółowe instrukcje 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żna zmienić jego języka domyślnego.

5. Kliknij Utwórz. Dialogflow CX rozpocznie tworzenie agenta, a następnie wyświetli jego domyślny przepływ początkowy.

6. Opcjonalnie możesz dostosować agenta. Szczegółowe instrukcje dotyczące procesu dostosowywania agenta znajdziesz w artykule Tworzenie agenta Dialogflow CX.

7. Sprawdzoną metodą jest przetestowanie agenta:

   1. Kliknij Przetestuj agenta.
   2. Kliknij Testuj agenta w środowisku.
   3. W sekcji Środowisko wybierz Wersja robocza.
   4. W Flow wybierz Default Start Flow (Domyślny przepływ początkowy).
   5. Na stronie wybierz Strona startowa.
   6. Na pasku tworzenia wiadomości Porozmawiaj z agentem wpisz Hello i naciśnij Enter. Agent odpowiada, przedstawiając się.
   7. Przeprowadź przykładową rozmowę testową, aby ukończyć test.

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

   Otwórz konsolę Dialogflow CX

9. W sekcji Agenci kliknij more_vert > Kopiuj nazwę. Zapisz tę nazwę, ponieważ będzie ona potrzebna podczas konfigurowania aplikacji do obsługi czatu.

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 aplikację do Google Chat:

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

   Otwórz Chat API

2. Kliknij Konfiguracja i skonfiguruj aplikację Google Chat:

   1. W polu Nazwa aplikacji wpisz Dialogflow App.
   2. W polu URL awatara 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 Funkcje wybierz Dołączanie do pokoi i rozmów grupowych.
   5. W sekcji Ustawienia połączenia kliknij Dialogflow.
   6. W sekcji Ustawienia Dialogflow wybierz Dialogflow CX.
   7. W sekcji Agent or Environment resource name (Nazwa zasobu agenta lub środowiska) wklej nazwę agenta Dialogflow CX skopiowaną na końcu sekcji Tworzenie agenta Dialogflow CX.
   8. Udostępnij tę aplikację do obsługi czatu konkretnym osobom i grupom w domenie i wpisz swój adres e-mail.
   9. W sekcji Logi kliknij Loguj błędy w usłudze Logging.

3. Kliknij Zapisz.

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

Testowanie aplikacji Google Chat

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

1. Otwórz Google Chat, używając konta Google Workspace, które zostało podane 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 w Google Chat.

4. Wybierz aplikację Chat z wyników. Otworzy się czat.

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

   Aplikacja do obsługi czatu Dialogflow odpowiada, przedstawiając się.

6. Przeprowadź przykładową rozmowę testową.

Przykładowa rozmowa testowa

Aby przetestować aplikację do czatu Dialogflow CX w konsoli Dialogflow CX lub w Google Chat, przeprowadź poniższą rozmowę. Wyjaśnienie pomaga zrozumieć, jak agent Dialogflow CX interpretuje język naturalny użytkownika i generuje własną odpowiedź w języku naturalnym na każdym etapie rozmowy. Ta przykładowa rozmowa jest oparta na gotowym agencie o nazwie Podróże: wypożyczalnia samochodów.

Wysyłanie wiadomości z kartami z Dialogflow

Dialogflow może odpowiadać za pomocą tekstu lub kart. Aby odpowiedzieć kartą, określ ją jako niestandardowy ładunek w realizacji.

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

{ "hostAppDataAction": { "chatDataAction": { "createMessageAction": {
  "message": { "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"
        }}
      }]}}]}]
    }
  }]}
}}}}

Limity i kwestie do rozważenia

• Podczas korzystania z aplikacji Google Chat z Dialogflow obiekty zdarzeń w Google Chat mają następujące ograniczenia i kwestie, które należy wziąć pod uwagę:
  • Zdarzenia w aplikacji Home: obsługa zdarzeń APP_HOME nie jest jeszcze dostępna.
  • Dane wejściowe zapytania Dialogflow: tekst wysyłany jako dane wejściowe zapytania do agenta Dialogflow zależy od typu zdarzenia:
    • MESSAGE: wartość pola argumentText z wiadomości na czacie.
    • APP_COMMAND: ciąg znaków "APP_COMMAND_PAYLOAD".
    • ADDED_TO_SPACE: ciąg znaków "ADDED_TO_SPACE_PAYLOAD".
    • REMOVED_FROM_SPACE: ciąg znaków "REMOVED_FROM_SPACE_PAYLOAD".
    • CARD_CLICKED: ciąg znaków "BUTTON_CLICKED_PAYLOAD".
    • WIDGET_UPDATED: ciąg znaków "WIDGET_UPDATED_PAYLOAD" (używany do autouzupełniania).
  • Pełny ładunek zdarzenia: pełny ładunek JSON zdarzenia interakcji na czacie jest wysyłany do Dialogflow w polu WebhookRequest.payload. Dostęp do niego uzyskasz w webhooku Dialogflow. Więcej informacji znajdziesz w dokumentacji żądania webhooka Dialogflow CX.
• Uwagi dotyczące odpowiadania na polecenia i otrzymywania danych z kart lub okien:
  • Jeśli agent Dialogflow musi przetworzyć ładunek JSON zdarzenia interakcji na czacie, może to zrobić za pomocą elementu webhook Dialogflow, aby sprawdzić niestandardowy ładunek w parametrze zapytania.
  • Aby wyświetlić okno z agenta Dialogflow, odpowiedz pojedynczym niestandardowym ładunkiem JSON, który zawiera obiekt RenderActions z nawigacją pushCard.
  • Aby przetwarzać dane wprowadzane z kart, możesz użyć webhooka Dialogflow i odpowiadać za pomocą pojedynczego niestandardowego ładunku JSON zawierającego odpowiednią akcję.
• Podglądy linków nie są obsługiwane.
• Jeśli agent Dialogflow odpowie tylko jedną wiadomością, zostanie ona wysłana do Google Chat synchronicznie. Jeśli agent Dialogflow odpowie kilkoma wiadomościami, wszystkie wiadomości zostaną wysłane do Google Chat asynchronicznie przez wywołanie metody create w zasobie spaces.messages w interfejsie Chat API – po jednym wywołaniu dla każdej wiadomości.
• Jeśli używasz integracji Dialogflow CX z Google Chat, agent Dialogflow i aplikacja Google Chat muszą być skonfigurowane w tym samym projekcie w chmurze Google. Jeśli musisz skonfigurować Dialogflow i czat w różnych projektach w chmurze, możesz skonfigurować serwer pośredniczący, aby ułatwić połączenie. Aby dowiedzieć się, jak to zrobić, zapoznaj się z tym przykładem integracji Google Chat z Dialogflow CX w GitHubie.

Rozwiązywanie problemów

Aby debugować aplikację do obsługi czatu, zacznij od sprawdzenia dzienników błędów. Ta aplikacja korzysta z Dialogflow, więc masz do dyspozycji kilka zasobów do logowania i rozwiązywania problemów:

• Dzienniki dodatków do Google Workspace: dzienniki zapytań zawierające szczegółowe informacje o działaniu aplikacji do Google Chat, w tym o jej interakcjach z Google Chat. Zobacz Dzienniki zapytań w Google Workspace Add-ons.

• Błędy aplikacji Google Chat: ogólne komunikaty o błędach aplikacji Chat i sposoby ich rozwiązywania znajdziesz w artykule Rozwiązywanie problemów z błędami aplikacji Chat.

• Cloud Logging w Dialogflow CX: sprawdź, czy w ustawieniach agenta Dialogflow włączono Cloud Logging, aby rejestrować szczegółowe logi wykonania, w tym błędy agenta i interakcje z webhookiem. Dowiedz się, jak włączyć i skonfigurować tę funkcję w dokumentacji ustawień agenta Dialogflow CX. Te logi możesz wyświetlić w Eksploratorze logów w konsoli Google Cloud.

• Historia rozmów w Dialogflow CX: przeglądaj wcześniejsze interakcje, aby zrozumieć przebieg rozmowy i wykryć, gdzie występują problemy. Zobacz Historię rozmów.

• Ogólne rozwiązywanie problemów z Dialogflow: w przypadku bardziej ogólnych problemów z Dialogflow zapoznaj się z przewodnikiem rozwiązywania problemów z Dialogflow CX.

Czyszczenie danych

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

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

   Otwórz Resource Manager

2. Z listy projektów wybierz projekt do usunięcia, a potem kliknij Usuń delete.
3. W oknie wpisz identyfikator projektu i kliknij Wyłącz, aby usunąć projekt.

Powiązane artykuły

• Dialogflow CX wykorzystuje w projektowaniu agentów Dialogflow automat stanowy, co zapewnia jasną i wyraźną kontrolę nad rozmową, lepsze wrażenia użytkowników i lepszy proces tworzenia. Podczas tworzenia aplikacji Dialogflow Chat zalecamy używanie Dialogflow CX.
  • Więcej informacji o tworzeniu i konfigurowaniu agentów znajdziesz w sekcji Agenci Dialogflow CX.
  • Szczegółowe instrukcje tworzenia i konfigurowania agentów znajdziesz w artykule Tworzenie agenta Dialogflow CX.
  • code Ćwiczenie: przykład tworzenia agenta Dialogflow CX z magazynem danych znajdziesz w aplikacji do czatu opartej na wiedzy z ćwiczenia Tworzenie aplikacji do Google Chat przy użyciu Gemini.
  • code Ćwiczenie: przykład tworzenia agenta konwersacyjnego Dialogflow CX znajdziesz w ćwiczeniu Tworzenie aplikacji do Google Chat przy użyciu Gemini.
• Dialogflow ES to kolejny sposób korzystania z Dialogflow w aplikacji do obsługi czatu.

{
  "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"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}