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

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 historii oparte na technologii 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ć sposób wyświetlania go w Google Chat, np. nazwę oraz 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:

1. 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.

2. Google Chat wysyła synchroniczne żądanie HTTP do funkcji w Cloud Functions Punkt końcowy HTTP.

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

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

   2. Baza danych Firestore przechowuje, pobiera, aktualizuje i usuwa historię użytkownika i skalowalnych danych.

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

1. W konsoli Google Cloud otwórz menu . > Administracja Administracja > Utwórz projekt.

   Otwórz stronę Tworzenie projektu

2. 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.

3. W polu Lokalizacja kliknij Przeglądaj, aby wyświetlić potencjalne lokalizacje dla w projektach AI. Następnie kliknij Wybierz.
   Uwaga: nie możesz znaleźć swojej organizacji Google Workspace?
   Oznacza to, że nie korzystasz z żadnego konta Google Workspace. Niektóre funkcje opisane w dokumentacji dla deweloperów Google Workspace są dostępne tylko w przypadku projektów powiązane z organizacją.
4. 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`:

  gcloud projects create PROJECT_ID

  Zastąp PROJECT_ID, ustawiając identyfikator projektu, który chcesz utworzyć.

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

Jeśli nie możesz połączyć konta rozliczeniowego, nie masz uprawnień wymaganych do wprowadzenia tej zmiany. Więcej informacji: Uprawnienia wymagane do włączenia płatności

Google Cloud Console

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

   Otwórz Płatności za moje projekty

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

interfejs wiersza poleceń gcloud

1. Aby wyświetlić listę dostępnych kont rozliczeniowych, uruchom 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 dla Projekt Cloud, dla którego chcesz włączyć płatności.
   • BILLING_ACCOUNT_ID to identyfikator konta rozliczeniowego, z którym chcesz połączyć konto projekt 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 interfejsy Pub/Sub API i Cloud Run Admin API.

   Włączanie interfejsów API

2. Sprawdź, czy interfejsy API są włączone we właściwym Projekt Cloud, a następnie 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 ten, utworzona za pomocą polecenia gcloud config set project:

   gcloud config set project PROJECT_ID
   

   Zastąp PROJECT_ID identyfikatorem projektu utworzony przez Ciebie projekt Cloud.

2. 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.com
   

   Interfejsy 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: :

1. Utwórz bazę danych Firestore, w której będą przechowywane i pobierane historie użytkowników.
2. Możesz też przejrzeć przykładowy kod.
3. 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.
4. 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	String Unikalny identyfikator konkretnego miejsca, w którym tworzone są historie. Odpowiada nazwie zasobu pokoju w interfejsie Chat API.
userStories	Subcollection of Documents (userStories) 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	String Wyś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	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 Pilność potrzebna do ukończenia zadania. Możliwe wartości to Low, Medium oraz 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 oraz 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

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 polu Nazwij bazę danych pozostaw Identyfikator bazy danych jako (default).

   2. W polu Typ lokalizacji określ region bazy danych, na przykład us-central1 Aby uzyskać najlepszą skuteczność, wybierz takie samo lub w pobliżu jako funkcję w Cloud Functions aplikacji Google Chat.

6. 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-native
  

  Zastą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.

Wyświetl w 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.json i package-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.js i services/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.js lub app-action-handler.js. Do wykonywania operacji na bazie danych funkcje w te pliki 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 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 test w 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

1. Pobierz kod z GitHuba jako plik ZIP.

   Pobieranie pliku ZIP

2. Rozpakuj pobrany plik ZIP.

   Wyodrębniony folder zawiera całe przykłady z Google Workspace z repozytorium.

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

   Katalog główny pliku ZIP musi zawierać: 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 projekt Google Cloud powiązany z Twoim kontem Wybrano aplikację do obsługi czatu.

5. Kliknij Utwórz funkcję.

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

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

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

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

9. W sekcji Kod źródłowy wybierz Przesyłanie 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 do niego plik ZIP i rozpakowuje pliki komponentu. w tym zasobniku. Cloud Functions następnie skopiuje pliki komponentu do lub funkcji w Cloud Functions.

11. W pliku ZIP prześlij plik ZIP pobrany z GitHuba. wyodrębnione i ponownie skompresowane:

    1. Kliknij Przeglądaj.
    2. Przejdź do pliku ZIP i wybierz go.
    3. Kliknij Otwórz.

12. 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.

13. Zmień przykładowy kod, by 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 Wbudowany edytor.
    4. W edytorze wbudowanym otwórz plik env.js.
    5. Zastąp project-id identyfikatorem projektu Cloud.
    6. Opcjonalnie: zaktualizuj us-central1 o obsługiwana lokalizacja dla Twojej funkcji w Cloud Functions.

14. Kliknij Wdróż.

15. Po zakończeniu wdrażania funkcji skopiuj adres URL aktywatora:

    1. Na stronie Szczegóły funkcji kliknij Aktywator.
    2. Skopiuj adres URL. Jest on potrzebny do skonfigurowania aplikacji do obsługi czatu.

interfejs wiersza poleceń gcloud

1. Sklonuj kod z GitHuba:

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

2. Przełącz się na katalog, który zawiera kod tego projektu aplikacja do zarządzania 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
   

   Zamień REGION na Lokalizacja funkcji w Cloud Functions na której jest hostowana jego infrastruktura, na przykład us-central1.

1. Gdy funkcja zostanie wdrożona, skopiuj właściwość url z 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.

1. W konsoli Google Cloud kliknij Menu. > Więcej produktów > Google Workspace > Biblioteka usług > Interfejs 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. Kliknij przełącznik Włącz funkcje interaktywne, aby ustawić go w pozycji włączenia.

6. W sekcji Funkcjonalność wybierz Odbieranie wiadomości 1:1, Dołączanie do pokoi i rozmów grupowych.

7. W sekcji Ustawienia połączenia wybierz URL aplikacji.

8. 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 to url usłudze.

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

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

   2. 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
      /createUserStory	1	Utwórz artykuł o określonym tytule.	Odznaczono
      /myUserStories	2	Zawiera listę wszystkich artykułów przypisanych użytkownikowi.	Odznaczono
      /userStory	3	Wyświetla bieżący stan konkretnego artykułu.	Odznaczono
      /manageUserStories	4	Otwiera okno, w którym można edytować artykuły.	Wybrano
      /cleanupUserStories	5	Usuwa wszystkie artykuły w pokoju.	Odznaczono

10. 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.

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

12. 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.

1. Otwórz Google Chat za pomocą konta Google Workspace, którego używasz dodane podczas dodawania siebie jako zaufanego testera.

   Otwórz Google Chat

2. Kliknij Nowy czat.
3. W polu Dodaj co najmniej jedną osobę wpisz nazwę swojego aplikacja Google Chat.

4. Z wyników wybierz aplikację Google Chat. A Direct

   Uwaga: jeśli nie widzisz swojej aplikacji Google Chat na liście sprawdź, czy Twoje konto Google Workspace zostało uwzględnione Ustawienia widoczności konfiguracji interfejsu Chat API. w konsoli Google Cloud.
5. W nowym czacie z aplikacją wpisz Hello i naciśnij enter. Zarządzanie projektami Aplikacja do obsługi czatu odpowiada, podając menu pomocy ze szczegółowymi informacjami co potrafią.
6. Aby utworzyć relację, wpisz /createUserStory Test story w 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.

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

   Otwórz Firestore

8. Wróć do Google Chat.

   Otwórz Google Chat

9. Jeśli chcesz edytować artykuł, kliknij Edytuj. Jeśli jesteś zadowolony/zadowolona z kliknij Zapisz.
10. Przetestuj każde polecenie po ukośniku obsługiwane przez aplikację. Aby je zobaczyć, wpisz / lub wspomnij o aplikacji Google Chat.
11. Usuń historię użytkownika testowego, wysyłając /cleanupUserStories po 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.

Uwaga: usunięcie projektu spowoduje, że:

• Wszystkie dane projektu zostaną usunięte. Jeśli w tym samouczku był używany istniejący projekt, usunięcie go spowoduje też usunięcie wszystkich innych zadań wykonanych w tym projekcie.
• Niestandardowe identyfikatory projektu zostaną utracone. Być może w trakcie tworzenia tego projektu został utworzony niestandardowy identyfikator projektu, którego chcesz używać w przyszłości. Aby zachować adresy URL, które używają identyfikatora projektu, na przykład adres URL na appspot.com, usuń wybrane zasoby w projekcie, zamiast usuwać cały projekt.

Jeśli planujesz skorzystać z wielu samouczków i krótkich wprowadzeń, ponowne wykorzystanie tych samych projektów może pomóc Ci uniknąć przekroczenia limitów projektów.

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

   Otwórz menedżera zasobów

2. Na liście projektów wybierz projekt do usunięcia, a następnie kliknij Usuń .
3. 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