Utwórz pierwszego agenta

Wymagania wstępne

Utwórz agenta

Z tego przewodnika dowiesz się, jak utworzyć agenta za pomocą przykładowej aplikacji. Przykład to szybki sposób na poznanie funkcji agenta i może służyć jako punkt wyjścia do opracowania agenta. Jeśli chcesz zmodyfikować istniejącą aplikację, aby uwzględnić agenta, skorzystaj z przykładu, który oferuje dobry model logiki Twojej aplikacji.

W tym krótkim wprowadzeniu:

  • Rejestrowanie się jako partner
  • Utwórz markę i agenta
  • Opcjonalnie możesz poznawać funkcje rozmowy z botem pomocniczym funkcji Business Messages
  • Skonfiguruj agenta, aby wysyłać i odbierać wiadomości

Aby utworzyć agenta bez korzystania z przykładu, przeczytaj artykuł Tworzenie agenta.

Rejestrowanie się jako partner

  1. Otwórz konsolę programisty usług komunikacji biznesowej.
  2. W sekcji Business Messages kliknij Utwórz konto partnera.

  3. Wpisz informacje o partnerze:

    Pole Wartość
    Twoje 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.

Zarejestrowaliśmy Cię jako partnera Business Messages. Utworzyliśmy dla Ciebie nowy projekt Google Cloud z włączonymi interfejsami Business Messages i Business Communications API. Nie masz dostępu do tego projektu, więc nie będzie on zakłócać żadnego z Twoich istniejących projektów Google Cloud.

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

Tworzenie konta usługi

  1. Na stronie głównej konsoli programisty Business Communications kliknij Ustawienia konta partnera.
  2. W obszarze nawigacyjnym po lewej stronie kliknij Konto usługi.

  3. Kliknij kolejno Utwórz klucz i Utwórz.

    Przeglądarka pobiera klucz konta usługi. Przechowuj go w bezpiecznym miejscu. Ten klucz będzie potrzebny później do wdrożenia aplikacji internetowej oraz do korzystania z interfejsów Business Messages i interfejsów Business Communications API w przyszłości.

Utwórz markę i agenta

Agent to konwersacyjna reprezentacja marki, czyli elementu, z którym użytkownicy wchodzą w interakcję. Tworzysz markę, aby reprezentować firmę, oraz agenta, który umożliwi klientom konwersację.

  1. Otwórz konsolę dewelopera Business Communications i zaloguj się na konto Google Business Messages.
  2. Kliknij Utwórz agenta.
  3. W polu Typ agenta wybierz Wiadomości do firm.
  4. Wpisz wartości w polach Nazwa marki i Nazwa agenta.
  5. Wykonaj jedną z tych czynności:
    • Aby porozmawiać z agentem i zapoznać się z dostępnymi funkcjami, wybierz Włącz bota pomocniczego funkcji Business Messages.
    • Aby dostosować agenta i przygotować go do obsługi wiadomości, odznacz Włącz bota pomocniczego funkcji Business Messages.
  6. Kliknij Utwórz agenta.

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

Poznaj funkcje dostępne dla bota pomocniczego funkcji Business Messages

Bot pomocniczy funkcji Business Messages pozwala szybko rozpocząć rozmowę z pracownikiem obsługi klienta, 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 pozwala:

  • Poznaj zaawansowane funkcje
  • Dowiedz się, jak wdrażać funkcje
  • Znajdź zasoby dotyczące konfiguracji agenta

Po włączeniu bota pomocniczego wysyła i odbiera wiadomości w imieniu agenta. Nie jest wymagany żaden webhook. Musisz wyłączyć bota pomocniczego, zanim skonfigurujesz webhooka lub włączysz Dialogflow do obsługi wiadomości użytkowników.

Rozpoczynanie rozmowy z botem pomocniczym

Po włączeniu bota pomocniczego funkcji Business Messages możesz rozpocząć rozmowę. Bezpośrednio po utworzeniu agenta otworzy się okno, które ułatwi Ci rozpoczęcie pracy.

Aby móc korzystać z bota pomocniczego, wykonaj te czynności w tym oknie:

  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. (Urządzenia z iOS wymagają aplikacji Mapy Google).

Wyłącz bota pomocniczego

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

Aby wyłączyć bota pomocniczego:

  1. Otwórz konsolę programisty związaną z komunikacją biznesową.
  2. Wybierz agenta.
  3. W menu po lewej stronie kliknij Integrations (Integracje).
  4. Obok bota pomocniczego kliknij Wyłącz.

Gdy bot pomocniczy jest wyłączony, nie wysyła ani nie odbiera wiadomości w imieniu agenta. Teraz możesz skonfigurować agenta do obsługi przesyłania wiadomości.

Konfigurowanie agenta do obsługi wiadomości

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

