Ta strona została przetłumaczona przez Cloud Translation API.

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 perspektywy użytkownika, aby zespół mógł je opracować) i przechowuje te historie w bazie danych Firestore.

Rysunek 1. Karol rozmawia ze swoim zespołem w swoim pokoju czatu. Wspomnienie aplikacji do zarządzania projektami powoduje, że aplikacja Google Chat zaproponuje pomoc.
Rysunek 2. Charlie tworzy historię za pomocą polecenia /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. Charlie przypisuje do siebie historię, ustawia stan na rozpoczęta, wybiera odpowiedni priorytet i rozmiar, a następnie klika Zapisz.
Rysunek 5. W każdej chwili Charlie może wyświetlać wszystkie historie użytkowników zespołu i nimi zarządzać za pomocą /manageUserStories polecenia po ukośniku.

Wymagania wstępne

Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
dostęp do usług Google Cloud, aby:
- 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 interfejsu wiersza poleceń Google Cloud, musisz mieć skonfigurowane środowisko programistyczne Node.js do pracy z interfejsem wiersza poleceń gcloud. Zapoznaj się z artykułem Konfigurowanie środowiska programistycznego Node.js.

Cele

Utworzyć aplikację Google Chat, która zarządza elastycznymi projektami oprogramowania.
Pomóż użytkownikom w pisaniu historii użytkowników za pomocą narzędzi do pisania tekstów wspomaganych przez generatywną AI, które korzystają z Vertex AI:
- Generuj i ponownie wygeneruj opisy artykułów.
- Rozwiń opisy ścieżki z notatek, aby spełnić wymagania.
- Popraw błędy gramatyczne, aby poprawić literówki.
Aktualizuj dane, zapisując je w bazie danych Firestore i odczytując z niej.
Ułatwić współpracę w pokoju Google Chat, umożliwiając użytkownikom tworzenie, edytowanie, przypisywanie i uruchamianie historii bezpośrednio z poziomu rozmowy.

Używane usługi

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 z Google Chat, takie jak wiadomości. Aplikacja Google Chat do zarządzania projektami korzysta z interfejsu Chat API, aby odbierać i odpowiadać na zdarzenia interakcji wysyłane przez Google Chat, a także konfigurować atrybuty, które określają jej wygląd 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 tworzenia tytułów i opisów scenariuszy użytkownika.
Firestore: bezserwerowa baza danych dokumentów. Aplikacja Google Chat do zarządzania projektami korzysta z Firebase do przechowywania danych o historiach użytkowników.
Cloud Functions: lekka, bezserwerowa usługa obliczeniowa, która umożliwia tworzenie jednozadaniowych, samodzielnych funkcji, które mogą reagować na zdarzenia interakcji z Google Chat bez konieczności zarządzania serwerem lub środowiskiem wykonawczym. Aplikacja Google Chat do zarządzania projektami używa Cloud Functions do hostowania punktu końcowego HTTP, do którego Google Chat wysyła zdarzenia interakcji, oraz jako platformy obliczeniowej do uruchamiania logiki, która przetwarza te zdarzenia i na nie reaguje.

Cloud Functions używa tych usług Google Cloud do tworzenia i przetwarzania zdarzeń interakcji oraz hostowania zasobów obliczeniowych:
- Cloud Build: w pełni zarządzana platforma do ciągłej integracji, dostarczania i wdrażania, która obsługuje kompilacje automatyczne.
- 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 te wiadomości 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 z Google Chat w punkcie końcowym HTTP, używa Vertex AI do pisania historii użytkowników i przechowuje szczegóły historii użytkownika w bazie danych Firestore. Poniższy diagram przedstawia architekturę zasobów Google Workspace i Google Cloud, których użyto.

Schemat architektury aplikacji Google Chat do zarządzania projektami

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

