Zarządzanie projektami w Google Chat, Vertex AI i Firestore

W tym samouczku pokazujemy, jak utworzyć aplikację Google Chat, której zespół może używać do zarządzania projektami w czasie rzeczywistym. Aplikacja Google Chat korzysta z Vertex AI, aby pomagać zespołom w pisaniu historii użytkowników (które przedstawiają funkcje systemu oprogramowania z punktu widzenia użytkownika, aby zespół mógł je opracować) i przechowuje te historie w bazie danych Firestore.

  • Wzmianka o aplikacji do zarządzania projektami spowoduje, że aplikacja zaoferuje pomoc.
    Rysunek 1. Charlie omawia z zespołem rozwój funkcji w pokoju w Google Chat. Wzmianka o aplikacji do zarządzania projektami w Google Chat powoduje, że aplikacja ta oferuje pomoc.
  • Tworzenie historii za pomocą polecenia po ukośniku /createUserStory.
    Rysunek 2. Za pomocą polecenia /createUserStory Charlie tworzy historię.
  • Aplikacja do obsługi czatu do zarządzania projektami korzysta z Vertex AI do pisania opisu historii.
    Rysunek 3. Aplikacja do zarządzania projektami w Chat korzysta z Vertex AI, aby napisać opis historii, a następnie udostępnia ją w pokoju.
  • Charlie dopracowuje szczegóły historii.
    Rysunek 4. Charlie klika Edytuj, aby sfinalizować szczegóły historii. Opis wygenerowany przez AI jest dokładny, ale Charlie chce uzyskać więcej szczegółów, więc klika Rozwiń, aby Vertex AI dodał wymagania do opisu historii. Charlie przypisuje historię do siebie, ustawia stan na „Rozpoczęto”, wybiera odpowiedni priorytet i rozmiar, a następnie klika Zapisz.
  • zarządzanie wszystkimi historiami użytkowników zespołu;
    Rysunek 5. W każdej chwili Charlie może wyświetlić wszystkie historie użytkowników zespołu i nimi zarządzać za pomocą /manageUserStoriespolecenia po ukośniku
    .

Wymagania wstępne

Cele

  • Utwórz aplikację Google Chat do zarządzania projektami oprogramowania realizowanymi w metodologii Agile.
  • Pomagaj użytkownikom pisać historie użytkownika za pomocą narzędzi do pisania historii wspomaganych przez generatywną AI, które działają w oparciu o Vertex AI:
    • generować i regenerować opisy opowiadań;
    • Rozwiń opisy historii z notatek do pełnych wymagań.
    • Poprawiaj błędy gramatyczne, aby usuwać literówki.
  • Aktualizuj pracę, zapisując dane w bazie danych Firestore i odczytując je z niej.
  • Ułatwianie współpracy w pokoju w Google Chat poprzez umożliwienie użytkownikom tworzenia, edytowania, przypisywania i rozpoczynania historii bezpośrednio z poziomu rozmowy.

Używane produkty

Aplikacja do zarządzania projektami korzysta z tych usług Google Workspace i Google Cloud:

  • Chat API: interfejs API do tworzenia aplikacji Google Chat, które odbierają i odpowiadają na zdarzenia interakcji w Google Chat, takie jak wiadomości. Aplikacja do zarządzania projektami w Google Chat korzysta z interfejsu Chat API, aby otrzymywać zdarzenia interakcji wysyłane przez Chat i na nie odpowiadać, a także konfigurować atrybuty, które określają sposób wyświetlania aplikacji w Google Chat, takie jak nazwa i obraz awatara.
  • Vertex AI API: platforma generatywnej AI. Aplikacja Google Chat do zarządzania projektami korzysta z interfejsu Vertex AI API do pisania tytułów i opisów historii użytkowników.
  • Firestore bezserwerowa baza danych dokumentów. Aplikacja Google Chat do zarządzania projektami używa Firebase do przechowywania danych o historii użytkowników.

  • Cloud Functions: wymagająca niewielu zasobów usługa obliczeniowa bez serwera, która umożliwia tworzenie samodzielnych funkcji o ściśle zdefiniowanym przeznaczeniu reagujących na zdarzenia interakcji w Chat bez konieczności zarządzania serwerem lub środowiskiem wykonawczym. Aplikacja Google Chat do zarządzania projektami korzysta z Cloud Functions jako platformy obliczeniowej do uruchamiania logiki, która przetwarza zdarzenia interakcji i na nie odpowiada, oraz do hostowania punktu końcowego HTTP, do którego Chat wysyła zdarzenia interakcji.

    Cloud Functions korzysta z tych usług Google Cloud do tworzenia, przetwarzania zdarzeń interakcji i hostowania zasobów obliczeniowych:

    • Cloud Build: w pełni zarządzana platforma do ciągłej integracji, dostarczania i wdrażania, która uruchamia zautomatyzowane kompilacje.
    • Pub/Sub: asynchroniczna i skalowalna usługa do przesyłania wiadomości, która oddziela usługi generujące wiadomości od usług, które je przetwarzają.
    • Cloud Run Admin API: w pełni zarządzane środowisko do uruchamiania aplikacji w kontenerach.

