Utwórz pierwszego agenta

Wymagania wstępne

Tworzenie agenta

Z tego przewodnika dowiesz się, jak utworzyć agenta za pomocą przykładowej aplikacji. Przykładowa aplikacja umożliwia szybkie zapoznanie się z funkcjami agenta i może stanowić punkt początkowy do jego programowania. Jeśli chcesz zmodyfikować istniejącą aplikację, aby uwzględnić agenta, przykładowa aplikacja będzie dobrym modelem logiki aplikacji.

W ramach tego krótkiego wprowadzenia dowiesz się, jak:

  • zarejestrować się jako partner;
  • utworzyć markę i agenta;
  • opcjonalnie: poznać funkcje w rozmowie z botem pomocniczym funkcji Business Messages;
  • skonfigurować agenta do wysyłania i odbierania wiadomości.

Aby utworzyć agenta bez użycia przykładowej aplikacji, przeczytaj artykuł Tworzenie agenta.

Rejestracja jako partner

  1. Otwórz Business Communications Developer Console.
  2. W sekcji Business Messages kliknij Utwórz konto partnera.

  3. Wpisz informacje o partnerze:

    Pole Wartość
    Imię i nazwisko Twoje imię i nazwisko
    Nazwa partnera Nazwa organizacji
    Strona partnera Strona internetowa organizacji
    Region Region, w którym chcesz hostować usługę Business Messages

  4. Przeczytaj i zaakceptuj Warunki korzystania z usługi Business Messages.

  5. Kliknij Utwórz.

Jesteś teraz zarejestrowany(-a) jako partner Business Messages. Utworzyliśmy dla Ciebie nowy projekt w chmurze Google z włączonymi interfejsami Business Messages API i Business Communications API. Nie masz dostępu do tego projektu i nie będzie on kolidować z żadnym z Twoich dotychczasowych projektów Google Cloud.

Masz teraz dostęp do Business Messages API i Business Communications API.

Tworzenie konta usługi

  1. Na stronie głównej Business Communications Developer Console kliknij Ustawienia konta partnera.
  2. W menu po lewej stronie kliknij Konto usługi.

  3. Kliknij Utwórz klucz, a potem Utwórz.

    Przeglądarka pobierze klucz konta usługi. Przechowuj go w bezpiecznym miejscu. Ten klucz będzie Ci później potrzebny do wdrożenia aplikacji internetowej i uzyskania dostępu do Business Messages API i Business Communications API.

Tworzenie marki i agenta

Agent to konwersacyjna reprezentacja marki – podmiot, z którym użytkownicy wchodzą w interakcje. Markę tworzysz, aby reprezentować firmę, a agenta – aby umożliwić klientom kontakt z nią za pomocą rozmowy.

  1. Otwórz Business Communications Developer Console i zaloguj się na konto Google Business Messages.
  2. Kliknij Utwórz agenta.
  3. W polu Typ agenta wybierz Business Messages.
  4. Wpisz wartości w polach Nazwa marki i Nazwa agenta.
  5. Wykonaj jedną z tych czynności:
    • Aby przetestować rozmowę z agentem i poznać dostępne funkcje, kliknij Włącz bota pomocniczego funkcji Business Messages.
    • Aby dostosować agenta i przygotować go do obsługi wiadomości, odznacz pole Włącz bota pomocniczego funkcji Business Messages.
  6. Kliknij Utwórz agenta.

Jeśli włączysz bota pomocniczego funkcji Business Messages, możesz od razu rozpocząć rozmowę. W przeciwnym razie, przejdź do konfiguracji agenta do obsługi wiadomości.

Poznawanie funkcji za pomocą bota pomocniczego funkcji Business Messages

Bot pomocniczy funkcji Business Messages pozwala szybko rozpocząć rozmowę z agentem, dzięki czemu możesz zapoznać się z możliwościami platformy. Włączenie bota pomocniczego jest opcjonalne, ale zdecydowanie zalecane podczas tworzenia pierwszego agenta.

Bot pomocniczy umożliwia:

  • poznawanie zaawansowanych funkcji;
  • dowiedzenie się, jak wdrożyć funkcje;
  • znalezienie materiałów dotyczących konfiguracji agenta.

Gdy bot pomocniczy jest włączony, wysyła i odbiera wiadomości agenta. Webhook nie jest wymagany. Aby ustawić webhooka lub włączyć Dialogflow do obsługi wiadomości użytkowników, musisz najpierw wyłączyć bota pomocniczego.

Rozpoczynanie rozmowy z botem pomocniczym