Bot Echo to przykładowa aplikacja, która powtarza wiadomości do użytkownika. Dzięki niej możesz eksperymentować z rozbudowanymi funkcjami, takimi jak sugerowane działania i karty informacyjne, podczas rozmowy z pracownikiem obsługi klienta. Bota echo możesz też użyć jako punktu wyjścia przy tworzeniu agenta.

Wykonaj te czynności:

  • Wdróż przykładowy bot echo w GCP
  • Skonfiguruj adres URL webhooka na koncie partnera Business Messages
  • Podaj podstawowe informacje o agencie

Po zakończeniu tego przewodnika Twój 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 we wstępnie skonfigurowanym webhooku. Jeśli masz już infrastrukturę internetową, która obsługuje odbieranie wiadomości, możesz utworzyć nowego webhooka w tej usłudze, ale musisz samodzielnie skonfigurować tę logikę. Więcej informacji znajdziesz w artykule Konfigurowanie webhooka na poziomie partnera.

Tworzenie środowiska Cloud

Do wdrożenia przykładowego bota Echo potrzebujesz środowiska w chmurze.

Aby utworzyć projekt GCP jako środowisko w chmurze, wykonaj te czynności:

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

    Jeśli nie masz jeszcze utworzonego 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 jego nazwą.
    • W polu Lokalizacja kliknij Przeglądaj, aby wyświetlić potencjalne lokalizacje dla Twojego projektu. Jeśli nie możesz znaleźć swojej organizacji Google Workspace, oznacza to, że nie korzystasz z konta Google Workspace. Możesz utworzyć projekt bez organizacji, ale niektóre funkcje są ograniczone. Więcej informacji znajdziesz w artykule Zalety 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. Zapoznaj się z bezpłatnymi funkcjami programu Google Cloud, aby dowiedzieć się więcej o dostępnych opcjach płatności.

Wdrażanie przykładowego bota Echo

  1. Zainstaluj interfejs wiersza poleceń gcloud. Użyjesz go do wdrożenia przykładowego kodu w Google Cloud.

  2. Pobierz i rozpakuj przykładowy bot Echo (Node.js, Java, Python).

  3. Skopiuj plik danych logowania JSON pobrany w sekcji Utwórz konto usługi do folderu zasobów przykładu i zmień nazwę danych logowania na „bm-agent-service-account-credentials.json”. Ścieżka do tego pliku danych logowania zależy od pobranego przykładu.

    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” próbki.

  5. Aby wdrożyć przykład, uruchom te polecenia w terminalu:

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID to identyfikator projektu utworzonego w sekcji Tworzenie środowiska Cloud. Identyfikator projektu jest wymieniony w 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 sekcji Tworzenie środowiska Cloud. Identyfikator projektu jest wymieniony w 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 sekcji Tworzenie środowiska Cloud. Identyfikator projektu jest wymieniony w panelu projektu w Google Cloud.

  6. Zapisz 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]

Skonfiguruj webhooka

Po wdrożeniu bota Echo musisz podać adres URL webhooka (czyli używanego), aby zacząć odbierać wiadomości.

  1. Otwórz Ustawienia konta w konsoli programisty Business Communications.
  2. Sprawdź, czy wybrane jest właściwe konto partnera.
  3. W polu Adres URL webhooka funkcji Business Messages kliknij Skonfiguruj.

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

    Punkt końcowy ma format: „https://PROJECT_ID.appspot.com/callback”.

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

  5. W Konsoli programisty kliknij Zweryfikuj.

    Gdy Business Messages zweryfikuje webhooka, okno zostanie zamknięte.

Informacje o konfigurowaniu webhooka za pomocą interfejsu Business Communications API znajdziesz w sekcji Przykład: Aktualizowanie adresu URL webhooka.

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

Wpisz informacje o agencie

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

  1. Otwórz konsolę programisty związaną z komunikacją biznesową.
  2. W menu po lewej stronie kliknij Informacje o agencie.

  3. Możesz zmienić wartości w dowolny sposób lub skorzystać z tych sugestii:

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

  4. Kliknij Zapisz.

Rozpocznij rozmowę

Aby korzystać z bota Echo, wykonaj te czynności:

  1. Otwórz konsolę programisty związaną z komunikacją biznesową.
  2. W menu po lewej stronie kliknij Informacje o agencie.
  3. W sekcji Testowe adresy URL agentów kliknij przycisk Android lub iOS.

  4. Zeskanuj kod QR za pomocą odpowiedniego urządzenia mobilnego lub kliknij Kopiuj adres URL Androida lub 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. (Urządzenia z iOS wymagają aplikacji Mapy Google).

Wita Cię wiadomość powitalna od agenta. Na tym etapie możesz wchodzić w interakcję z botem Echo. Odczytuje wiadomości, które do Ciebie odsyłasz. Możesz też wywoływać funkcje rozszerzone, wysyłając określone ciągi znaków: „karuzela”, „karta”, „elementy”.

Dalsze kroki

Po utworzeniu pierwszego agenta dowiedz się więcej o Business Messages i o tym, co jeszcze możesz zrobić na platformie.