Architektura

Architektura aplikacji Google Chat do zarządzania projektami odbiera i przetwarza zdarzenia interakcji w Google Chat w punkcie końcowym HTTP, używa Vertex AI do tworzenia historii użytkowników i przechowuje szczegóły historii użytkowników w bazie danych Firestore. Poniższy diagram przedstawia architekturę zasobów Google Workspace i Google Cloud, które są używane.

Schemat architektury aplikacji do zarządzania projektami w Google Chat

Aplikacja do zarządzania projektami w Google Chat działa w ten sposób:

  1. Użytkownik wysyła wiadomość w Google Chat i wywołuje aplikację do zarządzania projektami w Google Chat, wysyłając do niej wiadomość bezpośrednio, wspominając ją w pokoju lub wpisując polecenie po ukośniku.

  2. Chat wysyła synchroniczne żądanie HTTP do punktu końcowego HTTP funkcji w Cloud Functions.

  3. Aplikacja Google Chat do zarządzania projektami przetwarza żądanie HTTP:

    1. Vertex AI pomaga pisać lub aktualizować historyjki użytkownika.

    2. Baza danych Firestore przechowuje, pobiera, aktualizuje i usuwa dane dotyczące historii użytkownika.

  4. Cloud Functions zwraca do Google Chat odpowiedź HTTP, która jest wyświetlana użytkownikowi jako wiadomość lub okno.

Przygotowywanie środowiska

W tej sekcji dowiesz się, jak utworzyć i skonfigurować projekt Google Cloud na potrzeby aplikacji do obsługi czatu.

Tworzenie projektu Google Cloud

Google Cloud Console

  1. W konsoli Google Cloud kliknij Menu  > Administracja > Utwórz projekt.

    Otwórz stronę Tworzenie projektu

  2. W polu Nazwa projektu wpisz opisową nazwę projektu.

    Opcjonalnie: aby edytować identyfikator projektu, kliknij Edytuj. Po utworzeniu projektu nie można zmienić jego identyfikatora, więc wybierz taki, który będzie Ci odpowiadać przez cały okres jego istnienia.

  3. W polu Lokalizacja kliknij Przeglądaj, aby wyświetlić potencjalne lokalizacje projektu. Następnie kliknij Wybierz.
  4. Kliknij Utwórz. W konsoli Google Cloud otworzy się strona Panel, a projekt zostanie utworzony w ciągu kilku minut.

interfejs wiersza poleceń gcloud

W jednym z tych środowisk programistycznych uzyskaj dostęp do interfejsu Google Cloud CLI (gcloud):

  • Cloud Shell: aby używać terminala online z już skonfigurowanym interfejsem gcloud CLI, aktywuj Cloud Shell.
    Aktywuj Cloud Shell
  • Lokalna powłoka: aby używać lokalnego środowiska programistycznego, zainstaluj i zainicjuj interfejs wiersza poleceń gcloud.
    Aby utworzyć projekt w Google Cloud, użyj polecenia gcloud projects create: 
    gcloud projects create PROJECT_ID
     Zastąp PROJECT_ID identyfikatorem projektu, który chcesz utworzyć.

Włączanie płatności za projekt Cloud

Google Cloud Console

  1. W konsoli Google Cloud wybierz Płatności. Kliknij Menu > Rozliczenia > Moje projekty.

    Otwórz stronę Płatności za moje projekty

  2. W sekcji Wybierz organizację wybierz organizację powiązaną z Twoim projektem Google Cloud.
  3. W wierszu projektu otwórz menu Działania , kliknij Zmień ustawienia płatności i wybierz konto rozliczeniowe w Cloud.
  4. Kliknij Ustaw konto.

