Utwórz pierwszego agenta

Wymagania wstępne

Tworzenie agenta

Ten przewodnik pomoże Ci utworzyć agenta przy użyciu przykładowej aplikacji. Ten przykładowy kod pozwala szybko zapoznać się z funkcjami agenta i może służyć za punkt wyjścia do jego opracowania. Jeśli chcesz zmodyfikować istniejącą aplikację, aby zawierała agenta, w przykładzie przedstawiono dobry model logiki aplikacji.

Oto czynności, które musisz wykonać:

  • Zarejestruj się jako partner
  • Tworzenie marki i agenta
  • Opcjonalnie możesz poznać funkcje rozmowy z botem Business Messages
  • Konfigurowanie agenta do wysyłania i odbierania wiadomości

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

Zarejestruj się jako partner

  1. Otwórz Konsolę programisty ds. komunikacji biznesowej.
  2. W sekcji Wiadomości od firm kliknij Utwórz konto partnera.

  3. Wpisz informacje o partnerze:

    Field 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 zarejestrowanym partnerem Business Messages. Utworzono dla Ciebie nowy projekt Google Cloud z włączonymi interfejsami Business Messages i Business Communications API. Nie masz dostępu do tego projektu i nie ma on wpływu na żaden z Twoich istniejących projektów Google Cloud.

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

Tworzenie konta usługi

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

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

    Przeglądarka pobierze klucz konta usługi. Przechowuj je w bezpiecznym miejscu. Będzie on potrzebny później do wdrożenia aplikacji internetowej oraz dostępu do interfejsów Business Messages i Business Communications API w przyszłości.

Tworzenie marki i agenta

Agent to konwersacyjna reprezentacja marki – element rozmowy, z którym użytkownicy wchodzą w interakcję. Tworzysz markę, która będzie reprezentować firmę, i tworzysz agenta, aby konsumenci mogli się z nią komunikować.

  1. Otwórz Konsolę dla deweloperów komunikacji biznesowej i zaloguj się na swoje konto Google w Business Messages.
  2. Kliknij Utwórz agenta.
  3. W polu Typ agenta wybierz Wiadomości od firm.
  4. Wpisz wartości w polach Nazwa marki i Nazwa agenta.
  5. Wykonaj jedną z tych czynności:
    • Aby porozmawiać z pracownikiem obsługi klienta i poznać dostępne funkcje, wybierz 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 rozpocząć rozmowę od razu. W innym przypadku skonfiguruj agenta do obsługi wiadomości.

Odkryj funkcje bota pomocniczego funkcji Business Messages

Bot pomocniczy funkcji Business Messages pozwala szybko rozpocząć rozmowę z agentem, dzięki czemu możesz się zorientować, co oferuje platforma. Włączenie bota pomocniczego jest opcjonalne, ale zalecane podczas tworzenia pierwszego agenta.

Bot pomocniczy pozwala

  • Poznaj zaawansowane funkcje
  • Dowiedz się, jak wdrażać funkcje
  • Znajdowanie zasobów na temat konfigurowania agenta

Po włączeniu bota pomocniczego wysyła on i odbiera wiadomości Twojego agenta; nie jest wymagany webhook. Aby móc skonfigurować webhooka lub włączyć Dialogflow do obsługi wiadomości użytkowników, musisz wyłączyć bota pomocniczego.

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, w którym możesz rozpocząć.

Aby nawiązać połączenie z botem pomocniczym, wykonaj te czynności:

  1. Uzyskaj dostęp do testowych adresów 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 na Androida lub Kopiuj URL na 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

Zanim dostosujesz agenta i przygotujesz go do uruchomienia, musisz wyłączyć bota pomocniczego funkcji Business Messages.

Aby wyłączyć bota pomocniczego,

  1. Otwórz Konsolę programisty ds. komunikacji biznesowej.
  2. Wybierz agenta.
  3. W menu nawigacyjnym po lewej stronie kliknij Integrations (Integracje).
  4. W sekcji bot pomocniczy kliknij Wyłącz.

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

Konfigurowanie agenta do obsługi wiadomości

