Z tego samouczka dowiesz się, jak utworzyć aplikację Google Chat, która odpowiada na pytania na podstawie rozmów w pokojach czatu z użyciem generatywnej AI, która korzysta z Vertex AI, i Gemini. Aplikacja Google Chat używa interfejsu Google Workspace Events API oraz Pub/Sub do rozpoznawania i odpowiadania w czasie rzeczywistym na pytania publikowane w pokojach czatu, nawet jeśli nie są one wymienione.
Aplikacja Google Chat wykorzystuje wszystkie wiadomości wysyłane w pokoju jako źródło danych i bazę wiedzy: gdy ktoś zadaje pytanie, aplikacja Google Chat sprawdza, czy odpowiedzi udzieliły wcześniej odpowiedzi, i je udostępnia. Jeśli nie można znaleźć odpowiedzi, informuje, że nie może udzielić odpowiedzi. Przy każdej odpowiedzi użytkownicy mogą kliknąć przycisk polecenia akcesorium, aby dodać @wzmiankę o menedżerze pokoju i poprosić o odpowiedź. Dzięki wykorzystaniu Gemini AI aplikacja Google Chat dostosowuje się i poszerza swoją bazę wiedzy w miarę jak stale trenuje na rozmowach w pokojach, do których jest dodawana.
Oto jak aplikacja Google Chat działa w obszarze wprowadzania i wsparcia pracowników:
-
Rysunek 1. Karol dodaje aplikację Google Chat Asystenta wiedzy AI do pokoju czatu. -
Rysunek 2. Daria pyta, czy firma oferuje szkolenia z wymowy publicznie. -
Rysunek 3. Aplikacja Google Chat – asystent wiedzy AI na podstawie historii rozmów w pokoju czatu prosi Vertex AI o udzielenie odpowiedzi na pytanie, a następnie udostępnia odpowiedź.
Wymagania wstępne
Konto Google Workspace z dostępem do Google Chat.
Dostęp do usług Google Cloud pozwalający:
- Utwórz projekt Google Cloud.
- Połącz konto rozliczeniowe Google Cloud z projektem Cloud. Aby dowiedzieć się, czy masz dostęp, zapoznaj się z artykułem o uprawnieniach wymaganych do włączenia płatności.
- Używaj nieuwierzytelnionych wywołań funkcji w Google Cloud Functions, które możesz sprawdzić, określając, czy Twoja organizacja w Google Cloud korzysta z udostępniania ograniczonego dostępu do domeny.
W razie potrzeby poproś administratora Google Cloud o dostęp lub uprawnienia.
jeśli używasz Google Cloud CLI, musisz mieć środowisko programistyczne Node.js skonfigurowane do współpracy z gcloud CLI. Zapoznaj się z artykułem na temat konfigurowania środowiska programistycznego Node.js.
Cele
- Stwórz aplikację do obsługi czatu, która wykorzystuje generatywną AI do odpowiadania na pytania na podstawie wiedzy przekazanej podczas rozmów w pokoju czatu.
- Dzięki generatywnej AI:
- Wykrywaj pytania pracowników i odpowiadaj na nie.
- Możesz stale uczyć się na podstawie trwających rozmów w pokoju czatu.
- Nasłuchuj wiadomości i odpowiadaj na nie w czasie rzeczywistym w pokoju czatu, nawet jeśli aplikacja Google Chat nie wysyła wiadomości bezpośrednio.
- Utrwalanie wiadomości przez zapisywanie i odczytywanie danych w bazie danych Firestore.
- Ułatwianie współpracy w pokoju czatu przez wspominanie o menedżerach pokoju, gdy nie ma odpowiedzi na pytanie.
Architektura
Poniższy diagram przedstawia architekturę zasobów Google Workspace i Google Cloud używanych przez aplikację Asystenta wiedzy AI Google Chat.
Aplikacja Google Chat Asystent wiedzy o AI działa tak:
Użytkownik dodaje do pokoju czatu aplikację Asystenta wiedzy o AI:
Aplikacja Google Chat prosi użytkownika, który dodał ją do pokoju czatu, o skonfigurowanie uwierzytelniania i autoryzacji.
Aplikacja Google Chat pobiera wiadomości z pokoju, wywołując metodę
spaces.messages.listw interfejsie Chat API, a następnie zapisuje pobrane wiadomości w bazie danych Firestore.Aplikacja Google Chat wywołuje metodę
subscriptions.createw interfejsie Google Workspace Events API, aby rozpocząć nasłuchiwanie zdarzeń takich jak wiadomości w pokoju. Punkt końcowy powiadomień subskrypcji to temat Pub/Sub, który używa Eventarc, aby przekazać zdarzenie do aplikacji Google Chat.Aplikacja Google Chat publikuje wprowadzenie w pokoju.
Użytkownik w pokoju czatu opublikuje wiadomość:
Aplikacja Google Chat odbiera wiadomość w czasie rzeczywistym z tematu Pub/Sub.
Aplikacja Google Chat doda wiadomość do bazy danych Firestore.
Jeśli użytkownik później zmodyfikuje lub usunie wiadomość, aplikacja Google Chat odbierze zaktualizowane lub usunięte zdarzenie w czasie rzeczywistym, a następnie zaktualizuje lub usunie wiadomość w bazie danych Firestore.
Aplikacja Google Chat wysyła wiadomość do Vertex AI za pomocą Gemini:
Poleca on Vertex AI w Gemini, aby sprawdził, czy wiadomość zawiera pytanie. Jeśli tak, Gemini odpowie na pytanie na podstawie historii wiadomości z pokoju czatu przechowywanej w Firestore, a aplikacja Google Chat wyśle wiadomość do pokoju czatu. Jeśli nie, nie odpowiadaj.
Jeśli Vertex AI z Gemini odpowie na pytanie, aplikacja Google Chat opublikuje odpowiedź, wywołując metodę
spaces.messages.createw interfejsie Chat API z użyciem uwierzytelniania aplikacji.Jeśli Vertex AI z Gemini nie odpowie na to pytanie, aplikacja Google Chat wyśle komunikat z informacją, że nie może znaleźć odpowiedzi na to pytanie w historii pokoju czatu.
Wiadomości zawsze zawierają przycisk polecenia akcesorium, który użytkownicy mogą kliknąć, co powoduje, że aplikacja Google Chat dodaje w aplikacji Google Chat @wzmiankę o menedżerze pokoju, który prosi o odpowiedź.
Aplikacja Google Chat otrzyma z interfejsu Google Workspace Events API powiadomienie dotyczące cyklu życia informujące, że subskrypcja pokoju czatu wkrótce wygaśnie:
- Aplikacja Google Chat wysyła prośbę o odnowienie subskrypcji, wywołując metodę
subscriptions.patchw interfejsie Google Workspace Events API.
- Aplikacja Google Chat wysyła prośbę o odnowienie subskrypcji, wywołując metodę
Aplikacja Google Chat zostanie usunięta z pokoju czatu:
Aplikacja Google Chat usuwa subskrypcję, wywołując metodę
subscriptions.deletew interfejsie Google Workspace Events API.Aplikacja Google Chat usunie dane pokoju czatu z Firestore.
Przeglądanie usług używanych przez aplikację Google Chat Asystent wiedzy o AI
Aplikacja Google Chat Asystent wiedzy o AI korzysta z tych usług Google Workspace i Google Cloud:
- Vertex AI API z Gemini: platforma generatywnej AI oparta na technologii Gemini. Asystent wiedzy o AI Aplikacja Google Chat używa interfejsu Vertex AI API z Gemini do rozpoznawania, rozumienia i odpowiadania na pytania pracowników.
-
Chat API: interfejs API do tworzenia aplikacji w Google Chat, które odbierają zdarzenia interakcji z Google Chat (np. wiadomości) i odpowiadają na nie. Aplikacja Google Chat Asystent wiedzy o AI używa interfejsu Chat API do:
- Otrzymywać zdarzenia interakcji wysyłane przez Google Chat i odpowiadać na nie.
- Wyświetlanie listy wiadomości wysłanych w pokoju.
- Publikowanie odpowiedzi na pytania użytkowników w pokoju.
- Skonfiguruj atrybuty określające sposób wyświetlania informacji w Google Chat, takie jak nazwa i obraz awatara.
- Google Workspace Events API: ten interfejs API pozwala subskrybować wydarzenia i zarządzać powiadomieniami o zmianach w aplikacjach Google Workspace. Aplikacja Google Chat – asystent wiedzy na temat AI korzysta z interfejsu Google Workspace Events API do nasłuchiwania wiadomości publikowanych w pokoju czatu, dzięki czemu będzie w stanie wykrywać pytania i odpowiadać na nie, nawet jeśli się o nich nie mowa.
- Firestore: bezserwerowa baza danych dokumentów. Aplikacja Google Chat asystenta wiedzy AI używa Firestore do przechowywania danych o wiadomościach wysyłanych w pokoju czatu.
- Pub/Sub: Pub/Sub to asynchroniczna i skalowalna usługa do przesyłania wiadomości, która oddziela usługi tworzące wiadomości z usług przetwarzających te wiadomości. Aplikacja Google Chat Asystent wiedzy o AI używa Pub/Sub do odbierania zdarzeń subskrypcji z pokoi czatu.
- Eventarc: umożliwia tworzenie architektur opartych na zdarzeniach bez konieczności wdrażania, dostosowywania czy utrzymywania bazowej infrastruktury. Aplikacja Google Chat asystenta wiedzy AI używa Eventarc, aby kierować zdarzenia z Pub/Sub do pokoju czatu i funkcji w Cloud Functions, która odbiera i przetwarza zdarzenia subskrypcji.
-
Cloud Functions: lekka, bezserwerowa usługa obliczeniowa, która umożliwia tworzenie samodzielnych funkcji o jednym przeznaczeniu, które mogą reagować na interakcje z Google Chat i zdarzenia subskrypcji bez konieczności zarządzania serwerem lub środowiskiem wykonawczym. Aplikacja Google Chat Asystent wiedzy o AI korzysta z 2 funkcji w Cloud Functions o nazwach:
-
app: hostuj punkt końcowy HTTP, do którego Google Chat wysyła zdarzenia interakcji, i jako platformę obliczeniową, aby uruchamiać logikę przetwarzania tych zdarzeń i reagowania na nie. -
eventsApp: odbiera i przetwarza zdarzenia z pokoju czatu, takie jak wiadomości z subskrypcji Pub/Sub.
- Cloud Build: w pełni zarządzana platforma do ciągłej integracji, dostarczania i wdrażania, na której uruchamiane są automatyczne kompilacje.
- Cloud Run: w pełni zarządzane środowisko do uruchamiania aplikacji skonteneryzowanych.
-
Przygotowywanie środowiska
W tej sekcji dowiesz się, jak utworzyć i skonfigurować projekt Google Cloud na potrzeby aplikacji Google Chat.
Utwórz projekt Google Cloud
Konsola Google Cloud
- W konsoli Google Cloud otwórz Menu > Administracja > Utwórz projekt.
-
W polu Project Name (Nazwa projektu) wpisz opisową nazwę projektu.
Opcjonalnie: aby edytować identyfikator projektu, kliknij Edytuj. Po utworzeniu projektu identyfikatora nie można zmienić, dlatego wybierz taki identyfikator, który spełnia Twoje potrzeby przez cały okres użytkowania projektu.
- W polu Lokalizacja kliknij Przeglądaj, aby wyświetlić potencjalne lokalizacje dla Twojego projektu. Następnie kliknij Wybierz.
- Kliknij Utwórz. Konsola Google Cloud otworzy stronę panelu, a Twój projekt zostanie utworzony w ciągu kilku minut.
interfejs wiersza poleceń gcloud
W jednym z tych środowisk programistycznych uzyskaj dostęp do interfejsu wiersza poleceń Google Cloud (`gcloud`):
-
Cloud Shell: aby używać terminala online ze skonfigurowanym już interfejsem wiersza poleceń gcloud, aktywuj Cloud Shell.
Aktywuj Cloud Shell -
Powłoka lokalna: aby używać lokalnego środowiska programistycznego, zainstaluj i initialize interfejs wiersza poleceń gcloud.
Aby utworzyć projekt Google Cloud, użyj polecenia `gcloud projects create`command:
Zastąp PROJECT_ID, ustawiając identyfikator projektu, który chcesz utworzyć.gcloud projects create PROJECT_ID
Włącz płatności za projekt Cloud
Konsola Google Cloud
- W konsoli Google Cloud otwórz Rozliczenia. Kliknij Menu > Płatności > Moje projekty.
- W sekcji Wybierz organizację wybierz organizację powiązaną z Twoim projektem Google Cloud.
- W wierszu projektu otwórz menu Działania (), kliknij Zmień ustawienia płatności i wybierz konto rozliczeniowe Cloud.
- Kliknij Ustaw konto.
interfejs wiersza poleceń gcloud
- Aby wyświetlić dostępne konta rozliczeniowe, uruchom polecenie:
gcloud billing accounts list - Połącz konto rozliczeniowe z projektem Google Cloud:
gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_IDZastąp następujące elementy:
PROJECT_IDto identyfikator projektu dla projektu Cloud, w którym chcesz włączyć płatności.BILLING_ACCOUNT_IDto identyfikator konta rozliczeniowego, które ma być połączone z projektem Google Cloud.
Włączanie interfejsów API
Konsola Google Cloud
W konsoli Google Cloud włącz interfejsy Google Chat API, Vertex AI API, Cloud Functions API, Firestore API, Cloud Build API, Pub/Sub API, Google Workspace Events API, Eventarc API i Cloud Run Admin API.
Sprawdź, czy interfejsy API są włączone we właściwym projekcie Cloud, a potem kliknij Dalej.
Sprawdź, czy włączasz odpowiednie interfejsy API, a następnie kliknij Włącz.
interfejs wiersza poleceń gcloud
W razie potrzeby ustaw bieżący projekt Cloud na utworzony przez siebie:
gcloud config set project PROJECT_IDZastąp PROJECT_ID identyfikatorem utworzonego projektu Cloud.
Włącz interfejsy Google Chat API, Vertex AI API, Cloud Functions API, Firestore API, Cloud Build API, Pub/Sub API, Google Workspace Events API, Eventarc API i Cloud Run Admin API:
gcloud services enable chat.googleapis.com \ aiplatform.googleapis.com \ cloudfunctions.googleapis.com \ firestore.googleapis.com \ cloudbuild.googleapis.com \ pubsub.googleapis.com \ workspaceevents.googleapis.com \ eventarc.googleapis.com \ run.googleapis.com
Konfigurowanie uwierzytelniania i autoryzacji
Uwierzytelnianie i autoryzacja umożliwia aplikacji Google Chat dostęp do zasobów w Google Workspace i Google Cloud.
W tym samouczku aplikację Google Chat opublikujesz wewnętrznie, więc można też używać informacji zastępczych. Zanim opublikujesz aplikację Google Chat na zewnątrz, zastąp dane obiektu zastępczego prawdziwymi informacjami wyświetlanymi na ekranie zgody.
Skonfiguruj ekran zgody OAuth, określ zakresy i zarejestruj aplikację
W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Ekran zgody OAuth.
W sekcji Typ użytkownika wybierz Wewnętrzny i kliknij Utwórz.
W polu Nazwa aplikacji wpisz
AI knowledge assistant.W sekcji Adres e-mail zespołu pomocy dla użytkowników wybierz swój adres e-mail lub odpowiednią grupę dyskusyjną Google.
W sekcji Dane kontaktowe dewelopera wpisz swój adres e-mail.
Kliknij Save and Continue.
Kliknij Dodaj lub usuń zakresy. Pojawi się panel z listą zakresów dla każdego interfejsu API włączonego w projekcie Cloud.
W sekcji Dodaj zakresy ręcznie wklej ten zakres:
https://www.googleapis.com/auth/chat.messages
Kliknij Dodaj do tabeli.
Kliknij Aktualizuj.
Kliknij Save and Continue.
Przejrzyj podsumowanie rejestracji aplikacji i kliknij Powrót do panelu.
Utwórz dane uwierzytelniające identyfikatora klienta OAuth
W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Dane logowania.
Kliknij Utwórz dane logowania > Identyfikator klienta OAuth.
Kliknij Typ aplikacji > Aplikacja internetowa.
W polu Nazwa wpisz nazwę danych logowania. Ta nazwa jest widoczna tylko w konsoli Google Cloud.
W sekcji Autoryzowane identyfikatory URI przekierowania kliknij Dodaj URI.
W identyfikatorach URI 1 wpisz:
https://REGION-PROJECT_ID.cloudfunctions.net/app/oauth2Zastąp następujące elementy:
- REGION: region funkcji w Cloud Functions, np.
us-central1. Później, podczas tworzenia tych 2 funkcji w Cloud Functions, musisz ustawić ich region na tę wartość. - PROJECT_ID: identyfikator utworzonego projektu Cloud.
- REGION: region funkcji w Cloud Functions, np.
Kliknij Utwórz.
W oknie Utworzono klienta OAuth kliknij Pobierz plik JSON.
Zapisz pobrany plik jako
client_secrets.json. Później, gdy utworzysz 2 funkcje w Cloud Functions, do każdego wdrożenia dołączysz plikclient_secrets.json.Kliknij OK.
Tworzenie tematu Pub/Sub
Temat Pub/Sub współpracuje z interfejsem Google Workspace Events API, aby subskrybować zdarzenia w pokoju czatu, np. wiadomości, i powiadamiać aplikację Google Chat w czasie rzeczywistym.
Aby utworzyć temat Pub/Sub:
Konsola Google Cloud
W konsoli Google Cloud otwórz Menu > Pub/Sub.
Kliknij Utwórz temat.
W polu Identyfikator tematu wpisz
events-api.Odznacz Dodaj subskrypcję domyślną.
W sekcji Szyfrowanie wybierz Klucz szyfrowania zarządzany przez Google.
Kliknij Utwórz. Pojawi się temat Pub/Sub.
Aby ten temat Pub/Sub działał razem z interfejsem Google Workspace Events API, przyznaj użytkownikowi uprawnień Google Chat uprawnienia do publikowania w temacie Pub/Sub:
W panelu events-api w sekcji UPRAWNIENIA kliknij Dodaj podmiot zabezpieczeń.
W sekcji Dodaj podmioty zabezpieczeń w polu Nowe podmioty zabezpieczeń wpisz
chat-api-push@system.gserviceaccount.com.W sekcji Przypisywanie ról w sekcji Wybierz rolę kliknij Pub/Sub > Pub/Sub Publisher.
Kliknij Zapisz.
interfejs wiersza poleceń gcloud
Utwórz temat Pub/Sub o identyfikatorze tematu
events-api:gcloud pubsub topics create events-apiPrzyznaj użytkownikowi uprawnień Google Chat uprawnienia do publikowania w temacie Pub/Sub:
gcloud pubsub topics add-iam-policy-binding events-api \ --member='serviceAccount:chat-api-push@system.gserviceaccount.com' \ --role='roles/pubsub.publisher'
Tworzenie bazy danych Firestore
Baza danych Firestore zachowuje zgodność z zasadami
i pobiera dane z pokoi czatu, np. wiadomości. Nie definiujesz modelu danych, który jest ustawiany domyślnie w przykładowym kodzie przez pliki model/message.js i services/firestore-service.js.
Baza danych aplikacji Google Chat Asystent wiedzy o AI wykorzystuje model danych NoSQL oparty na dokumentach podzielonych na kolekcje. Więcej informacji znajdziesz w artykule na temat modelu danych Firestore.
Poniższy diagram przedstawia przegląd modelu danych aplikacji Google Chat Asystenta wiedzy o AI:
Poziom główny zawiera 2 kolekcje:
spaces, gdzie każdy dokument reprezentuje pokój czatu, do którego została dodana aplikacja Google Chat. Każda wiadomość jest reprezentowana przez dokument w podkolekcjimessages.users, gdzie każdy dokument reprezentuje użytkownika, który dodał aplikację Google Chat do pokoju czatu.
Wyświetlanie definicji kolekcji, dokumentów i pól
spaces
Pokój czatu zawierający aplikację Google Chat Asystent wiedzy o AI.
| Pola | |
|---|---|
Document ID | StringUnikalny identyfikator określonej przestrzeni. Część nazwy zasobu pokoju w interfejsie Chat API. |
messages | Subcollection of Documents (Wiadomości wysłane w pokoju czatu. Odpowiada Document ID elementu message w Firebase. |
spaceName | StringUnikalna nazwa pokoju w interfejsie Chat API. Odpowiada nazwie zasobu pokoju w interfejsie Chat API. |
messages
Wiadomości wysłane w pokoju czatu.
| Pola | |
|---|---|
Document ID | StringUnikalny identyfikator konkretnej wiadomości. |
name | StringUnikalna nazwa wiadomości w interfejsie Chat API. Odpowiada nazwie zasobu wiadomości w interfejsie Chat API. |
text | StringTreść wiadomości. |
time | String (Timestamp format)Czas utworzenia wiadomości. |
users
Użytkownicy, którzy dodali aplikację Google Chat Asystent wiedzy o AI do pokoju czatu.
| Pola | |
|---|---|
Document ID | StringUnikalny identyfikator konkretnego użytkownika. |
accessToken | StringToken dostępu przyznany podczas autoryzacji użytkownika OAuth 2.0 używany do wywoływania interfejsów Google Workspace API. |
refreshToken | StringToken odświeżania przyznany podczas autoryzacji użytkownika OAuth 2.0. |
Aby utworzyć bazę danych Firestore:
Konsola Google Cloud
W konsoli Google Cloud otwórz Menu > Firestore.
Kliknij Utwórz bazę danych.
W sekcji Wybierz tryb Firestore kliknij Tryb natywny.
Kliknij Dalej.
Skonfiguruj bazę danych:
W polu Nazwij bazę danych pozostaw Identyfikator bazy danych jako
(default).W sekcji Typ lokalizacji wybierz Region.
W polu Region określ region bazy danych, na przykład
us-central1. Aby uzyskać najlepsze wyniki, wybierz tę samą lub pobliskie lokalizację co funkcje aplikacji Google Chat w Cloud Functions.
Kliknij Utwórz bazę danych.
interfejs wiersza poleceń gcloud
Utwórz bazę danych Firestore w trybie natywnym:
gcloud firestore databases create \ --location=LOCATION \ --type=firestore-nativeZastąp LOCATION nazwą regionu Firestore, np.
us-central1. Aby uzyskać najlepsze wyniki, wybierz tę samą lub pobliskie miejsce co funkcje aplikacji Google Chat w Cloud Functions.
Tworzenie i wdrażanie aplikacji Google Chat
Po utworzeniu i skonfigurowaniu projektu Google Cloud możesz skompilować i wdrożyć aplikację Google Chat. W tej sekcji:
- Utwórz i wdróż 2 funkcje w Cloud Functions. Jeden do reagowania na zdarzenia interakcji z Google Chat, a drugi do reagowania na zdarzenia Pub/Sub.
- Utwórz i wdróż aplikację Google Chat na stronie konfiguracji interfejsu Google Chat API.
Tworzenie i wdrażanie funkcji w Cloud Functions
W tej sekcji utworzysz i wdrożysz 2 funkcje w Cloud Functions o nazwie:
app: hostuje i uruchamia kod aplikacji Google Chat, który odpowiada na zdarzenia otrzymywane z Google Chat jako żądania HTTP.eventsApp: odbiera i przetwarza zdarzenia w pokoju czatu, takie jak wiadomości z Pub/Sub.
Łącznie te funkcje w Cloud Functions tworzą logikę aplikacji Asystenta wiedzy o AI aplikacji Google Chat.
Opcjonalnie przed utworzeniem funkcji w Cloud Functions poświęć chwilę na przejrzenie i zapoznanie się przykładowym kodem hostowanym na GitHubie.
Utwórz i wdróż app
Konsola Google Cloud
Pobierz kod z GitHuba jako plik ZIP.
Rozpakuj pobrany plik ZIP.
Wyodrębniony folder zawiera całe repozytorium przykładów Google Workspace.
W wyodrębnionym folderze przejdź do katalogu
google-chat-samples-main/node/ai-knowledge-assistant.W katalogu
google-chat-samples/node/ai-knowledge-assistantdodaj plikclient_secrets.jsonpobrany podczas tworzenia danych uwierzytelniających z identyfikatorem klienta OAuth na potrzeby uwierzytelniania i autoryzacji.Skompresuj zawartość folderu
ai-knowledge-assistantdo pliku ZIP.Katalog główny pliku ZIP musi zawierać te pliki i foldery:
.gcloudignore.gitignoreREADME.mddeploy.shenv.jsevents_index.jshttp_index.jsindex.jsclient_secrets.jsonpackage-lock.jsonpackage.jsoncontrollers/model/services/test/
W konsoli Google Cloud otwórz Menu > Cloud Functions.
Upewnij się, że wybrany jest projekt Google Cloud aplikacji Google Chat.
Kliknij Utwórz funkcję.
Na stronie Utwórz funkcję skonfiguruj funkcję:
- W sekcji Środowisko wybierz 2 generacji.
- W polu Nazwa funkcji wpisz
app. - W polu Region wybierz region, np.
us-central1. Ten region musi być zgodny z regionem ustawionym w autoryzowanym identyfikatorze URI przekierowania podczas tworzenia danych uwierzytelniających identyfikatora klienta OAuth na potrzeby uwierzytelniania i autoryzacji. - W sekcji Typ reguły kliknij HTTPS.
- W sekcji Uwierzytelnianie wybierz Zezwalaj na nieuwierzytelnione wywołania.
- Kliknij Dalej.
W sekcji Środowisko wykonawcze wybierz Node.js 20.
W polu Punkt wejścia usuń tekst domyślny i wpisz
app.W sekcji Kod źródłowy wybierz Przesyłanie ZIP.
W sekcji Zasobnik docelowy utwórz lub wybierz zasobnik:
- Kliknij Przeglądaj.
- Wybierz zasobnik.
- Kliknij Wybierz.
Google Cloud przesyła plik ZIP do tego zasobnika i rozpakowuje pliki komponentu. a następnie skopiuje pliki komponentu do funkcji w Cloud Functions.
W pliku ZIP prześlij plik ZIP pobrany z GitHuba, wyodrębniony i ponownie skompresowany:
- Kliknij Przeglądaj.
- Przejdź do pliku ZIP i wybierz go.
- Kliknij Otwórz.
Kliknij Wdróż.
Otworzy się strona Szczegóły funkcji w Cloud Functions, na której pojawi się Twoja funkcja z 2 wskaźnikami postępu: 1 dla kompilacji i 1 dla usługi. Gdy oba wskaźniki postępu znikają i zastępujesz znacznikiem wyboru, funkcja jest wdrożona i gotowa.
Zmień przykładowy kod, by ustawić stałe:
- Na stronie Szczegóły funkcji w Cloud Functions kliknij Edytuj.
- Kliknij Dalej.
- W sekcji Kod źródłowy wybierz Wbudowany edytor.
- W edytorze bezpośrednim otwórz i zmodyfikuj plik
env.js:- Ustaw wartość project na identyfikator projektu Cloud.
- Ustaw wartość location na region funkcji w Cloud Functions, np.
us-central1.
Kliknij Wdróż.
interfejs wiersza poleceń gcloud
Sklonuj kod z GitHuba:
git clone https://github.com/googleworkspace/google-chat-samples.gitPrzejdź do katalogu z kodem tej aplikacji Google Chat Asystent wiedzy AI:
cd google-chat-samples/node/ai-knowledge-assistantW katalogu
google-chat-samples/node/ai-knowledge-assistantdodaj plikclient_secrets.jsonpobrany podczas tworzenia danych uwierzytelniających z identyfikatorem klienta OAuth na potrzeby uwierzytelniania i autoryzacji.Edytuj plik
env.js, aby ustawić zmienne środowiskowe:- Ustaw wartość project na identyfikator projektu Cloud.
- Ustaw wartość location na region funkcji w Cloud Functions, np.
us-central1.
Wdróż funkcję w Cloud Functions w Google Cloud:
gcloud functions deploy app \ --gen2 \ --region=REGION \ --runtime=nodejs20 \ --source=. \ --entry-point=app \ --trigger-http \ --allow-unauthenticatedZastąp REGION wartością regionu funkcji w Cloud Functions, aby pasowała do regionu ustawionego w pliku
env.js, np.us-central1.
Utwórz i wdróż eventsApp
Konsola Google Cloud
W konsoli Google Cloud otwórz Menu > Cloud Functions.
Upewnij się, że wybrany jest projekt Google Cloud aplikacji Google Chat.
Kliknij Utwórz funkcję.
Na stronie Utwórz funkcję skonfiguruj funkcję:
- W sekcji Środowisko wybierz 2 generacji.
- W polu Nazwa funkcji wpisz
eventsApp. - W polu Region wybierz region, np.
us-central1. Ten region musi być zgodny z regionem ustawionym w autoryzowanym identyfikatorze URI przekierowania podczas tworzenia danych uwierzytelniających identyfikatora klienta OAuth na potrzeby uwierzytelniania i autoryzacji. - W polu Typ aktywatora wybierz Cloud Pub/Sub.
- W sekcji Temat Cloud Pub/Sub wybierz nazwę utworzonego tematu Pub/Sub w formacie
projects/PROJECT/topics/events-api, gdzie PROJECT to identyfikator Twojego projektu Cloud. - Jeśli pojawi się komunikat rozpoczynający się do
Service account(s) might not have enough permissions to deploy the function with the selected trigger., kliknij Przyznaj wszystkie. - Kliknij Dalej.
W sekcji Środowisko wykonawcze wybierz Node.js 20.
W polu Punkt wejścia usuń tekst domyślny i wpisz
eventsApp.W sekcji Source code (Kod źródłowy) wybierz Zip from Cloud Storage.
W sekcji Lokalizacja w Cloud Storage kliknij Przeglądaj.
Wybierz zasobnik, do którego został przesłany plik ZIP podczas tworzenia funkcji
appw Cloud Functions.Kliknij przesłany plik ZIP.
Kliknij Wybierz.
Kliknij Wdróż.
Otworzy się strona Szczegóły funkcji w Cloud Functions. Wyświetli się Twoja funkcja z 3 wskaźnikami postępu: jeden dla kompilacji, jeden dla usługi i jeden dla aktywatora. Gdy wszystkie 3 wskaźniki postępu znikają i zastępowane są znacznikiem wyboru, funkcja jest wdrożona i gotowa.
Zmień przykładowy kod, by ustawić stałe:
- Na stronie Szczegóły funkcji w Cloud Functions kliknij Edytuj.
- Kliknij Dalej.
- W sekcji Kod źródłowy wybierz Wbudowany edytor.
- W edytorze bezpośrednim otwórz i zmodyfikuj plik
env.js:- Ustaw wartość project na identyfikator projektu Cloud.
- Ustaw wartość location na region funkcji w Cloud Functions, na przykład
us-central1.
Kliknij Wdróż.
interfejs wiersza poleceń gcloud
W interfejsie wiersza poleceń gcloud przejdź do katalogu zawierającego kod tej aplikacji Google Chat Asystenta wiedzy o AI sklonowanej wcześniej z GitHuba:
cd google-chat-samples/node/ai-knowledge-assistantW katalogu
google-chat-samples/node/ai-knowledge-assistantdodaj plikclient_secrets.jsonpobrany podczas tworzenia danych uwierzytelniających z identyfikatorem klienta OAuth na potrzeby uwierzytelniania i autoryzacji.Edytuj plik
env.js, aby ustawić zmienne środowiskowe:- Ustaw wartość project na identyfikator projektu Cloud.
- Ustaw wartość location na region funkcji w Cloud Functions, np.
us-central1.
Wdróż funkcję w Cloud Functions w Google Cloud:
gcloud functions deploy eventsApp \ --gen2 \ --region=REGION \ --runtime=nodejs20 \ --source=. \ --entry-point=eventsApp \ --trigger-topic=events-apiZastąp REGION wartością regionu funkcji w Cloud Functions, aby pasowała do regionu ustawionego w pliku
env.js, np.us-central1.
Skopiuj URL aktywatora funkcji app w Cloud Functions
Adres URL aktywatora funkcji app w Cloud Functions wklejasz w następnej sekcji podczas konfigurowania aplikacji Google Chat w konsoli Google Cloud.
Konsola Google Cloud
W konsoli Google Cloud otwórz Menu > Cloud Functions.
W kolumnie Nazwa na liście funkcji w Cloud Functions kliknij
app.Kliknij Reguła.
Skopiuj URL.
interfejs wiersza poleceń gcloud
Opisz funkcję
appw Cloud Functions:gcloud functions describe appSkopiuj właściwość
url.
Konfigurowanie aplikacji Google Chat w konsoli Google Cloud
Z tej sekcji dowiesz się, jak skonfigurować interfejs Chat API w konsoli Google Cloud przy użyciu informacji o aplikacji Google Chat, w tym jej nazwy i adresu URL aktywatora funkcji w Cloud Functions, do której wysyła zdarzenia interakcji z Google Chat.
W konsoli Google Cloud kliknij Menu > Więcej usług > Google Workspace > Biblioteka usług > Google Chat API > Zarządzaj > Konfiguracja.
W polu Nazwa aplikacji wpisz
AI knowledge assistant.W polu URL awatara wpisz
https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/live_help/default/24px.svg.W polu Opis wpisz
Answers questions with AI.Kliknij przełącznik Włącz funkcje interaktywne, aby ustawić go w pozycji włączenia.
W sekcji Funkcjonalność wybierz Dołączanie do pokoi i rozmów grupowych.
W sekcji Ustawienia połączenia wybierz URL aplikacji.
W polu URL aplikacji wklej adres URL aktywatora z funkcji
appw Cloud Functions w formaciehttps://REGION-PROJECT_ID.cloudfunctions.net/app, gdzie REGION to region funkcji w Cloud Functions, np.us-central1to identyfikator projektu utworzonego przez Ciebie projektu Cloud.PROJECT_IDW sekcji Widoczność wybierz Udostępnij tę aplikację do obsługi czatu określonym osobom i grupom w domenie Workspace, a następnie wpisz swój adres e-mail.
Opcjonalnie w sekcji Logi wybierz Rejestruj błędy w usłudze Logging.
Kliknij Zapisz. Pojawi się komunikat o zapisanej konfiguracji, co oznacza, że aplikacja Google Chat jest gotowa do testowania.
Testowanie aplikacji Google Chat
Testuj aplikację Google Chat Asystenta wiedzy o AI w pokoju czatu z wiadomościami, zadając pytania, na które może odpowiedzieć aplikacja Google Chat Asystent wiedzy o AI.
Oto kilka sposobów przetestowania aplikacji Asystent wiedzy o AI Google Chat:
- Dodaj aplikację Google Chat Asystent wiedzy o AI do istniejącego pokoju czatu i zadawaj pytania związane z tym pokojem.
- Utwórz pokój czatu i opublikuj kilka wiadomości, aby wykorzystać je jako źródło danych. Wiadomości można pobierać z Gemini za pomocą promptów, takich jak
Answer 20 common onboarding questions employees ask their teams.. Możesz też wkleić kilka akapitów z przewodnika programowanie z omówieniem Google Chat, a potem zadać pytania na ten temat.
W tym samouczku utworzysz pokój czatu i wkleimy kilka akapitów z przewodnika Programowanie z Google Chat z omówieniem.
Otwórz Google Chat.
Tworzenie pokoju czatu:
Kliknij Nowy czat > Utwórz pokój.
W polu Nazwa pokoju wpisz
Testing AI knowledge assistant app.W sekcji Do czego służy ten pokój? wybierz Współpraca.
W sekcji Ustawienia dostępu wybierz, kto może uzyskiwać dostęp do pokoju.
Kliknij Utwórz.
Dodaj wiadomości, które będą używane jako źródło danych:
W przeglądarce otwórz przewodnik Programowanie z Google Chat – omówienie.
Skopiuj treść przewodnika i wklej ją do utworzonego pokoju czatu.
Dodaj aplikację Google Chat Asystent wiedzy o AI:
Na pasku tworzenia wiadomości wpisz
@AI knowledge assistant. W wyświetlonym menu sugestii wybierz aplikację Asystent wiedzy o AI i naciśnijenter.Pojawi się komunikat z pytaniem, czy chcesz dodać do pokoju aplikację Asystent wiedzy o AI. Kliknij Dodaj do pokoju.
Jeśli dodajesz aplikację Google Chat do pokoju po raz pierwszy, musisz skonfigurować dla niej uwierzytelnianie i autoryzację:
- Kliknij Konfiguruj.
- Otworzy się nowe okno lub nowa karta przeglądarki z prośbą o wybranie konta Google. Wybierz konto, na którym przeprowadzasz test.
- Przejrzyj uprawnienia, o które prosi asystent wiedzy AI. Aby je przyznać, kliknij Zezwól.
- Pojawi się komunikat
You may close this page now.. Zamknij okno lub kartę przeglądarki i wróć do pokoju czatu.
Zadaj pytanie:
Na pasku tworzenia wiadomości wpisz pytanie, np.
What are Google Chat apps?Asystent wiedzy o AI odpowiada aplikacji Google Chat.
Opcjonalnie, jeśli odpowiedź jest niedokładna lub wystarczająca, aby pomóc w ulepszeniu historii rozmowy AI, kliknij Uzyskaj pomoc. Aplikacja Google Chat „Asystent wiedzy o AI” wspomina o menedżerze pokoju i prosi go o udzielenie odpowiedzi na pytanie. Następnym razem aplikacja Asystent wiedzy o AI z Google Chat zna odpowiedź.
Uwagi, alternatywna architektura i kolejne kroki
W tej sekcji omawiamy inne sposoby tworzenia aplikacji Asystent wiedzy o AI.
Firestore, Cloud Storage lub możliwość wywoływania wiadomości z listy w interfejsie Chat API
W tym samouczku zalecamy przechowywanie danych pokoju czatu, takich jak wiadomości, w bazie danych Firestore, ponieważ zwiększa to wydajność w porównaniu z wywoływaniem metody list w zasobie Message za pomocą interfejsu Chat API za każdym razem, gdy aplikacja Google Chat odpowie na pytanie. Powtarzające się wywoływanie funkcji list messages może też spowodować osiągnięcie przez aplikację Google Chat limitów związanych z interfejsem API.
Jeśli jednak historia rozmów w pokoju czatu stanie się zbyt długa, korzystanie z Firestore może być kosztowne.
Cloud Storage jest alternatywą dla Firestore. Każdy pokój, w którym działa aplikacja Google Chat asystenta wiedzy o AI, otrzymuje własny obiekt, a każdy obiekt to plik tekstowy zawierający wszystkie wiadomości w danym pokoju. Zaletą tego podejścia jest to, że pełną zawartość pliku tekstowego można przesłać do Vertex AI za pomocą Gemini. Wadą jest jednak to, że aktualizacja historii rozmowy wymaga więcej pracy, ponieważ nie można dołączyć do obiektu w Cloud Storage. W tym celu trzeba jedynie go zastąpić. To rozwiązanie nie ma sensu, jeśli regularnie aktualizujesz historię wiadomości, ale warto aktualizować historię wiadomości zbiorczo co jakiś czas, na przykład raz w tygodniu.
Rozwiązywanie problemów
Gdy aplikacja lub karta w Google Chat zwróci błąd, w interfejsie Google Chat pojawi się komunikat „Coś poszło nie tak”. lub „Nie można przetworzyć żądania”. Czasami w UI Google Chat nie wyświetla się żaden komunikat o błędzie, ale aplikacja lub karta Google Chat zwraca nieoczekiwany wynik, na przykład wiadomość na karcie.
Mimo że komunikat o błędzie może nie być wyświetlany w interfejsie Google Chat, dostępne są opisowe komunikaty o błędach i dane logów, które pomogą Ci w naprawianiu błędów, gdy logowanie błędów w aplikacjach Google Chat jest włączone. Informacje o wyświetlaniu, debugowaniu i naprawianiu błędów znajdziesz w artykule Rozwiązywanie problemów z błędami w Google Chat.
Czyszczenie danych
Aby uniknąć obciążenia konta Google Cloud opłatami za zasoby zużyte w tym samouczku, zalecamy usunięcie projektu Cloud.
- W konsoli Google Cloud otwórz stronę Zarządzanie zasobami. Kliknij Menu > Administracja > Zarządzaj zasobami.
- Na liście projektów wybierz projekt do usunięcia, a następnie kliknij Usuń .
- W oknie wpisz identyfikator projektu i kliknij Wyłącz, aby usunąć projekt.
Powiązane artykuły
- Zarządzanie projektami za pomocą Google Chat, Vertex AI i Firestore
- Odpowiadanie na incydenty przy użyciu Google Chat, Vertex AI i Apps Script