interfejs wiersza poleceń gcloud

  1. Aby wyświetlić listę dostępnych kont rozliczeniowych, uruchom to polecenie: 
    gcloud billing accounts list
  2. Połącz konto rozliczeniowe z projektem Google Cloud: 
    gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

    Zastąp następujące elementy:

    • PROJECT_ID to identyfikator projektu projektu Cloud, w którym chcesz włączyć płatności.
    • BILLING_ACCOUNT_ID to identyfikator konta rozliczeniowego, które ma zostać połączone z projektem Google Cloud.

Włączanie interfejsów API

Google Cloud Console

  1. W konsoli Google Cloud włącz interfejsy Google Chat API, Vertex AI API, Cloud Functions API, Firestore API, Cloud Build API, Pub/Sub API i Cloud Run Admin API.

    Włączanie interfejsów API

  2. Sprawdź, czy włączasz interfejsy API w odpowiednim projekcie w Cloud, a potem kliknij Dalej.

  3. Sprawdź, czy włączasz odpowiednie interfejsy API, a następnie kliknij Włącz.

interfejs wiersza poleceń gcloud

  1. W razie potrzeby ustaw bieżący projekt Cloud na projekt utworzony za pomocą polecenia gcloud config set project:

    gcloud config set project PROJECT_ID

    Zastąp PROJECT_ID identyfikatorem projektu utworzonego projektu w Cloud.

  2. Włącz interfejsy Google Chat API, Vertex AI API, Cloud Functions API, Firestore API, Cloud Build API, Pub/Sub API i 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.com

    Interfejsy Cloud Build API, Pub/Sub API i Cloud Run Admin API są wymagane do korzystania z Cloud Functions.

Uwierzytelnianie i autoryzacja

Aby skorzystać z tego samouczka, nie musisz konfigurować uwierzytelniania ani autoryzacji.

Aby wywoływać interfejsy Firestore API i Vertex AI API, w tym samouczku używane są domyślne dane logowania aplikacji z domyślnym kontem usługi dołączonym do funkcji w Cloud Functions, którego nie musisz konfigurować. W kontekście środowiska produkcyjnego zwykle tworzysz i dołączasz konto usługi do funkcji Cloud Functions.

Tworzenie i wdrażanie aplikacji Google Chat

Po utworzeniu i skonfigurowaniu projektu Google Cloud możesz utworzyć i wdrożyć aplikację Google Chat. W tej sekcji wykonasz te czynności:

  1. Utwórz bazę danych Firestore, w której będziesz przechowywać i pobierać historie użytkowników.
  2. Opcjonalnie możesz przejrzeć przykładowy kod.
  3. Utwórz funkcję Cloud, która będzie hostować i uruchamiać kod aplikacji do obsługi czatu w odpowiedzi na zdarzenia otrzymywane z Google Chat w postaci żądań HTTP.
  4. Utwórz i wdróż aplikację do obsługi czatu w Google Chat na stronie konfiguracji interfejsu Google Chat API.

Tworzenie bazy danych Firestore

W tej sekcji utworzysz bazę danych Firestore, aby przechowywać i pobierać historie użytkowników, ale nie zdefiniujesz modelu danych. Model danych jest ustawiany niejawnie w przykładowym kodzie przez pliki model/user-story.js i model/user.js.

Baza danych aplikacji do obsługi projektów na czacie korzysta z modelu danych NoSQL opartego na dokumentach uporządkowanych w kolekcje. Więcej informacji znajdziesz w sekcji Model danych Firestore.

Poniższy diagram przedstawia model danych aplikacji Google Chat do zarządzania projektami:

Model danych bazy danych Firestore.

Kolekcja główna to spaces, w której każdy dokument reprezentuje pokój, w którym aplikacja Chat utworzyła historie. Każda historia użytkownika jest reprezentowana przez dokument w podkolekcji userStories, a każdy użytkownik – przez dokument w podkolekcji users.

Wyświetlanie definicji kolekcji, dokumentów i pól

spaces

Pokoje, w których aplikacja Chat utworzyła historie.