Gdy włączysz bota pomocniczego funkcji Business Messages, możesz rozpocząć rozmowę. Po utworzeniu agenta od razu otworzy się okno, które pomoże Ci zacząć.

Aby wejść w interakcję z botem pomocniczym, wykonaj te czynności:

  1. Otwórz testowe adresy URL agenta. Możesz to zrobić na kilka sposobów:

    • Kliknij przycisk Android lub iOS. Następnie zeskanuj kod QR odpowiednim urządzeniem mobilnym i kliknij Uruchom. Możesz też kliknąć Kopiuj adres URL Androida lub Kopiuj adres URL iOS, aby skopiować testowy adres URL agenta.
    • Kliknij Wyślij , aby wysłać adresy URL na swój adres e-mail.

  2. Otwórz adres URL na urządzeniu mobilnym. (Na urządzeniach z iOS wymagana jest aplikacja Mapy Google ).

Wyłączanie bota pomocniczego

Aby dostosować agenta i przygotować go do uruchomienia, musisz najpierw wyłączyć bota pomocniczego funkcji Business Messages.

Aby wyłączyć bota pomocniczego:

  1. Otwórz Business Communications Developer Console.
  2. Wybierz agenta.
  3. W menu po lewej stronie kliknij Integracje.
  4. W sekcji Bot pomocniczy kliknij Wyłącz.

Gdy bot pomocniczy jest wyłączony, nie wysyła ani nie odbiera wiadomości agenta. Możesz teraz skonfigurować agenta do obsługi przepływu wiadomości.

Konfigurowanie agenta do obsługi wiadomości

W tym przewodniku wdrożysz bota Echo w Google Cloud Platform (GCP) za pomocą webhooka zaprojektowanego do przetwarzania wiadomości użytkowników.

Bot Echo to przykładowa aplikacja, która odsyła wiadomości do użytkownika. Umożliwia ona testowanie zaawansowanych funkcji, takich jak sugerowane działania i karty rozszerzone, w rozmowie z agentem. Możesz też użyć bota Echo jako punktu wyjścia do tworzenia agenta.

Wykonaj te czynności:

  • Wdróż przykładową aplikację bota Echo w GCP.
  • Skonfiguruj adres URL webhooka na koncie partnera Business Messages.
  • Podaj podstawowe informacje o agencie.

Po wykonaniu tych czynności agent będzie gotowy do wysyłania i odbierania wiadomości.

Wdrażanie aplikacji internetowej w GCP

Business Messages przekazuje wiadomości od użytkowników do webhooka w Twojej infrastrukturze. W tym przewodniku wdrożysz przykładowy kod źródłowy bota Echo w wstępnie skonfigurowanym webhooku. Jeśli masz już infrastrukturę internetową, której możesz użyć do odbierania wiadomości, możesz utworzyć nowy webhook w tej usłudze internetowej, ale musisz samodzielnie skonfigurować logikę. Więcej informacji znajdziesz w artykule Ustawianie webhooka na poziomie partnera.

Tworzenie środowiska w chmurze

Aby wdrożyć przykładową aplikację bota Echo, potrzebujesz środowiska w chmurze.

Aby utworzyć projekt GCP jako środowisko w chmurze:

  1. Otwórz selektor projektu w konsoli Google Cloud.

    Jeśli nigdy nie utworzyłeś(-aś) projektu Google Cloud, musisz zaakceptować warunki korzystania z usługi.

  2. Kliknij Utwórz projekt.

  3. Wpisz nazwę i lokalizację nowego projektu.

    • Identyfikator projektu jest generowany automatycznie i wyświetla się pod nazwą projektu.
    • W polu Lokalizacja kliknij Przeglądaj, aby wyświetlić potencjalne lokalizacje projektu. Jeśli nie możesz znaleźć swojej organizacji Google Workspace, oznacza to, że nie jesteś zalogowany(-a) na konto Google Workspace. Możesz utworzyć projekt bez organizacji, ale niektóre funkcje będą ograniczone. Więcej informacji znajdziesz w artykule Korzyści z zasobu organizacji.

  4. Kliknij Utwórz.

  5. Kliknij Menu.

  6. Kliknij Płatności.

  7. Kliknij Połącz konto rozliczeniowe.

  8. Utwórz nowe konto rozliczeniowe lub dodaj do projektu istniejące konto rozliczeniowe. Aby poznać opcje płatności, przeczytaj artykuł Funkcje programu bezpłatnego korzystania z Google Cloud.