Użytkownik wysyła wiadomość w Google Chat i wywołuje aplikację Google Chat do zarządzania projektami, wysyłając do niej wiadomość bezpośrednio, wspominając o niej w pokoju lub wpisując znak ukośnika.
Czat wysyła synchroniczne żądanie HTTP do punktu końcowego HTTP funkcji w Cloud Functions.
Aplikacja Google Chat do zarządzania projektami przetwarza żądanie HTTP:
1. Vertex AI pomaga pisać lub aktualizować historię użytkownika.
2. Baza danych Firestore przechowuje, pobiera, aktualizuje i usuwa dane dotyczące historii użytkownika.
Cloud Functions zwraca do Google Chat odpowiedź HTTP, która jest wyświetlana użytkownikowi jako wiadomość lub okno dialogowe.

Przygotowywanie środowiska

W tej sekcji dowiesz się, jak utworzyć i skonfigurować projekt Google Cloud na potrzeby aplikacji Google Chat.

Tworzenie projektu Google Cloud

Google Cloud Console

W konsoli Google Cloud kliknij Menu > Administracja > Utwórz projekt.
Otwórz stronę Utwórz projekt
W polu Nazwa projektu wpisz nazwę projektu.
Opcjonalnie: aby edytować identyfikator projektu, kliknij Edytuj. Po utworzeniu projektu nie można zmienić jego identyfikatora. Wybierz więc identyfikator, który będzie odpowiadał Twoim potrzebom przez cały czas trwania projektu.
W polu Lokalizacja kliknij Przeglądaj, aby wyświetlić potencjalne lokalizacje dla Twojego projektu. Następnie kliknij Wybierz.
Uwaga: nie możesz znaleźć organizacji Google Workspace?
Oznacza to, że nie jesteś zalogowany na konto Google Workspace. Niektóre funkcje opisane w dokumentacji dla deweloperów Google Workspace są dostępne tylko w projektach powiązanych z organizacją.
Kliknij Utwórz. Konsola Google Cloud przejdzie do strony 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 Google Cloud CLI (gcloud):

Cloud Shell: aby korzystać z terminala online z już skonfigurowanym interfejsem gcloud CLI, aktywuj Cloud Shell.
Aktywuj Cloud Shell
Interfejs lokalny: aby korzystać z lokalnego środowiska programistycznego, zainstaluj i inicjuj interfejs wiersza poleceń gcloud.
Aby utworzyć projekt 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 w projekcie Cloud

Google Cloud Console

W konsoli Google Cloud otwórz Płatności. Kliknij Menu > Płatności > Moje projekty.
Otwórz Płatności za 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 Billing.
Kliknij Ustaw konto.

interfejs wiersza poleceń gcloud

Aby wyświetlić listę dostępnych kont rozliczeniowych, wykonaj te czynności:
```
gcloud billing accounts list
```
Aby połączyć 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 chcesz połączyć z projektem Google Cloud.

Włącz interfejsy 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, Pub/Sub API i Cloud Run Admin API.

Włącz interfejsy 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 potem kliknij Włącz.

interfejs wiersza poleceń gcloud

W razie potrzeby ustaw bieżący projekt Cloud na ten utworzony za pomocą polecenia gcloud config set project:
```
gcloud config set project PROJECT_ID
```
Zastąp PROJECT_ID identyfikatorem utworzonego projektu Cloud.
Włącz 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 i Cloud Run Admin API są wymagane do korzystania z Cloud Functions.

Uwierzytelnianie i autoryzacja

Aby wykonać ten samouczek, nie musisz konfigurować uwierzytelniania ani autoryzacji.

Aby wywoływać interfejsy API Firestore i Vertex AI, w tym samouczku używamy domyślnych danych logowania aplikacji z domyślnym kontem usługi dołączonym do funkcji Cloud Functions, której nie musisz konfigurować. W środowisku produkcyjnym zwykle trzeba create i dołączyć do funkcji w Cloud Functions konto usługi.

Tworzenie i wdrażanie aplikacji Google Chat

Projekt Google Cloud został utworzony i skonfigurowany, więc możesz tworzyć i wdrażać aplikację Google Chat. W tej sekcji wykonasz te czynności:

Utwórz bazę danych Firestore, w której będą przechowywane i pobierane historie użytkowników.
Opcjonalnie przejrzyj przykładowy kod.
Utwórz funkcję Cloud Functions, aby hostować i uruchamiać kod aplikacji Chat w odpowiedzi na zdarzenia otrzymane z Google Chat jako żądania HTTP.
Utwórz i wdróż aplikację Google Chat na stronie konfiguracji interfejsu Google Chat API.