Pola
Document IDString
Unikalny identyfikator konkretnej przestrzeni, w której tworzone są historie. Odpowiada nazwie zasobu pokoju w interfejsie Chat API.
userStoriesSubcollection of Documents (userStories)
Historie utworzone przez aplikację Chat i jej użytkowników. Odpowiada Document ID userStories w Firebase.
usersSubcollection of Documents (user)
Użytkownicy, którzy utworzyli historie lub do których są one przypisane.
displayNameString
Wyświetlana nazwa pokoju w interfejsie Chat API. Nie jest ustawiona w przypadku czatów z użytkownikami.

userStories

Historie utworzone przez aplikację Chat i jej użytkowników.

Pola
Document IDString
Unikalny identyfikator konkretnej historii użytkownika utworzonej przez aplikację do obsługi czatu i jej użytkowników.
assigneeDocument (user)
Nazwa zasobu użytkownika przypisanego do ukończenia historii. Odpowiada Document ID dokumentu users i nazwie zasobu użytkownika w interfejsie Chat API.
descriptionString
Opis funkcji oprogramowania z perspektywy użytkownika.
priorityEnum
Pilność wykonania zadania. Możliwe wartości to Low, Medium lub High.
sizeEnum
Ilość pracy. Możliwe wartości to Small, Medium lub Large.
statusEnum
Etap pracy. Możliwe wartości to OPEN, STARTED lub COMPLETED.
titleString
Tytuł artykułu, krótkie podsumowanie.

users

Użytkownicy, którzy utworzyli historie lub którym zostały one przypisane.

Pola
Document IDString
Unikalny identyfikator konkretnego użytkownika. Odpowiada assigneeuserStories w Firebase i nazwie zasobu użytkownika w interfejsie Chat API.
avatarUrlString
Adres URL hostujący obraz awatara użytkownika na czacie.
displayNameString
Wyświetlana nazwa użytkownika w Google Chat.

Aby utworzyć bazę danych Firestore:

Google Cloud Console

  1. W konsoli Google Cloud otwórz Firestore. Kliknij Menu > Firestore.

    Otwórz Firestore

  2. Kliknij Utwórz bazę danych.

  3. W sekcji Wybierz tryb Firestore kliknij Tryb natywny.

  4. Kliknij Dalej.

  5. Skonfiguruj bazę danych:

    1. W sekcji Nazwij bazę danych pozostaw Identyfikator bazy danych jako (default).

    2. W polu Typ lokalizacji określ region bazy danych, np. us-central1. Aby uzyskać najlepszą wydajność, wybierz tę samą lokalizację co funkcja w Cloud Functions aplikacji do obsługi czatu lub lokalizację w pobliżu.

  6. Kliknij Utwórz bazę danych.

interfejs wiersza poleceń gcloud

  • Utwórz bazę danych Firestore w trybie natywnym za pomocą poleceniagcloud firestore databases create:

    gcloud firestore databases create \
--location=LOCATION \
--type=firestore-native

    Zastąp LOCATION nazwą regionu Firestore, na przykład us-central1.

Przeglądanie przykładowego kodu

Opcjonalnie przed utworzeniem funkcji Cloud Functions możesz zapoznać się z przykładowym kodem hostowanym na GitHubie.

Wyświetl w GitHubie

Oto omówienie poszczególnych plików:

env.js
Zmienne konfiguracji środowiska do wdrożenia aplikacji do obsługi czatu w określonym projekcie i regionie Google Cloud. Musisz zaktualizować zmienne konfiguracyjne w tym pliku.
package.json i package-lock.json
Ustawienia projektu Node.js i zależności.
index.js
Punkt wejścia funkcji Cloud Functions aplikacji do obsługi czatu. Odczytuje zdarzenie czatu z żądania HTTP, wywołuje moduł obsługi aplikacji i publikuje odpowiedź HTTP jako obiekt JSON.
controllers/app.js
Główna logika aplikacji. Przetwarza zdarzenia interakcji, obsługując wzmianki w aplikacji Chat i polecenia po ukośniku. Aby reagować na kliknięcia kart, wywołuje funkcję app-action-handler.js.
controllers/app-action-handler.js
Logika aplikacji do obsługi kliknięcia karty zdarzenia interakcji w Google Chat.
services/space-service.js, services/user-service.js i services/user-story-service.js
Te pliki zawierają części logiki aplikacji, które są specyficzne dla pracy z pokojami czatu, użytkownikami i historiami użytkowników. Funkcje w tych plikach są wywoływane przez app.js lub app-action-handler.js. Aby wykonywać operacje na bazie danych, funkcje w tych plikach wywołują funkcje w firestore-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.js i services/user-story-service.js.
services/aip-service.js
Wywołuje interfejs Vertex AI API w celu przewidywania tekstu generatywnej AI.
model/*.js
Te pliki zawierają definicje klas i wyliczeń, których usługi aplikacji używają do przechowywania i przekazywania danych między funkcjami. Określają one model danych bazy danych Firestore.
views/*.js
Każdy plik w tym katalogu tworzy obiekt karty, który aplikacja Chat wysyła z powrotem do Google Chat jako wiadomość z kartą lub odpowiedź na działanie w oknie.
views/widgets/*.js
Każdy plik tworzy instancję typu obiektu widżetu, którego aplikacja używa do tworzenia kart w views/katalogu
.
test/**/*.test.js
Każdy plik w tym katalogu i jego podkatalogach zawiera testy jednostkowe odpowiedniej funkcji, kontrolera, usługi, widoku lub widżetu. Wszystkie testy jednostkowe możesz uruchomić, wpisując npm run test 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 będzie zawierać logikę aplikacji do zarządzania projektami w Google Chat.

Funkcja w Cloud Functions jest uruchamiana w odpowiedzi na żądanie HTTP z Chat zawierające zdarzenie interakcji w Chat. Po uruchomieniu kod funkcji Cloud Function przetwarza zdarzenie i zwraca odpowiedź do Google Chat, która jest renderowana jako wiadomość, okno lub inny rodzaj interakcji z użytkownikiem. W razie potrzeby funkcja w Cloud Functions odczytuje też dane z bazy danych Firestore lub zapisuje w niej dane.

Aby utworzyć funkcję w Cloud Functions:

Google Cloud Console

  1. Pobierz kod z GitHuba jako plik ZIP.

    Pobierz plik ZIP

  2. Rozpakuj pobrany plik ZIP.

    Wyodrębniony folder zawiera całe repozytorium przykładów Google Workspace.

  3. W wypakowanym folderze przejdź do folderu google-chat-samples-main/node/project-management-app/, a następnie skompresuj folder project-management-app do pliku ZIP.

    Katalog główny pliku ZIP musi zawierać te pliki i foldery:

    • env.js
    • README.md
    • gcloudignore.text
    • package-lock.json
    • package.json
    • index.js
    • model/
    • controllers/
    • views/
    • services/

  4. W konsoli Google Cloud otwórz stronę Cloud Functions:

    Otwórz Cloud Functions

    Sprawdź, czy wybrany jest projekt Google Cloud dla aplikacji Chat.

  5. Kliknij  Utwórz funkcję.

  6. Na stronie Utwórz funkcję skonfiguruj funkcję:

    1. W sekcji Środowisko wybierz Funkcja Cloud Run.
    2. W polu Nazwa funkcji wpisz project-management-tutorial.
    3. W sekcji Region wybierz region.
    4. W sekcji Uwierzytelnianie wybierz Zezwalaj na nieuwierzytelnione wywołania.
    5. Kliknij Dalej.

  7. W sekcji Środowisko wykonawcze wybierz Node.js 20.

  8. W sekcji Punkt wejścia usuń tekst domyślny i wpisz projectManagementChatApp.

  9. W sekcji Kod źródłowy wybierz Prześlij plik ZIP.

  10. W sekcji Zasobnik docelowy utwórz lub wybierz zasobnik:

    1. Kliknij Przeglądaj.
    2. Wybierz zasobnik.
    3. Kliknij Wybierz.

    Google Cloud przesyła plik ZIP do tego zasobnika i wyodrębnia z niego pliki komponentu. Cloud Functions kopiuje następnie pliki komponentu do funkcji w Cloud Functions.

  11. W sekcji Plik ZIP prześlij plik ZIP pobrany z GitHub, rozpakowany i ponownie skompresowany:

    1. Kliknij Przeglądaj.
    2. Znajdź i wybierz plik ZIP.
    3. Kliknij Otwórz.

  12. Kliknij Wdróż.

    Otworzy się strona Szczegóły Cloud Functions, na której zobaczysz swoją funkcję z 2 wskaźnikami postępu: jeden dla kompilacji, a drugi dla usługi. Gdy oba wskaźniki postępu znikną i zostaną zastąpione przez symbol zaznaczenia, funkcja zostanie wdrożona i będzie gotowa do użycia.

  13. Edytuj przykładowy kod, aby ustawić stałe:

    1. Na stronie Szczegóły funkcji w Cloud Functions kliknij Edytuj.
    2. Kliknij Dalej.
    3. W sekcji Kod źródłowy wybierz Edytor wbudowany.
    4. W edytorze wbudowanym otwórz plik env.js.
    5. Zastąp project-id identyfikatorem projektu Cloud.
    6. Opcjonalnie: zaktualizuj us-central1, podając obsługiwaną lokalizację dla funkcji w Cloud Functions.

  14. Kliknij Wdróż.

  15. Po wdrożeniu funkcji skopiuj adres URL aktywatora:

    1. Na stronie Szczegóły funkcji kliknij Aktywator.
    2. Skopiuj adres URL. Jest on potrzebny do skonfigurowania aplikacji Chat w następnej sekcji.