Wdrażanie przykładowej aplikacji bota Echo

  1. Zainstaluj gcloud CLI. Użyjesz go do wdrożenia przykładowego kodu w Google Cloud.

  2. Pobierz i rozpakuj przykładową aplikację bota Echo (Node.js, Java, Python).

  3. Skopiuj plik JSON z danymi logowania pobrany w sekcji Tworzenie konta usługi do folderu zasobów przykładowej aplikacji i zmień nazwę danych logowania na „bm-agent-service-account-credentials.json”. Ścieżka do tego pliku z danymi logowania zależy od pobranej przykładowej aplikacji.

    Node.js

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

    Java

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

    Python

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

  4. W terminalu przejdź do katalogu full_sample przykładowej aplikacji.

  5. Aby wdrożyć przykładową aplikację, uruchom w terminalu te polecenia:

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID to identyfikator projektu utworzonego w Tworzenie środowiska w chmurze. Identyfikator projektu znajdziesz na panelu projektu w Google Cloud.

    Java

    gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy

    PROJECT_ID to identyfikator projektu utworzonego w Tworzenie środowiska w chmurze. Identyfikator projektu znajdziesz na panelu projektu w Google Cloud.

    Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID to identyfikator projektu utworzonego w Tworzenie środowiska w chmurze. Identyfikator projektu znajdziesz na panelu projektu w Google Cloud.

  6. Zanotuj adres URL wdrożonej aplikacji w danych wyjściowych ostatniego polecenia. To jest podstawa adresu URL webhooka:

    Deployed service [default] to [https://PROJECT_ID.appspot.com]

Ustawianie webhooka

Gdy bot Echo zostanie wdrożony, musisz określić adres URL webhooka (którym zarządzasz), aby zacząć odbierać wiadomości.

  1. Otwórz ustawienia konta w Business Communications Developer Console.
  2. Upewnij się, że wybrane jest właściwe konto partnera.
  3. W sekcji Adres URL webhooka Business Messages kliknij Skonfiguruj.

  4. W polu Adres URL punktu końcowego webhooka wpisz adres URL aplikacji + „/callback”.

    Punkt końcowy będzie miał format: "https://PROJECT_ID.appspot.com/callback".

    Ten punkt końcowy jest wstępnie zdefiniowany w logice aplikacji przykładowej aplikacji wdrożonej w GCP.

  5. W Developer Console kliknij Zweryfikuj.

    Gdy Business Messages zweryfikuje webhooka, okno się zamknie.

Aby skonfigurować webhooka za pomocą Business Communications API, przeczytaj artykuł Przykład: aktualizowanie adresu URL webhooka.

Za pomocą platformy testowej Business Messages możesz sprawdzić, czy webhook prawidłowo odpowiada na ładunki Business Messages.

Wpisywanie informacji o agencie

Aby dokończyć konfigurację agenta, podaj podstawowe informacje.

  1. Otwórz Business Communications Developer Console.
  2. W menu po lewej stronie kliknij Informacje o agencie.

  3. Zaktualizuj wartości w dowolny sposób lub skorzystaj z tych sugestii:

    Pole Wartość
    Wiadomość powitalna Witamy w rozmowie z botem Echo!
    Polityka prywatności https://policies.google.com/privacy

  4. Kliknij Zapisz.

Zacznij rozmowę

Aby wejść w interakcję z botem Echo:

  1. Otwórz Business Communications Developer Console.
  2. W menu po lewej stronie kliknij Informacje o agencie.
  3. W sekcji Testowe adresy URL agenta kliknij przycisk Android lub iOS.

  4. Zeskanuj kod QR odpowiednim urządzeniem mobilnym lub kliknij Kopiuj adres URL Androida albo Kopiuj adres URL iOS, aby skopiować testowy adres URL agenta.

    Możesz też kliknąć Wyślij , aby wysłać adresy URL na swój adres e-mail.

  5. Otwórz adres URL na urządzeniu mobilnym. (Na urządzeniach z iOS wymagana jest aplikacja Mapy Google).

Wyświetli się wiadomość powitalna agenta. W tym momencie możesz wejść w interakcję z botem Echo. Bot Echo odsyła do Ciebie wysyłane przez Ciebie wiadomości. Możesz też wywołać zaawansowane funkcje, wysyłając określone ciągi znaków: „carousel”, „card”, „chips”.

Dalsze kroki

Teraz, gdy masz już pierwszego agenta, dowiedz się więcej o Business Messages i o tym, co jeszcze możesz zrobić na platformie.