W tym przewodniku wdrożysz bota Echo w Google Cloud Platform (GCP) z webhookiem zaprojektowanym do przetwarzania wiadomości użytkownika.

Bot Echo to przykładowa aplikacja, która powtarza komunikaty wysyłane do użytkownika. Pozwala eksperymentować z funkcjami multimedialnymi, takimi jak sugerowane działania i karty informacyjne, podczas rozmowy z agentem. Możesz też użyć bota Echo jako punktu wyjścia podczas programowania agenta.

Wykonaj te czynności:

  • Wdrażanie przykładowego bota Echo w GCP
  • Konfigurowanie adresu URL webhooka na koncie partnera Business Messages
  • Podaj podstawowe informacje o agencie

Na końcu tego przewodnika Twój agent będzie gotowy do wysyłania i odbierania wiadomości.

Wdrażanie aplikacji internetowej w GCP

Business Messages przekierowuje 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ą do korzystania z funkcji odbierania wiadomości, możesz utworzyć w tej usłudze nowego webhooka, 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 Google Cloud Console.

    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 nazwą projektu.
    • W polu Lokalizacja kliknij Przeglądaj, aby wyświetlić potencjalne lokalizacje projektu. Jeśli nie możesz znaleźć swojej organizacji w Google Workspace, 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 zasobów 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 istniejące konto rozliczeniowe do projektu. Aby zapoznać się z opcjami płatności, zobacz Bezpłatne funkcje programu Google Cloud.

Wdrażanie przykładowego bota Echo

  1. Zainstaluj interfejs wiersza poleceń gcloud. Za jego pomocą wdrożysz przykładowy kod w Google Cloud.

  2. Pobierz i wyodrębnij przykład bota 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 pobranej próbki.

    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 z próbką.

  5. Aby wdrożyć przykład, 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 sekcji Tworzenie środowiska Cloud. Identyfikator projektu jest podany 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 podany 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 podany w panelu projektu w Google Cloud.

  6. Zwróć uwagę na adres URL wdrożonej aplikacji w danych wyjściowych ostatniego polecenia. To podstawa adresu URL webhooka:

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

Konfigurowanie webhooka

Po wdrożeniu bota Echo musisz podać adres URL webhooka (który obsługujesz), aby móc odbierać wiadomości.

  1. Otwórz Ustawienia konta w konsoli programisty usług komunikacji biznesowej.
  2. Upewnij się, że wybrane jest właściwe konto partnera.
  3. W sekcji URL webhooka w Business Messages kliknij Skonfiguruj.

  4. W polu 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 próby wdrożonej w GCP.

  5. W Konsoli programisty kliknij Zweryfikuj.

    Gdy narzędzie Business Messages zweryfikuje Twojego webhooka, okno dialogowe zostanie zamknięte.

Aby skonfigurować webhooka za pomocą Business Communications API, zobacz Przykład: aktualizowanie webhooka.

Aby sprawdzić, czy webhook odpowiada na ładunki w Business Messages, możesz użyć platformy testowej Business Messages.

Wpisz informacje o agencie

Podaj podstawowe informacje, aby dokończyć konfigurację agenta.

  1. Otwórz Konsolę programisty ds. komunikacji biznesowej.
  2. W panelu nawigacyjnym po lewej stronie kliknij Informacje o agencie.

  3. Zmień wartości lub użyj tych sugestii:

    Field Wartość
    Wiadomość powitalna Witamy w rozmowie Echo Bot.
    Polityka prywatności https://policies.google.com/privacy

  4. Kliknij Zapisz.

Rozpocznij rozmowę

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

  1. Otwórz Konsolę programisty ds. komunikacji biznesowej.
  2. W panelu nawigacyjnym 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 albo kliknij Kopiuj URL na Androida lub Kopiuj URL na 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).

Przywitaj się w firmie. Na tym etapie możesz skorzystać z bota Echo. Umożliwia także odtwarzanie e-maili od Ciebie. Ponadto możesz wywołać funkcje zaawansowane, wysyłając określone ciągi znaków: „karuzela”, „karta”, „elementy”.

Dalsze kroki

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