interfejs wiersza poleceń gcloud

  1. Sklonuj kod z GitHuba:

    git clone https://github.com/googleworkspace/google-chat-samples.git

  2. Przejdź do katalogu, w którym znajduje się kod aplikacji do zarządzania projektami w Google Chat:

    cd google-chat-samples/node/project-management-app

  3. Edytuj plik env.js, aby ustawić zmienne środowiskowe:

    1. Zastąp project-id identyfikatorem projektu Google Cloud.
    2. Zastąp us-central1 lokalizacją projektu Google Cloud.

  4. 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-unauthenticated

    Zastąp REGION lokalizacją Cloud Functions, w której jest hostowana infrastruktura, np. us-central1.

  1. Po wdrożeniu funkcji skopiuj właściwość url z odpowiedzi. Jest to adres URL aktywatora, którego użyjesz w następnej sekcji do skonfigurowania aplikacji Google Chat.

Konfigurowanie aplikacji Google Chat w konsoli Google Cloud

W tej sekcji dowiesz się, jak skonfigurować interfejs Chat API w konsoli Google Cloud, podając informacje o aplikacji do obsługi czatu, w tym jej nazwę, obsługiwane polecenia ze znakiem ukośnika i adres URL wywołania funkcji Cloud Function aplikacji do obsługi czatu, do której wysyła ona zdarzenia interakcji na czacie.

  1. W konsoli Google Cloud kliknij Menu > Więcej usług > Google Workspace > Biblioteka usług > Google Chat API > Zarządzaj > Konfiguracja.

    Otwórz konfigurację interfejsu Chat API

  2. W polu Nazwa aplikacji wpisz Project Manager.

  3. W polu URL awatara wpisz https://developers.google.com/chat/images/quickstart-app-avatar.png.

  4. W polu Opis wpisz Manages projects with user stories..

  5. Ustaw przełącznik Włącz funkcje interaktywne w pozycji włączonej.

  6. W sekcji Funkcje wybierz Dołączanie do pokoi i rozmów grupowych.

  7. W sekcji Ustawienia połączenia wybierz URL punktu końcowego HTTP.

  8. W polu HTTP endpoint URL (Adres URL punktu końcowego HTTP) wklej adres URL aktywatora skopiowany z wdrożenia Cloud Functions w formacie https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Jeśli funkcja Cloud Functions została wdrożona za pomocą gcloud CLI, jest to właściwość url.

  9. Zarejestruj polecenia po ukośniku aplikacji Google Chat. Aby zarejestrować polecenie po ukośniku:

    1. W sekcji Polecenia kliknij Dodaj polecenie.

    2. Dla każdego polecenia ukośnika podanego w tabeli poniżej wpisz Nazwę, Identyfikator polecenia i Opis oraz wybierz, czy polecenie ukośnika Otwiera okno. Następnie kliknij Gotowe:

      Nazwa Identyfikator polecenia Opis Typ polecenia Nazwa polecenia po ukośniku Otwiera okno
      Tworzenie historyjki użytkownika 1 Utwórz opowiadanie o podanym tytule. Polecenie po ukośniku /createUserStory Odznaczono
      Moje historie użytkowników 2 Wyświetla listę wszystkich artykułów przypisanych do użytkownika. Polecenie po ukośniku /myUserStories Odznaczono
      Historia użytkownika 3 Wyświetla bieżący stan określonej relacji. Polecenie po ukośniku /userStory Odznaczono
      Zarządzanie historiami użytkowników 4 Otwiera okno, w którym można edytować historie. Polecenie po ukośniku /manageUserStories Wybrano
      Usuwanie historii użytkowników 5 Usuwa wszystkie artykuły w pokoju. Polecenie po ukośniku /cleanupUserStories Odznaczono

  10. W sekcji Widoczność wybierz Udostępnij tę aplikację do obsługi czatu konkretnym osobom i grupom w domenie Workspace i wpisz swój adres e-mail.

  11. Opcjonalnie w sekcji Logi wybierz Loguj błędy w usłudze Logging.

  12. Kliknij Zapisz. Pojawi się komunikat o zapisaniu konfiguracji, co oznacza, że aplikacja do czatu jest gotowa do testowania.