Tworzenie bazy danych Firestore

W tej sekcji utworzysz bazę danych Firestore do przechowywania i pobierania historii użytkowników, ale nie zdefiniujesz modelu danych. Model danych jest ustawiany w przykładowym kodzie w pobożnym sposobie przez pliki model/user-story.js i model/user.js.

Baza danych aplikacji do zarządzania projektami korzysta z modelu danych NoSQL opartego na dokumentach uporządkowanych w kolekcjach. Więcej informacji znajdziesz w artykule na temat modelu danych Firestore.

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

Model danych bazy danych Firestore.

Kolekcja metryki to spaces, gdzie każdy dokument reprezentuje pokój, w którym aplikacja Google Chat utworzyła historie. Każda historia użytkownika jest reprezentowana przez dokument w podkolekcji userStories, a każdy użytkownik jest reprezentowany przez dokument w kolekcji podrzędnej users.

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

`spaces`

pokoju, w którym aplikacja Google Chat utworzyła historie.

Pola
`Document ID`	`String` Unikalny identyfikator konkretnego miejsca, w którym tworzone są historie. Odpowiada nazwie zasobu pokoju w interfejsie Chat API.
`userStories`	`Subcollection of Documents (userStories)` Historie utworzone przez aplikację Google Chat i jej użytkowników. Odpowiada `Document ID` w `userStories` w Firebase.
`users`	`Subcollection of Documents (user)` Użytkownicy, którzy utworzyli historie lub do których zostały przypisane historie.
`displayName`	`String` Wyświetlana nazwa pokoju w interfejsie API Google Chat. Nie ustawione w przypadku czatów z użytkownikami.

`userStories`

historie utworzone przez aplikację Google Chat i jej użytkowników;

