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

Rysunek 1. Charlie omawia z zespołem rozwój funkcji w 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 do zarządzania projektami korzysta z Vertex AI do pisania opisu historii, a potem udostępnia ją w pokoju.
Rysunek 4. Charlie klika Edytuj, aby dokończyć szczegóły historii. Opis wygenerowany przez AI jest prawidłowy, ale Charlie chce uzyskać więcej szczegółów, więc klika Rozwiń, aby Vertex AI dodał wymagania do opisu historii. 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, przeczytaj artykuł Uprawnienia wymagane do włączenia płatności.
- Używaj nieautoryzowanych wywołań funkcji Google Cloud, co możesz sprawdzić, określając, czy Twoja organizacja Google Cloud używa udostępniania z ograniczeniem 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

Twórz aplikację Google Chat, która zarządza projektami oprogramowania Agile.
Pomagaj użytkownikom w pisaniu historii za pomocą narzędzi do generowania treści wspomaganych przez sztuczną inteligencję w Vertex AI:
- generować i ponownie generować opisy opowiadań.
- 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 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ą zdarzenia interakcji z Google Chat (np. wiadomości) i na nie reagują. 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: latwa w użyciu bezserwerowa usługa obliczeniowa, która umożliwia tworzenie samodzielnych funkcji o ściśle zdefiniowanym przeznaczeniu reagujących na zdarzenia interakcji z czatem bez konieczności zarządzania serwerem ani środowiskiem wykonawczym. Aplikacja Google Chat do zarządzania projektami korzysta z 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 odpowiada na nie.

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 zautomatyzowane.
- 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, korzysta z Vertex AI do tworzenia scenariuszy użytkownika i przechowuje szczegóły scenariuszy w bazie danych Firestore. Poniższy diagram przedstawia architekturę zasobów Google Workspace i Google Cloud, których używasz.

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ć i aktualizować historie użytkowników.
2. Baza danych Firestore przechowuje, pobiera, aktualizuje i usuwa dane dotyczące historii użytkownika.
Cloud Functions zwraca odpowiedź HTTP do Google Chat, która wyświetla ją użytkownikowi jako wiadomość lub okno dialogowe.

Przygotowywanie środowiska

Z tej sekcji dowiesz się, jak utworzyć i skonfigurować projekt Google Cloud dla 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 projektu. Następnie kliknij Wybierz.
Uwaga: nie możesz znaleźć organizacji Google Workspace?
Oznacza to, że nie jesteś zalogowany(-a) 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 interfejsu wiersza poleceń Google Cloud (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 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 stronę Płatności w sekcji 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 Skonfiguruj 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 API Google Chat, 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 w prawidłowym 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, który został utworzony za pomocą polecenia gcloud config set project:
```
gcloud config set project PROJECT_ID
```
Zastąp PROJECT_ID identyfikatorem projektu utworzonego projektu 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 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 sytuacji środowiska produkcyjnego zazwyczaj tworzysz i dołączasz konto usługi do funkcji Cloud Functions.

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, która będzie hostować i uruchamiać kod aplikacji Chat w odpowiedzi na zdarzenia otrzymane z 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 pliku model/user-story.js i pliku model/user.js.

Baza danych aplikacji do zarządzania projektami korzysta z modelu danych NoSQL opartego na dokumentachuporządkowanych w zbiorach. Więcej informacji znajdziesz w artykule Model danych Firestore.

Na poniższym diagramie znajdziesz omówienie modelu 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 – przez dokument w podkolekcji users.

Wyświetlanie definicji kolekcji, dokumentów i polów

`spaces`

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

Pola
`Document ID`	`String` Unikalny identyfikator konkretnej przestrzeni, w której 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 ustawiono dla wiadomości na czacie 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 użytkownika przypisanego do wykonania zadania. Odpowiada `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` lub `High`.
`size`	`Enum` Ilość pracy. Możliwe wartości to `Small`, `Medium` i `Large`.
`status`	`Enum` Etap pracy. Możliwe wartości to `OPEN`, `STARTED` lub `COMPLETED`.
`title`	`String` Tytuł artykułu, czyli krótkie podsumowanie.

`users`

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

Pola
`Document ID`	`String` Unikalny identyfikator konkretnego użytkownika. Odpowiada `assignee` w `userStories` w Firebase i nazwie zasobu użytkownika w Chat API.
`avatarUrl`	`String` Adres URL pliku z obrazem awatara użytkownika w czacie.
`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 Nazwa bazy danych pozostaw pole Identyfikator bazy danych puste.(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 zapoznaj się z przykładowym kodem hostowanym na GitHubie.

Wyświetl w GitHubie

Oto krótkie 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ść 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 związane z pokoi czatu, użytkownikami i scenariuszami użytkownika. Funkcje w tych plikach są wywoływane przez funkcję app.js lub app-action-handler.js. Aby wykonywać operacje na bazie danych, funkcje w tych plikach wywołują funkcje w pliku 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 w celu przewidywania tekstu za pomocą generatywnej AI.
model/*.js: Te pliki zawierają definicje klas i typów wyliczeń, których aplikacja używa 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ść na karcie lub odpowiedź na działanie w dialogu.
views/widgets/*.js: Każdy plik tworzy instancję obiektu widgeta, 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 widżetu. 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łą repozytorium przykładowych danych Google Workspace.
W wyodrębnionym 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/
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 kliknij 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 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 hostowana jest jej infrastruktura, np. us-central1.

Po wdrożeniu funkcji skopiuj właściwość url z odpowiedzi. To jest 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 znajdziesz instrukcje konfigurowania interfejsu Chat API w konsoli Google Cloud za pomocą informacji o aplikacji Google Chat, w tym jej nazwy, obsługiwanych poleceń i adresu URL wywołania funkcji w chmurze, do której wysyłane są 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 Funkcje wybierz Odbieranie wiadomości 1:1 i Dołączanie do pokoi i rozmów grupowych.
W sekcji Ustawienia połączenia kliknij URL punktu końcowego HTTP.
W polu URL punktu końcowego HTTP wklej adres URL reguły 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 po ukośniku 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 konkretnym osobom i grupom w domenie Google Workspace i 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 Google Chat jest gotowa do testowania.

Testowanie aplikacji Google Chat

Przetestuj aplikację Google Chat do zarządzania projektami, wysyłając do niej wiadomość 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 projektami Chat odpowiada menu pomocy z informacjami o swoich możliwościach.
Aby utworzyć wycieczkę, wpisz /createUserStory Test story na pasku wiadomości i wyślij. Aplikacja do zarządzania projektami 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
Aby edytować historię, opcjonalnie 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ąć aplikację lub odinstalować ją. Gdy aplikacja zostanie usunięta, 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 udało się przetworzyć Twojej prośby”. Czasami interfejs czatu nie wyświetla żadnego komunikatu o błędzie, ale aplikacja Google Chat lub karta powoduje nieoczekiwany wynik, na przykład może nie wyświetlić się wiadomość na karcie.

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 poprawianiu błędów znajdziesz w artykule Rozwiązywanie problemów z błędami 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 produkty

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 polów

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`