W tym samouczku pokazujemy, jak stworzyć aplikację Google Chat, którą zespół będzie mógł do zarządzania projektami w czasie rzeczywistym. Aplikacja Google Chat używa: Vertex AI, aby pomóc zespołom w pisaniu historii użytkowników (które reprezentują cechy systemu oprogramowania z punktu widzenia użytkownika, który będzie rozwijał zespół) oraz utrzymuje relacje w bazie danych Firestore.
-
Rysunek 1. Karol rozmawia ze swoim zespołem w swoim pokoju czatu. Wspomnij o aplikacji do zarządzania projektami, która zachęca aplikację Google Chat do skorzystania z pomocy. -
Rysunek 2. Karol tworzy historię za pomocą polecenia po ukośniku /createUserStory. -
Rysunek 3. Aplikacja Google Chat do zarządzania projektami tworzy opis historii za pomocą Vertex AI, a następnie udostępnia ją w pokoju. -
Rysunek 4. Karol klika Edytuj, aby dodać szczegóły artykułu. Opis utworzony przez AI jest dokładny, ale Karol chce poznać więcej szczegółów, więc Karol klika Rozwiń, aby usługa Vertex AI dodała odpowiednie wymagania do opisu. Karol przypisuje historię sobie, ustawia stan na „Rozpoczęty”, wybiera odpowiedni priorytet oraz rozmiar, a potem klika Zapisz. -
Rysunek 5. W każdej chwili Karol może wyświetlić wszystkie historie użytkowników zespołu i nimi zarządzać, używając polecenia po ukośniku /manageUserStories.
Wymagania wstępne
- Firmy lub przedsiębiorstwa 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. Do sprawdź, czy masz dostęp, Uprawnienia wymagane do włączenia płatności
Używaj nieuwierzytelnionych wywołań funkcji w Google Cloud Functions, Możesz to sprawdzić, ustalając, czy Twoja firma Google Cloud organizacja korzysta z ograniczonego udostępniania według domeny.
W razie potrzeby poproś administratora Google Cloud o dostęp lub uprawnienia.
jeśli używasz Google Cloud CLI, środowisko Node.js środowisko programistyczne skonfigurowane do pracy z gcloud CLI. Zobacz Konfigurowanie programowania w środowisku Node.js .
Cele
- Tworzenie aplikacji do obsługi czatu, która zarządza oprogramowaniem zwinnym w projektach AI.
- Pomóż użytkownikom w pisaniu historii użytkowników za pomocą generatywnej
Narzędzia do pisania tekstów z Vertex AI wspomagane przez AI:
- Generuj i ponownie wygeneruj opisy artykułów.
- Aby wypełnić wymagania, rozwiń opisy artykułu z notatek.
- Popraw błędy gramatyczne, aby poprawić literówki.
- Dbaj o aktualność swojej pracy, zapisując i odczytując dane w bazie danych Firestore.
- Ułatwianie współpracy w pokoju czatu, umożliwiając użytkownikom tworzyć, edytować, przypisywać i uruchamiać historie bezpośrednio w rozmowie.
Używane usługi
Aplikacja do zarządzania projektami używa tych usług Google Workspace i Usługi Google Cloud:
- Interfejs Chat API: Interfejs API do tworzenia aplikacji w Google Chat, które odbierają i reagują Zdarzenia interakcji z Google Chat, np. wiadomości. Zarządzanie projektami Aplikacja Google Chat korzysta z interfejsu Chat API do odbierania wiadomości i odpowiadania na nie do zdarzeń interakcji wysyłanych przez Google Chat oraz do konfigurowania atrybutów określić, jak ma być widoczna w Google Chat, np. dodać nazwę i awatara;
- Interfejs Vertex AI API: Platforma generatywnej AI. Zarządzanie projektami Aplikacja Google Chat używa interfejsu Vertex AI API do pisania historii użytkownika tytuły i opisy.
- Firestore: Bezserwerowa baza danych dokumentów. Zarządzanie projektami Aplikacja Google Chat korzysta z Firebase do przechowywania danych o artykułach użytkowników.
Cloud Functions: Lekka bezserwerowa usługa obliczeniowa, która umożliwia tworzenie jednozadaniowe, niezależne funkcje, które mogą reagować na Google Chat. zdarzeń interakcji bez konieczności zarządzania serwerem lub środowiskiem wykonawczym. Aplikacja Google Chat do zarządzania projektami używa Cloud Functions do hostować punkt końcowy HTTP, do którego Google Chat wysyła zdarzenia interakcji, platformy obliczeniowej do uruchamiania logiki, która przetwarza te zdarzenia i reaguje na nie.
Cloud Functions wykorzystuje poniższe usługi Google Cloud do tworzenia: przetwarzania zdarzeń interakcji i zasobów obliczeniowych hosta:
- Cloud Build: W pełni zarządzana platforma do ciągłej integracji, dostarczania i wdrażania który uruchamia automatyczne kompilacje.
- Pub/Sub: Asynchroniczna i skalowalna usługa przesyłania wiadomości, która oddziela usługi które tworzą wiadomości z usług przetwarzających te wiadomości.
- Cloud Run Admin API: W pełni zarządzane środowisko do uruchamiania aplikacji skonteneryzowanych.
Architektura
Architektura aplikacji Google Chat do zarządzania projektami odbiera i odbiera przetwarza zdarzenia interakcji z Google Chat w punkcie końcowym HTTP, korzysta z Vertex AI tworzyć historie użytkowników i przechowywać ich szczegóły w bazie danych Firestore. Poniższy schemat przedstawia architekturę Google Workspace Wykorzystane zasoby Google Cloud.
Aplikacja Google Chat do zarządzania projektami działa tak:
Użytkownik wysyła wiadomość w Google Chat i wywołuje metodę aplikację Google Chat do zarządzania projektem, wysyłając wiadomość bezpośrednio, wspomnienie o niej w pokoju lub wpisanie polecenia po ukośniku.
Google Chat wysyła synchroniczne żądanie HTTP do funkcji w Cloud Functions Punkt końcowy HTTP.
Aplikacja Google Chat do zarządzania projektami przetwarza protokół HTTP żądanie:
Vertex AI pomaga pisać lub aktualizować historię użytkownika.
Baza danych Firestore przechowuje, pobiera, aktualizuje i usuwa historię użytkownika i skalowalnych danych.
Cloud Functions zwraca do Google Chat odpowiedź HTTP, która wyświetla ją użytkownikowi w formie komunikatu lub okna.
Przygotowywanie środowiska
W tej sekcji dowiesz się, jak utworzyć i skonfigurować projekt Google Cloud dla platformy aplikacja Google Chat.
Utwórz projekt Google Cloud
Google Cloud Console
- W konsoli Google Cloud otwórz menu . > Administracja Administracja > Utwórz projekt.
-
W polu Project Name (Nazwa projektu) wpisz opisową nazwę projektu.
Opcjonalnie: aby edytować identyfikator projektu, kliknij Edytuj. Identyfikatora projektu nie można zmienić po jego utworzeniu, wybierz więc identyfikator, który odpowiada potrzebom od początku w projektach AI.
- W polu Lokalizacja kliknij Przeglądaj, aby wyświetlić potencjalne lokalizacje dla w projektach AI. Następnie kliknij Wybierz.
- Kliknij Utwórz. Konsola Google Cloud otworzy stronę Panel, a projekt zostanie utworzony. w ciągu kilku minut.
interfejs wiersza poleceń gcloud
W jednym z tych środowisk programistycznych uzyskaj dostęp do Google Cloud Interfejs wiersza poleceń (`gcloud`):
-
Cloud Shell: korzystanie z terminala online za pomocą interfejsu wiersza poleceń gcloud.
już skonfigurowane, aktywuj Cloud Shell.
Aktywuj Cloud Shell -
Local Shell (Powłoka lokalna): aby użyć lokalnego środowiska programistycznego,
instalacja oraz
zainicjuj
w gcloud CLI.
Aby utworzyć projekt Google Cloud, użyj polecenia `gcloud projects create`:
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
Google Cloud Console
- W konsoli Google Cloud otwórz Rozliczenia. Kliknij Menu > Płatności > Moje projekty.
- W sekcji Wybierz organizację wybierz organizację powiązaną z: Twojemu projektowi 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ć listę dostępnych kont rozliczeniowych, 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 Projekt Cloud, dla którego chcesz włączyć płatności.BILLING_ACCOUNT_IDto identyfikator konta rozliczeniowego, z którym chcesz połączyć konto projekt Google Cloud.
Włączanie interfejsów API
Google Cloud Console
W konsoli Google Cloud włącz interfejsy Google Chat API, Vertex AI API Cloud Functions API, Firestore API, Cloud Build API interfejsy Pub/Sub API i Cloud Run Admin API.
Sprawdź, czy interfejsy API są włączone we właściwym Projekt Cloud, a następnie 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 ten, utworzona za pomocą polecenia
gcloud config set project:gcloud config set project PROJECT_IDZastąp PROJECT_ID identyfikatorem projektu utworzony przez Ciebie projekt Cloud.
włączyć interfejsy Google Chat API, Vertex AI API i Cloud Functions API; interfejsy Firestore API, Cloud Build API, Pub/Sub API interfejs Cloud Run Admin API za pomocą polecenia
gcloud services enable:gcloud services enable chat.googleapis.com \ aiplatform.googleapis.com \ cloudfunctions.googleapis.com \ firestore.googleapis.com \ cloudbuild.googleapis.com \ pubsub.googleapis.com \ run.googleapis.comInterfejsy API Cloud Build, Pub/Sub i Cloud Run Admin API są wymagane Cloud Functions.
Uwierzytelnianie i autoryzacja
Aby tak było, nie trzeba konfigurować uwierzytelniania ani autoryzacji aplikacji Google Web Designer.
W tym samouczku do wywoływania interfejsów API Firestore i Vertex AI wykorzystano Domyślne dane uwierzytelniające aplikacji z domyślnym kontem usługi powiązanym z funkcją w Cloud Functions, nie musisz konfigurować. W środowisku produkcyjnym zwykle utwórz oraz załącz konto usługi do funkcji w Cloud Functions.
Tworzenie i wdrażanie aplikacji Google Chat
Po utworzeniu i skonfigurowaniu projektu Google Cloud możesz zacząć i wdrożyć aplikację Google Chat. W tej sekcji: :
- Utwórz bazę danych Firestore, w której będą przechowywane i pobierane historie użytkowników.
- Możesz też przejrzeć przykładowy kod.
- Utwórz funkcję w Cloud Functions, by hostować i uruchamiać Kod aplikacji do obsługi czatu w odpowiedzi na zdarzenia odebrane z Google Chat jako żądania HTTP.
- Tworzenie i wdrażanie aplikacji Google Chat przy użyciu interfejsu Google Chat API stronie konfiguracji.
Tworzenie bazy danych Firestore
W tej sekcji utworzysz bazę danych Firestore, która będzie utrwalana i pobierana
opowieści użytkowników, ale nie definiujesz modelu danych. Ustawiono model danych.
niejawnie w przykładowym kodzie za pomocą funkcji model/user-story.js i model/user.js
.
Baza danych aplikacji Google Chat do zarządzania projektami korzysta z języka NoSQL model danych na podstawie dokumentów zorganizowane w kolekcje. Więcej informacji: Firestore danych model.
Poniższy diagram przedstawia przegląd zarządzania projektem Model danych aplikacji Google Chat:
Zbiór główny to spaces, gdzie każdy dokument reprezentuje pokój, który
Aplikacja do obsługi czatu utworzyła relacje. Każda historia użytkownika jest
reprezentowany przez dokument w podkolekcji userStories, a każdy użytkownik
reprezentowany przez dokument w podkolekcji users.
Wyświetlanie definicji kolekcji, dokumentów i pól
spaces
Pokoje, w których aplikacja Google Chat utworzyła relacje.
| Pola | |
|---|---|
Document ID | StringUnikalny identyfikator konkretnego miejsca, w którym tworzone są historie. Odpowiada nazwie zasobu pokoju w interfejsie Chat API. |
userStories | Subcollection of Documents (Relacje utworzone przez aplikację Google Chat i jej użytkowników. Odpowiada Document ID elementu userStories w Firebase. |
users | Subcollection of Documents (user)Użytkownicy, którzy utworzyli artykuły lub którym przypisano historie. |
displayName | StringWyświetlana nazwa pokoju w interfejsie Chat API. Nie ustawiono do czatów z użytkownikami. |
userStories
Relacje utworzone przez aplikację Google Chat i jej użytkowników.
| Pola | |
|---|---|
Document ID | StringUnikalny identyfikator konkretnej historii użytkownika utworzonej przez aplikację Google Chat i jej użytkowników. |
assignee | Document (user)Nazwa zasobu przypisanego do użytkownika, który ma dokończyć opowieść. Odpowiada to właściwościom Document ID dokumentu users i nazwie zasobu użytkownika w interfejsie Chat API. |
description | StringOpis funkcji oprogramowania z perspektywy użytkownika. |
priority | EnumPilność potrzebna do ukończenia zadania. Możliwe wartości to Low, Medium oraz High. |
size | EnumIlość pracy Możliwe wartości to Small, Medium oraz Large. |
status | EnumEtap pracy. Możliwe wartości to OPEN, STARTED oraz COMPLETED. |
title | StringTytuł historii; krótkie podsumowanie. |
users
Użytkownicy, którzy utworzyli artykuły lub którym przypisano historie.
| Pola | |
|---|---|
Document ID | StringUnikalny identyfikator konkretnego użytkownika. Odpowiada assignee obiektu userStories w Firebase i nazwie zasobu użytkownika w interfejsie Chat API. |
avatarUrl | StringAdres URL hostujący obraz awatara użytkownika w Google Chat. |
displayName | StringWyświetlana nazwa użytkownika w Google Chat |
Aby utworzyć bazę danych Firestore:
Google Cloud Console
W konsoli Google Cloud otwórz Firestore. Kliknij 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 polu Typ lokalizacji określ region bazy danych, na przykład
us-central1Aby uzyskać najlepszą skuteczność, wybierz takie samo lub w pobliżu jako funkcję w Cloud Functions aplikacji Google Chat.
Kliknij Utwórz bazę danych.
interfejs wiersza poleceń gcloud
Utwórz bazę danych Firestore w trybie natywnym z Polecenie
gcloud firestore databases create:gcloud firestore databases create \ --location=LOCATION \ --type=firestore-nativeZastąp LOCATION nazwą Firestore regionu, takie jak jako
us-central1.
Przeglądanie przykładowego kodu
Opcjonalnie przed utworzeniem funkcji w Cloud Functions poświęć chwilę na sprawdzenie zapoznaj się z przykładowym kodem hostowanym na GitHubie.
Oto omówienie poszczególnych plików:
env.js- Zmienne konfiguracji środowiska służące do wdrażania do określonego projektu Google Cloud oraz i regionie. Musisz zaktualizować zmienne konfiguracji w tym pliku.
package.jsonipackage-lock.json- Ustawienia i zależności projektu Node.js
index.js- Punkt wejścia do funkcji w Cloud Functions aplikacji Google Chat. it odczytuje Zdarzenie czatu od użytkownika żądania HTTP, wywołuje moduł obsługi aplikacji i publikuje odpowiedź HTTP jako Obiekt JSON.
controllers/app.js- Główna logika aplikacji. Przetwarza
zdarzeń interakcji za pomocą funkcji
wzmianki i polecenia po ukośniku w aplikacji do obsługi czatu;
Aby odpowiedzieć na kliknięcia karty, wywołuje metodę
app-action-handler.js. controllers/app-action-handler.js- Logika aplikacji do obsługi kliknięć karty Zdarzenia interakcji z Google Chat.
services/space-service.js,services/user-service.jsiservices/user-story-service.js- Te pliki zawierają części funkcji
logikę aplikacji specyficzną
do pracy z pokojami czatu,
treści i historie użytkowników. Funkcje w tych plikach są wywoływane przez
app.jslubapp-action-handler.js. Do wykonywania operacji na bazie danych funkcje w te pliki wywołują funkcje wfirestore-service.js. services/firestore-service.js- Obsługuje operacje na bazie danych.
Funkcje w tym pliku są wywoływane przez
services/space-service.js,services/user-service.jsiservices/user-story-service.js services/aip-service.js- Wywołuje interfejs Vertex AI API na potrzeby tekstu generowanego przez generatywną AI w przypadku prognozy.
model/*.js- Te pliki zawierają definicje klas i wyliczeń, które aplikacja służące do przechowywania i przekazywania danych między funkcjami. Określają one w przypadku bazy danych Firestore.
views/*.js- Każdy plik w tym katalogu tworzy wystąpienie obiekt karty, który Następnie wysyła z powrotem do Google Chat jako: wiadomość z karty lub Odpowiedź działania w oknie dialogowym.
views/widgets/*.js- Każdy plik tworzy instancję
rodzaj widżetu,
używany przez aplikację do tworzenia kart w katalogu
views/. test/**/*.test.js- Każdy plik w tym katalogu i jego podkatalogach zawiera testy jednostkowe
dla odpowiedniej funkcji, kontrolera, usługi, widoku lub widżetu.
Wszystkie testy jednostkowe możesz wykonać, uruchamiając polecenie
npm run testw aplikacji w katalogu głównym projektu.
Tworzenie i wdrażanie funkcji w Cloud Functions
W tej sekcji utworzysz i wdrożysz funkcję w Cloud Functions, która składa się Logika aplikacji do zarządzania projektami aplikacji Google Chat.
Funkcja w Cloud Functions jest uruchamiana w odpowiedzi na żądanie HTTP z Google Chat, które zawiera zdarzenie interakcji. Po uruchomieniu kod funkcji w Cloud Functions przetwarza zdarzenie oraz zwraca odpowiedź na czat, która jest renderowana jako komunikat, okno dialogowe lub inny rodzaj interakcji. W odpowiednich przypadkach usługa Google Cloud Funkcja odczytuje również bazę danych Firestore lub w niej zapisuje.
Aby utworzyć funkcję w Cloud Functions:
Google Cloud Console
Pobierz kod z GitHuba jako plik ZIP.
Rozpakuj pobrany plik ZIP.
Wyodrębniony folder zawiera całe przykłady z Google Workspace z repozytorium.
W wyodrębnionym folderze przejdź do
google-chat-samples-main/node/project-management-app/, a następnie skompresuj z folderuproject-management-appdo pliku ZIP.Katalog główny pliku ZIP musi zawierać: pliki i foldery:
env.jsREADME.mdgcloudignore.textpackage-lock.jsonpackage.jsonindex.jsmodel/controllers/views/services/
W konsoli Google Cloud otwórz stronę Cloud Functions:
Sprawdź, czy projekt Google Cloud powiązany z Twoim kontem Wybrano aplikację do obsługi czatu.
Kliknij Utwórz funkcję.
Na stronie Utwórz funkcję skonfiguruj funkcję:
- W sekcji Środowisko wybierz 2 generacji.
- W polu Nazwa funkcji wpisz
project-management-tutorial. - W polu Region wybierz region.
- W sekcji Authentication (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
projectManagementChatAppW 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 do niego plik ZIP i rozpakowuje pliki komponentu. w tym zasobniku. Cloud Functions następnie skopiuje pliki komponentu do lub funkcji w Cloud Functions.
W pliku ZIP prześlij plik ZIP pobrany z GitHuba. wyodrębnione i ponownie skompresowane:
- Kliknij Przeglądaj.
- Przejdź do pliku ZIP i wybierz go.
- Kliknij Otwórz.
Kliknij Wdróż.
Otworzy się strona Szczegóły funkcji w Cloud Functions, a pojawi się Twoja funkcja. z dwoma wskaźnikami postępu: jednym dla kompilacji i jednym dla usługi. Gdy oba wskaźniki postępu znikają i zastępowane są znacznikiem postępu , oznacza to, że 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 wbudowanym otwórz plik
env.js. - Zastąp project-id identyfikatorem projektu Cloud.
- Opcjonalnie: zaktualizuj us-central1 o obsługiwana lokalizacja dla Twojej funkcji w Cloud Functions.
Kliknij Wdróż.
Po zakończeniu wdrażania funkcji skopiuj adres URL aktywatora:
- Na stronie Szczegóły funkcji kliknij Aktywator.
- Skopiuj adres URL. Jest on potrzebny do skonfigurowania aplikacji do obsługi czatu.
interfejs wiersza poleceń gcloud
Sklonuj kod z GitHuba:
git clone https://github.com/googleworkspace/google-chat-samples.gitPrzełącz się na katalog, który zawiera kod tego projektu aplikacja do zarządzania Google Chat:
cd google-chat-samples/node/project-management-appEdytuj plik
env.js, aby ustawić zmienne środowiskowe:- Zastąp project-id identyfikatorem projektu Google Cloud.
- Zastąp us-central1 lokalizacją projektu Google Cloud.
Wdróż funkcję w Cloud Functions w Google Cloud:
gcloud functions deploy project-management-tutorial \ --gen2 \ --region=REGION \ --runtime=nodejs20 \ --source=. \ --entry-point=projectManagementChatApp \ --trigger-http \ --allow-unauthenticatedZamień REGION na Lokalizacja funkcji w Cloud Functions na której jest hostowana jego infrastruktura, na przykład
us-central1.
- Gdy funkcja zostanie wdrożona, skopiuj właściwość
urlz narzędzia . Jest to adres URL reguły, którego użyjesz w poniższej sekcji, aby skonfigurować aplikację Google Chat.
Konfigurowanie aplikacji Google Chat w konsoli Google Cloud
W tej sekcji dowiesz się, jak skonfigurować interfejs Chat API w w konsoli Google Cloud z informacjami o Twojej aplikacji Google Chat, w tym nazwę aplikacji Google Chat (obsługiwany ukośnik) i adresu URL wyzwalacza aplikacji Google Chat w chmurze Funkcja, do której wysyła zdarzenia interakcji z Google Chat.
W konsoli Google Cloud kliknij Menu. > Więcej produktów > Google Workspace > Biblioteka usług > Interfejs Google Chat API > Zarządzaj > Konfiguracja.
W polu Nazwa aplikacji wpisz
Project Manager.W polu URL awatara wpisz
https://developers.google.com/chat/images/quickstart-app-avatar.png.W polu Opis wpisz
Manages projects with user stories.Kliknij przełącznik Włącz funkcje interaktywne, aby ustawić go w pozycji włączenia.
W sekcji Funkcjonalność wybierz Odbieranie wiadomości 1:1, Dołączanie do pokoi i rozmów grupowych.
W sekcji Ustawienia połączenia wybierz URL aplikacji.
W polu App URL (URL aplikacji) wklej adres URL aktywatora skopiowany z chmury. Wdrożenie funkcji w formacie
https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Jeśli funkcja w Cloud Functions została wdrożona za pomocą gcloud CLI, jest tourlusłudze.Rejestrowanie tagu aplikacji Google Chat polecenia po ukośniku. Aby zarejestrować polecenie po ukośniku:
- W sekcji Polecenia po ukośniku kliknij Dodaj polecenie po ukośniku.
W przypadku każdego polecenia po ukośniku opisanego w poniższej tabeli wypełnij pola Nazwa, Identyfikator polecenia, Opis i zdecyduj, czy polecenie po ukośniku Otwiera okno i kliknij Gotowe:
Nazwa Identyfikator polecenia Opis Otwiera okno /createUserStory1 Utwórz artykuł o określonym tytule. Odznaczono /myUserStories2 Zawiera listę wszystkich artykułów przypisanych użytkownikowi. Odznaczono /userStory3 Wyświetla bieżący stan konkretnego artykułu. Odznaczono /manageUserStories4 Otwiera okno, w którym można edytować artykuły. Wybrano /cleanupUserStories5 Usuwa wszystkie artykuły w pokoju. Odznaczono
W sekcji Widoczność wybierz Udostępnij tę aplikację do obsługi czatu określonym osobom i grupom w domenę Workspace i 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, który oznacza Aplikacja do obsługi czatu to gotowe do testowania.
Testowanie aplikacji Google Chat
Przetestuj aplikację Google Chat do zarządzania projektami, wysyłając do niej wiadomość i używać poleceń po ukośniku do tworzenia, edytowania i usuwania artykułów.
Otwórz Google Chat za pomocą konta Google Workspace, którego używasz dodane podczas dodawania siebie jako zaufanego testera.
- Kliknij Nowy czat.
- W polu Dodaj co najmniej jedną osobę wpisz nazwę swojego aplikacja Google Chat.
Z wyników wybierz aplikację Google Chat. A Direct
- W nowym czacie z aplikacją wpisz
Helloi naciśnijenter. Zarządzanie projektami Aplikacja do obsługi czatu odpowiada, podając menu pomocy ze szczegółowymi informacjami co potrafią. - Aby utworzyć relację, wpisz
/createUserStory Test storyw paska wiadomości i wysłać go. Zarządzanie projektami Aplikacja do obsługi czatu odpowiada, przesyłając wiadomość ze szczegółami historią użytkownika, którą tworzy dla Ciebie za pomocą generatywnej AI z Vertex AI. W konsoli sprawdź bazę danych Firestore, aby przejrzeć utworzone rekordy dotyczące pokoju, w którym został dodany użytkowników, którzy weszli w interakcję z aplikacją, i opowieści użytkownika, którą utworzysz.
Wróć do Google Chat.
- Jeśli chcesz edytować artykuł, kliknij Edytuj. Jeśli jesteś zadowolony/zadowolona z kliknij Zapisz.
- Przetestuj każde polecenie po ukośniku obsługiwane przez aplikację. Aby je zobaczyć, wpisz
/lub wspomnij o aplikacji Google Chat. - Usuń historię użytkownika testowego, wysyłając
/cleanupUserStoriespo ukośniku. Ewentualnie usunąć lub odinstalować aplikację. Gdy aplikacja zostanie usunięta, usunie wszystkie historie użytkowników utworzone w tym pokoju.
Rozwiązywanie problemów
Gdy aplikacja Google Chat lub card zwraca błąd, Interfejs czatu wyświetla komunikat „Coś poszło nie tak”. lub „Nie można przetworzyć żądania”. Czasami interfejs Google Chat nie wyświetla się żaden komunikat o błędzie, ale aplikacja Google Chat lub zwraca nieoczekiwany wynik; na przykład wiadomość w formie karty .
Komunikat o błędzie może nie wyświetlać się w interfejsie Google Chat, opisowe komunikaty o błędach i dane dziennika, które pomogą Ci w naprawianiu błędów gdy logowanie błędów aplikacji Google Chat jest włączone. Aby uzyskać pomoc w wyświetlaniu, debugowania i naprawiania błędów, zapoznaj się z artykułem Rozwiązywanie problemów z błędami w Google Chat
Czyszczenie danych
Aby uniknąć obciążenia konta Google Cloud opłatami za używanych w tym samouczku, zalecamy usunięcie Projekt w chmurze.
- W konsoli Google Cloud otwórz stronę Zarządzanie zasobami. Kliknij Menu > Uprawnienia 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 go usunąć. nad projektem.
Powiązane artykuły
- Odpowiadanie na pytania na podstawie rozmów w Google Chat w aplikacji Gemini AI Chat
- Odpowiadanie na incydenty przy użyciu Google Chat, Vertex AI i Apps Script