Pola
`Document ID`	`String` Unikalny 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`	`String` Opis funkcji oprogramowania z perspektywy użytkownika.
`priority`	`Enum` Na ile pilne należy wykonać zadanie. Możliwe wartości to `Low`, `Medium` i `High`.
`size`	`Enum` Ilość pracy. Możliwe wartości to `Small`, `Medium` oraz `Large`.
`status`	`Enum` Etap pracy. Możliwe wartości to `OPEN`, `STARTED` i `COMPLETED`.
`title`	`String` Tytuł historii; krótkie podsumowanie.

`users`

Użytkownicy, którzy utworzyli artykuły lub którym przypisano historie.

Pola
`Document ID`	`String` Unikalny identyfikator konkretnego użytkownika. Odpowiada `assignee` obiektu `userStories` w Firebase i nazwie zasobu użytkownika w interfejsie Chat API.
`avatarUrl`	`String` Adres URL hostujący obraz awatara użytkownika w Google Chat.
`displayName`	`String` Wyś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.

Otwórz Firestore
Kliknij Utwórz bazę danych.
W sekcji Wybierz tryb Firestore kliknij Tryb natywny.
Kliknij Dalej.
Skonfiguruj bazę danych:
1. W polu Nazwij bazę danych pozostaw Identyfikator bazy danych jako (default).
2. W sekcji Typ lokalizacji określ region bazy danych, np. us-central1. Aby uzyskać najlepszą wydajność, wybierz tę samą lokalizację co funkcja Cloud Functions aplikacji Chat lub lokalizację w pobliżu.
Kliknij Utwórz bazę danych.

interfejs wiersza poleceń gcloud

Utwórz bazę danych Firestore w trybie natywnym za pomocą polecenia gcloud firestore databases create:
```
gcloud firestore databases create \
--location=LOCATION \
--type=firestore-native
```
Zastąp LOCATION nazwą regionu Firehose, np. us-central1.

Przeglądanie przykładowego kodu

Opcjonalnie przed utworzeniem funkcji w Cloud Functions poświęć chwilę na przejrzenie i zapoznanie się przykładowym kodem hostowanym na GitHubie.

Wyświetl w GitHubie

Oto omówienie każdego pliku:

env.js: Zmienna konfiguracji środowiska do wdrażania aplikacji Google Chat w określonym projekcie i regionie Google Cloud. Musisz zaktualizować zmienne konfiguracji w tym pliku.
package.json i package-lock.json: Ustawienia i zależności projektu Node.js
index.js: Punkt wejścia funkcji Cloud Functions aplikacji Chat. Czyta 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 o aplikacji Chat i polecenia po ukośniku. Aby reagować na kliknięcia karty, wywołuje funkcję app-action-handler.js.
controllers/app-action-handler.js: Logika aplikacji do obsługi kliknięcia karty zdarzeń interakcji z Google Chat.
services/space-service.js, services/user-service.js i services/user-story-service.js: Te pliki zawierają części logiki aplikacji dotyczącej pokoi czatu, użytkowników i scenariuszy użytkownika. Funkcje w tych plikach są wywoływane przez app.jslub app-action-handler.js. Aby wykonać operacje na bazie danych, funkcje w tych plikach wywołują funkcje w firestore-service.js.
services/firestore-service.js: Zarządza operacjami 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 do prognozowania tekstu przez generatywną 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 instancję obiektu karty, który aplikacja Google Chat wysyła z powrotem do Google Chat jako wiadomość z karty lub odpowiedź na działanie w dialogu.
views/widgets/*.js: Każdy plik tworzy instancję obiektu typu widget, którego aplikacja używa do tworzenia kart w katalogu views/.
test/**/*.test.js: Każdy plik w tym katalogu i jego podkatalogach zawiera testy jednostkowe odpowiadającej funkcji, kontrolera, usługi, widoku lub widgeta. Aby wykonać wszystkie testy jednostkowe, uruchom 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 aplikacji do zarządzania projektami w Google Chat.

Funkcja w Cloud Functions jest uruchamiana w odpowiedzi na żądanie HTTP z Google Chat zawierające zdarzenie interakcji z czatem. Podczas wykonywania kod funkcji w chmurze przetwarza zdarzenie i zwraca odpowiedź do czatu, która jest renderowana jako wiadomość, dialog lub inny typ interakcji z użytkownikiem. W stosownych przypadkach funkcja Cloud Function odczytuje dane z bazy danych Firestore lub zapisze do niej dane.

Aby utworzyć funkcję w Cloud Functions:

Google Cloud Console

Pobierz kod z GitHuba jako plik ZIP.

Pobierz plik ZIP
Wyodrębnij pobrany plik ZIP.

Wyodrębniony folder zawiera całe repozytorium przykładów Google Workspace.
W rozpakowanym folderze przejdź do 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/
W konsoli Google Cloud otwórz stronę Cloud Functions:

Otwórz Cloud Functions

Upewnij się, że wybrany jest projekt Google Cloud dla aplikacji Google Chat.
Kliknij Utwórz funkcję.
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 polu Region wybierz region.
4. W sekcji Uwierzytelnianie wybierz Zezwalaj na nieuwierzytelnione wywołania.
5. Kliknij Dalej.
W sekcji Środowisko wykonawcze wybierz Node.js 20.
W polu Punkt wejścia usuń tekst domyślny i wpisz projectManagementChatApp.
W sekcji Kod źródłowy wybierz Prześlij plik ZIP.
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 i wyodrębnia pliki komponentów w tym zasobie. Następnie Cloud Functions kopiuje pliki komponentów do funkcji w Cloud Functions.
W sekcji Plik ZIP prześlij plik ZIP pobrany z GitHuba, wyodrębniony i ponownie skompresowany:
1. Kliknij Przeglądaj.
2. Znajdź i wybierz plik ZIP.
3. Kliknij Otwórz.
Kliknij Wdróż.

Otworzy się strona Szczegóły funkcji w Cloud Functions, na której zobaczysz swoją funkcję z 2 wskaźnikami postępu: jeden dla wersji, a drugi dla usługi. Gdy oba wskaźniki postępu znikną i zostanie zastąpione przez znacznik wyboru, funkcja zostanie wdrożona i będzie gotowa do użycia.
Zmień 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: zmień wartość us-central1 na obsługiwaną lokalizację dla swojej funkcji w Cloud Functions.
Kliknij Wdróż.
Po wdrożeniu funkcji skopiuj adres URL aktywatora:
1. Na stronie Szczegóły funkcji kliknij Aktywator.
2. Skopiuj adres URL. Potrzebujesz go do skonfigurowania aplikacji Google Chat w sekcji poniżej.

interfejs wiersza poleceń gcloud

Sklonuj kod z GitHuba:

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

Przejdź do katalogu zawierającego kod aplikacji Google Chat do zarządzania projektem:
```
cd google-chat-samples/node/project-management-app
```
Aby ustawić zmienne środowiskowe, otwórz plik env.js:
1. Zastąp project-id identyfikatorem projektu Google Cloud.
2. Zastąp us-central1 lokalizacją projektu Google Cloud.

Wdróż funkcję 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ą funkcji w Cloud Functions, w której jest hostowana jej infrastruktura, na przykład us-central1.

Po zakończeniu wdrażania funkcji skopiuj właściwość url z odpowiedzi. To jest adres URL reguły, 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 w konsoli Google Cloud skonfigurować interfejs Chat API, podając informacje o aplikacji Google Chat, w tym jej nazwę, obsługiwane polecenia ukośnika i adres URL aktywatora funkcji w Cloud Functions aplikacji Google Chat, 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 > Interfejs API Google Chat > Zarządzaj > Konfiguracja.

Otwórz konfigurację interfejsu Chat API
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 go włączyć.
W sekcji Funkcjonalność wybierz Odbieranie wiadomości 1:1, Dołączanie do pokoi i rozmów grupowych.
W sekcji Ustawienia połączenia wybierz URL punktu końcowego HTTP.
W polu URL punktu końcowego HTTP wklej adres URL wyzwalacza skopiowany z wdrożenia funkcji w usłudze Cloud Functions w formacie https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Jeśli funkcja w Cloud Functions została wdrożona za pomocą interfejsu wiersza poleceń gcloud, jest to właściwość url.

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

W sekcji Polecenia po ukośniku kliknij Dodaj polecenie po ukośniku.

W przypadku każdego polecenia ukośnika opisanego w tabeli poniżej wpisz Nazwa, Identyfikator polecenia, Opis i wybierz, czy polecenie ukośnika otwiera okno dialogowe, a następnie kliknij Gotowe:

Nazwa	Identyfikator polecenia	Opis	Otwiera okno
`/createUserStory`	1	Utwórz sekwencję o określonym tytule.	Odznaczono
`/myUserStories`	2	Wyświetla listę wszystkich historii przypisanych do użytkownika.	Odznaczono
`/userStory`	3	Wyświetla bieżący stan określonej relacji.	Odznaczono
`/manageUserStories`	4	Otwiera okno, w którym można edytować historie.	Wybrano
`/cleanupUserStories`	5	usuwa wszystkie historie w pokoju;	Odznaczono

W 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 Loguj błędy w usłudze Logging.
Kliknij Zapisz. Wyświetli się wiadomość o zapisanej konfiguracji, co oznacza, że aplikacja Chat jest gotowa do testowania.

Testowanie aplikacji Google Chat

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

Otwórz Google Chat za pomocą konta Google Workspace, które zostało podane podczas dodawania siebie jako zaufanego testera.

Otwórz Google Chat
Kliknij Nowy czat.
W polu Dodaj co najmniej 1 osobę wpisz nazwę aplikacji Google Chat.
Wybierz aplikację Google Chat z wyników. Otworzy się czat.

Uwaga: jeśli nie widzisz aplikacji Google Chat na liście wyników, sprawdź, czy Twoje konto Google Workspace jest uwzględnione w ustawieniach widoczności na stronie Konfiguracja interfejsu Chat API w konsoli Google Cloud.
Na nowym czacie z aplikacją wpisz Hello i kliknij enter. Aplikacja do zarządzania projektem odpowiada za pomocą menu pomocy, które zawiera szczegółowe informacje o jej możliwościach.
Aby utworzyć wycieczkę, wpisz /createUserStory Test story na pasku wiadomości i wyślij. Aplikacja do zarządzania projektami Chat odpowiada, wyświetlając kartę z historią użytkownika, którą tworzy dla Ciebie za pomocą generatywnej AI z Vertex AI.
W konsoli sprawdź bazę danych Firestore, aby przejrzeć utworzone w niej rekordy dotyczące pokoju, do którego dodano aplikację Google Chat, użytkowników, którzy z nią weszli w interakcję, oraz utworzonej przez Ciebie historii użytkownika.

Otwórz Firestore
Wróć do Google Chat.

Otwórz Google Chat
Jeśli chcesz edytować artykuł, kliknij Edytuj. Gdy wszystko będzie gotowe, kliknij Zapisz.
Przetestuj wszystkie polecenia obsługiwane przez aplikację. Aby je zobaczyć, wpisz / lub wspomnij o aplikacji Google Chat.
Usuń historię użytkownika testowego, wykonując polecenie /cleanupUserStories. Możesz też usunąć lub odinstalować aplikację. Gdy to zrobisz, wszystkie historie użytkowników utworzone w tym pokoju zostaną usunięte.

Rozwiązywanie problemów

Gdy aplikacja Google Chat lub karta zwraca błąd, interfejs Google Chat wyświetla komunikat „Coś poszło nie tak”. lub „Nie można przetworzyć żądania”. Czasami interfejs czatu nie wyświetla żadnego komunikatu o błędzie, ale aplikacja lub karta czatu powoduje nieoczekiwany wynik, na przykład wiadomość na karcie może się nie wyświetlić.

Komunikat o błędzie może się nie wyświetlać w interfejsie czatu, ale gdy włączone jest rejestrowanie błędów w przypadku aplikacji czatu, dostępne są opisowe komunikaty o błędach i dane dziennika, które pomogą Ci je naprawić. 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 Google Cloud.

Uwaga: usunięcie projektu spowoduje, że:

Wszystkie dane projektu zostaną usunięte. Jeśli do tego samouczka został użyty istniejący projekt, jego usunięcie spowoduje również usunięcie wszystkich innych zadań w nim wykonanych.
Niestandardowe identyfikatory projektu zostaną utracone. Podczas tworzenia tego projektu możesz utworzyć niestandardowy identyfikator projektu, którego chcesz użyć w przyszłości. Aby zachować adresy URL, które używają identyfikatora projektu, np. adres URL na appspot.com, usuń wybrane zasoby w projekcie zamiast usuwać cały projekt.

Jeśli zamierzasz skorzystać z innych samouczków i krótkich wprowadzeń, ponowne wykorzystanie tych samych projektów może pomóc Ci uniknąć przekroczenia Iimitów związanych z projektami.

W konsoli Google Cloud otwórz stronę Zarządzanie zasobami. Kliknij Menu > Administracja > Zarządzaj zasobami.
Otwórz Menedżera zasobów
Na liście projektów wybierz projekt, który chcesz usunąć, a potem kliknij Usuń .
W oknie wpisz identyfikator projektu i kliknij Wyłącz, aby usunąć projekt.

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

Wymagania wstępne

Cele

Używane usługi

Architektura

Przygotowywanie środowiska

Tworzenie projektu Google Cloud

Google Cloud Console

interfejs wiersza poleceń gcloud

Włączanie płatności w projekcie Cloud

Google Cloud Console

interfejs wiersza poleceń gcloud

Włącz interfejsy API

Google Cloud Console

interfejs wiersza poleceń gcloud

Uwierzytelnianie i autoryzacja

Tworzenie i wdrażanie aplikacji Google Chat

Tworzenie bazy danych Firestore

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

spaces

userStories

users

Google Cloud Console

interfejs wiersza poleceń gcloud

Przeglądanie przykładowego kodu

Tworzenie i wdrażanie funkcji w Cloud Functions

Google Cloud Console

interfejs wiersza poleceń gcloud

Konfigurowanie aplikacji Google Chat w konsoli Google Cloud

Testowanie aplikacji Google Chat

Rozwiązywanie problemów

Czyszczenie danych

Powiązane artykuły

`spaces`

`userStories`

`users`