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 przeglądać funkcje rozmowy w Business Messages Bot pomocniczy
  • 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 aplikację Konsola programisty Business Communications.
  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.

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 menu 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. lokalizacji. Ten klucz będzie potrzebny później do wdrożenia aplikacji internetowej oraz interfejsów API Business Messages i Business Communications.

Utwórz markę i agenta

Agent to konwersacyjna reprezentacja marki – podmiotu, który umożliwia prowadzenie rozmowy z którymi użytkownicy wchodzą w interakcje. Tworzysz markę, która reprezentuje Twoją firmę, Utworzyć agenta, aby konsumenci mogli nawiązać z nim konwersację.

  1. Otwórz aplikację Business Communications Developer. Konsola 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 pracownikiem obsługi klienta i przejrzeć 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 aby zapoznać się z możliwościami platformy. Włączanie Asystenta Bot jest opcjonalny, ale zdecydowanie zalecany podczas tworzenia pierwszego agenta.

Bot pomocniczy pozwala:

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

Gdy bot pomocniczy jest włączony, wysyła i odbiera wiadomości w imieniu agenta. webhooka nie jest wymagany. Musisz wyłączyć bota pomocniczego. zanim będzie można skonfigurować webhooka lub włączyć Dialogflow, obsługi wiadomości dla 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. 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 na odpowiednim urządzeniu mobilnym i kliknij Uruchom. Możesz też kliknąć Kopiuj adres URL na Androida lub Kopiuj adres URL z iOS, aby go 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ą Mapy Google app.)

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 aplikację Business Communications Developer. Konsola.
  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 dotyczących z naszym agentem. Teraz możesz skonfigurować agenta do obsługi w procesie tworzenia wiadomości.

Konfigurowanie agenta do obsługi wiadomości

W tym przewodniku wdrożysz bota echo w Google Cloud Platform (GCP) z webhooka przeznaczonego do przetwarzania wiadomości użytkowników.

Bot Echo to przykładowa aplikacja, która powtarza wiadomości do użytkownika. it pozwala eksperymentować z rozbudowanymi funkcjami, takimi jak sugerowane działania oraz karty informacyjne, podczas rozmowy z pracownikiem obsługi klienta. Na początek możesz też użyć bota Echo za opracowanie 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 bot Echo do wstępnie skonfigurowanego webhooka. Jeżeli już masz infrastrukturę internetową, aby możesz wykorzystać do odbierania wiadomości, utwórz nowego webhooka w tej sieci , ale musisz samodzielnie skonfigurować logikę. Zobacz 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 aplikację Selektor projektów 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 wyodrębnij przykładowy bot Echo (Node.js, Java Pythona).

  3. Skopiuj pobrany plik danych logowania JSON Utwórz konto usługi w folderze 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, w którym został przez Ciebie utworzony Utwórz środowisko 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, w którym został przez Ciebie utworzony Utwórz środowisko 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, w którym został przez Ciebie utworzony Utwórz środowisko 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 podaj adres URL webhooka działa), aby uruchomić Odbieranie wiadomości.

  1. Otwórz aplikację Ustawienia konta w konsoli programisty usług komunikacji biznesowej.
  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żone w GCP.

  5. W Konsoli programisty kliknij Zweryfikuj.

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

Aby skonfigurować webhooka za pomocą interfejsu Business Communications API, zapoznaj się z artykułem Przykład: zaktualizuj adres URL webhooka.

Możesz skorzystać z platformy testowej Business Messages. aby sprawdzić, czy webhook odpowiada na ładunki Business Messages.

Wpisz informacje o agencie

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

  1. Otwórz aplikację Business Communications Developer. Konsola.
  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 aplikację Business Communications Developer. Konsola.
  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 Android URL 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ą Mapy Google).

Wita Cię wiadomość powitalna od agenta. Od tego momentu możesz korzystać z bota Echo. Odczytuje wiadomości, które do Ciebie odsyłasz. Dodatkowo możesz: wywoływania funkcji rozszerzonych przez wysyłanie określonych ciągów znaków: „karuzela”, „karta” czy „elementy”.

Dalsze kroki

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