Testowanie aplikacji Google Chat

Przetestuj aplikację do zarządzania projektami w Google Chat, wysyłając do niej wiadomości i używając poleceń z ukośnikiem do tworzenia, edytowania i usuwania historii użytkowników.

  1. Otwórz Google Chat, korzystając z konta Google Workspace, które zostało podane podczas dodawania siebie jako zaufanego testera.

    Otwórz Google Chat

  2. Kliknij  Nowy czat.
  3. W polu Dodaj co najmniej 1 osobę wpisz nazwę aplikacji Chat.

  4. Wybierz aplikację Chat z wyników. Otworzy się czat.

  5. Na nowym czacie z aplikacją wpisz Hello i naciśnij enter. Aplikacja do zarządzania projektami odpowiada menu pomocy z informacjami o tym, co potrafi.
  6. Aby utworzyć wycieczkę, wpisz /createUserStory Test story na pasku wiadomości i wyślij ją. Aplikacja do obsługi czatu do zarządzania projektami odpowiada kartą z informacjami o historii użytkownika, którą tworzy dla Ciebie za pomocą generatywnej AI z Vertex AI.

  7. W konsoli sprawdź bazę danych Firestore, aby przejrzeć utworzone przez nią rekordy dotyczące pokoju, do którego dodano aplikację Chat, użytkowników, którzy w nim działali, oraz utworzonego przez Ciebie scenariusza użytkownika.

    Otwórz Firestore

  8. Wróć do Google Chat.

    Otwórz Google Chat

  9. Opcjonalnie, aby edytować historię, kliknij Edytuj. Gdy wszystko będzie działać jak należy, kliknij Zapisz.
  10. Przetestuj każde polecenie z ukośnikiem obsługiwane przez aplikację. Aby je wyświetlić, wpisz / lub wspomnij o aplikacji Chat.
  11. Usuń testową historię użytkownika, wpisując /cleanupUserStoriespolecenie slash. Możesz też usunąć lub odinstalować aplikację. Po usunięciu aplikacja usunie wszystkie historie użytkowników utworzone w tym pokoju.

Rozwiązywanie problemów

Gdy aplikacja Google Chat lub karta zwraca błąd, w interfejsie Google Chat pojawia się komunikat „Coś poszło nie tak”. lub „Nie udało się przetworzyć Twojej prośby”. Czasami interfejs Google Chat nie wyświetla żadnego komunikatu o błędzie, ale aplikacja lub karta Google Chat daje nieoczekiwany wynik, np. wiadomość na karcie może się nie pojawić.

Chociaż w interfejsie czatu może nie wyświetlać się komunikat o błędzie, opisowe komunikaty o błędach i dane logowania są dostępne, aby pomóc w naprawieniu błędów, gdy rejestrowanie błędów w aplikacjach na czat jest włączone. Pomoc dotyczącą wyświetlania, debugowania i naprawiania błędów znajdziesz w artykule Rozwiązywanie problemów z Google Chat.

Czyszczenie danych

Aby uniknąć obciążenia konta Google Cloud opłatami za zasoby zużyte w tym samouczku, zalecamy usunięcie projektu w Cloud.

  1. W konsoli Google Cloud otwórz stronę Zarządzanie zasobami. Kliknij Menu > Administracja > Zarządzaj zasobami.

    Otwórz Menedżera zasobów

  2. Na liście projektów wybierz projekt, który chcesz usunąć, a potem kliknij Usuń .
  3. W oknie wpisz identyfikator projektu i kliknij Wyłącz, aby usunąć projekt.