Tworzenie aplikacji Google Chat z agentem AI Gemini Enterprise

Na tej stronie dowiesz się, jak utworzyć dodatek do Google Workspace, który działa w Google Chat i współpracuje z agentem AI Gemini Enterprise.

Uwaga: w Google Chat dodatki są widoczne dla użytkowników jako aplikacje Google Chat. Aplikację do obsługi Google Chat możesz też utworzyć za pomocą wydarzeń interakcji interfejsu Google Chat API. Więcej informacji znajdziesz w artykule Rozszerzanie Google Chat – omówienie.

Agenci AI autonomicznie postrzegają swoje otoczenie, rozumują i wykonują złożone, wieloetapowe działania, aby osiągnąć określony cel. W tym samouczku użyjesz agenta do generowania pomysłów, który jest domyślnie udostępniany przez Google i pomaga użytkownikom biznesowym w tworzeniu innowacji i rozwiązywaniu problemów.

Ten diagram przedstawia architekturę i wzorzec przesyłania wiadomości:

Na powyższym diagramie użytkownik wchodzący w interakcję z aplikacją do obsługi czatu zaimplementowaną za pomocą agenta AI Gemini Enterprise ma następujący przepływ informacji:

1. Użytkownik wysyła wiadomość do aplikacji w Google Chat, w wiadomości bezpośredniej lub w pokoju czatu.
2. Logika aplikacji Google Chat zaimplementowana w Apps Script lub jako serwer WWW z punktami końcowymi HTTP odbiera i przetwarza wiadomość.
3. Agent AI Gemini Enterprise odbiera i przetwarza interakcję.
4. Opcjonalnie aplikacja Google Chat lub agent AI może być zintegrowana z usługami Google Workspace, takimi jak Kalendarz czy Arkusze, lub z innymi usługami Google, takimi jak Mapy Google czy YouTube.
5. Aplikacja Google Chat asynchronicznie wysyła odpowiedzi za pomocą interfejsu Google Chat API, aby informować o postępach agenta AI.
6. Odpowiedzi są dostarczane do użytkownika.

Cele

• skonfigurować środowisko,
• wdrożyć aplikację Google Chat;
• Skonfiguruj aplikację Google Chat.
• Przetestuj aplikację do obsługi czatu.

Wymagania wstępne

• Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
• Projekt Google Cloud z włączonymi płatnościami. Aby sprawdzić, czy w istniejącym projekcie włączone są płatności, przeczytaj artykuł Sprawdzanie stanu rozliczeń projektów. Aby utworzyć projekt i skonfigurować rozliczenia, przeczytaj artykuł Tworzenie projektu Google Cloud.
• Aplikacja Gemini Enterprise skonfigurowana z Google Identity jako dostawcą tożsamości.

Konfigurowanie środowiska

Włączanie interfejsu Chat API

Zanim zaczniesz korzystać z interfejsów API Google, musisz je włączyć w projekcie Google Cloud. W jednym projekcie Google Cloud możesz włączyć co najmniej 1 interfejs API.

W konsoli Google Cloud włącz interfejs Google Chat API.

Włączanie interfejsu API

Konfigurowanie ekranu zgody OAuth

Wszystkie aplikacje korzystające z OAuth 2.0 wymagają konfiguracji ekranu zgody. Skonfigurowanie ekranu zgody OAuth aplikacji określa, co jest wyświetlane użytkownikom i osobom sprawdzającym aplikację, oraz rejestruje aplikację, aby można ją było później opublikować.

1. W konsoli Google Cloud otwórz Menu  > Google Auth platform > Branding.

   Otwórz Elementy marki

2. Jeśli masz już skonfigurowany Google Auth platform, możesz skonfigurować te ustawienia ekranu zgody OAuth w sekcjach Branding, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat Google Auth platform Jeszcze nie skonfigurowano, kliknij Rozpocznij:
1. W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz nazwę aplikacji.
2. W polu Adres e-mail dla użytkowników potrzebujących pomocy wybierz adres e-mail, pod którym użytkownicy mogą się z Tobą kontaktować, jeśli mają pytania dotyczące ich zgody.
3. Kliknij Dalej.
4. W sekcji Odbiorcy wybierz Wewnętrzny.
5. Kliknij Dalej.
6. W sekcji Dane kontaktowe wpisz adres e-mail, na który będziesz otrzymywać powiadomienia o wszelkich zmianach w projekcie.
7. Kliknij Dalej.
8. W sekcji Zakończ zapoznaj się z zasadami dotyczącymi danych użytkownika w usługach interfejsu API Google, a jeśli je akceptujesz, kliknij Akceptuję zasady dotyczące danych użytkownika w usługach interfejsu API Google.
9. Kliknij Dalej.
10. Kliknij Utwórz.
3. Na razie możesz pominąć dodawanie zakresów. W przyszłości, gdy będziesz tworzyć aplikację do użytku poza organizacją Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny. Następnie dodaj zakresy autoryzacji wymagane przez aplikację. Więcej informacji znajdziesz w pełnym przewodniku Konfigurowanie zgody OAuth.

Tworzenie konta usługi w konsoli Google Cloud

Utwórz nowe konto usługi z rolą Discovery Engine User, wykonując te czynności:

Konsola Google Cloud

1. W konsoli Google Cloud otwórz Menu  > Uprawnienia i administracja > Konta usługi.

   Otwórz stronę Konta usługi

2. Kliknij Utwórz konto usługi.
3. Wpisz szczegóły konta usługi, a następnie kliknij Utwórz i kontynuuj.
   Uwaga: domyślnie Google tworzy unikalny identyfikator konta usługi. Jeśli chcesz zmienić identyfikator, zmodyfikuj go w polu identyfikatora konta usługi.
4. Opcjonalnie: przypisz role do konta usługi, aby przyznać dostęp do zasobów projektu Google Cloud. Więcej informacji znajdziesz w artykule Przyznawanie, zmienianie i odbieranie uprawnień dostępu do zasobów.
5. Kliknij Dalej.
6. Opcjonalnie: wpisz użytkowników lub grupy, które mogą zarządzać tym kontem usługi i wykonywać na nim działania. Więcej informacji znajdziesz w artykule Zarządzanie przyjmowaniem tożsamości konta usługi.
7. Kliknij Gotowe. Zanotuj adres e-mail konta usługi.

interfejs wiersza poleceń gcloud

1. Utwórz konto usługi:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. Opcjonalnie: przypisz role do konta usługi, aby przyznać dostęp do zasobów projektu Google Cloud. Więcej informacji znajdziesz w artykule Przyznawanie, zmienianie i odbieranie uprawnień dostępu do zasobów.

Konto usługi pojawi się na stronie kont usługi.

Tworzenie klucza prywatnego

Ostrzeżenie: w tym przykładzie użyto wyeksportowanego klucza konta usługi, aby uprościć kod. Eksportowanie klucza prywatnego nie jest zalecane w środowisku produkcyjnym, ponieważ nie powinien on być przechowywany w niebezpiecznym miejscu, np. w systemie kontroli wersji.

Więcej informacji o bezpiecznych wdrożeniach kont usługi i sprawdzonych metodach znajdziesz w artykule Wybieranie sytuacji, w których należy używać kont usługi.

Aby utworzyć i pobrać klucz prywatny dla konta usługi, wykonaj te czynności:

1. W konsoli Google Cloud otwórz Menu  > Uprawnienia i administracja > Konta usługi.

   Otwórz stronę Konta usługi

2. Wybierz konto usługi.
3. Kliknij Klucze > Dodaj klucz > Utwórz nowy klucz.
4. Wybierz JSON, a następnie kliknij Utwórz.

   Nowa para kluczy publicznych/prywatnych zostanie wygenerowana i pobrana na Twoje urządzenie jako nowy plik. Zapisz pobrany plik JSON jako credentials.json w katalogu roboczym. Jest to jedyna kopia tego klucza. Informacje o tym, jak bezpiecznie przechowywać klucz, znajdziesz w artykule Zarządzanie kluczami konta usługi.

5. Kliknij Zamknij.

Więcej informacji o kontach usługi znajdziesz w dokumentacji Cloud IAM w Google Cloud.

Tworzenie i konfigurowanie projektu aplikacji do obsługi Google Chat

1. W konsoli Google Cloud otwórz Menu  > Administracja > Ustawienia.

   Otwórz Ustawienia w obszarze Administracja

2. Zwróć uwagę na pola Numer projektu i Identyfikator projektu.

3. Otwórz Gemini Enterprise:

   Otwieranie Gemini Enterprise

4. Zapisz Lokalizację i Identyfikator aplikacji.

5. Kliknij przycisk poniżej, aby otworzyć projekt Apps Script GE AI Agent Quickstart.

   Otwórz projekt

6. Kliknij  Przegląd > Utwórz kopię.

7. W projekcie Apps Script kliknij  Ustawienia projektu > Edytuj właściwości skryptu > Dodaj właściwość skryptu, aby dodać te właściwości skryptu:

   1. REASONING_ENGINE_RESOURCE_NAME z zasobem aplikacji Gemini Enterprise utworzonym na podstawie informacji podanych w poprzednich krokach.

      projects/PROJECT_ID/locations/APP_LOCATION/collections/default_collection/engines/APP_ID
      

   2. SERVICE_ACCOUNT_KEY z kluczem JSON z konta usługi pobranym w poprzednich krokach, np. { ... }.

8. Kliknij Zapisz właściwości skryptu.

9. W projekcie Apps Script kliknij  Ustawienia projektu.

10. W sekcji Projekt Google Cloud Platform (GCP) kliknij Zmień projekt.

11. W sekcji Numer projektu GCP wklej numer projektu Google Cloud, który został zapisany w poprzednich krokach.

12. Kliknij Ustaw projekt. Projekt w chmurze i projekt Apps Script są teraz połączone.

Tworzenie wdrożenia testowego

Do tego projektu Apps Script potrzebny jest identyfikator wdrożenia, aby można go było użyć w następnym kroku.

Aby uzyskać identyfikator wdrożenia głównego, wykonaj te czynności:

1. W projekcie Apps Script aplikacji do Google Chat kliknij Wdróż > Testuj wdrożenia.
2. W sekcji Identyfikator wdrożenia głównego kliknij Kopiuj.
3. Kliknij Gotowe.

Konfigurowanie aplikacji Google Chat

Korzystając z wdrożenia Apps Script, wykonaj te czynności, aby wdrożyć aplikację Google Chat do testowania:

1. W konsoli wyszukaj Google Chat API i kliknij Google Chat API.
2. Kliknij Zarządzaj.

3. Kliknij Konfiguracja i skonfiguruj komunikator:

   1. W polu Nazwa aplikacji wpisz GE Quickstart.
   2. W polu Avatar URL (Adres URL awatara) wpisz https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png.
   3. W polu Opis wpisz GE Quickstart.
   4. W sekcji Funkcje wybierz Dołączanie do pokoi i rozmów grupowych.
   5. W sekcji Ustawienia połączenia wybierz Projekt Apps Script.
   6. W polu Identyfikator wdrożenia wklej skopiowany wcześniej identyfikator wdrożenia głównego.
   7. W sekcji Widoczność kliknij Określeni użytkownicy i grupy w Twojej domenie i wpisz swój adres e-mail.

4. Kliknij Zapisz.

Aplikacja Google Chat jest gotowa do odpowiadania na wiadomości.

Testowanie aplikacji Google Chat

Aby przetestować aplikację do Google Chat, otwórz czat z aplikacją i wyślij wiadomość:

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 do obsługi czatu.

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

   Uwaga: jeśli nie widzisz swojej aplikacji do obsługi czatu na liście wyników, sprawdź, czy Twoje konto Google Workspace zostało uwzględnione w ustawieniach Widoczność na stronie Konfiguracja interfejsu Chat API w konsoli Google Cloud.

5. Na nowym czacie z aplikacją wpisz I need to find ideas! i naciśnij enter.

   Aplikacja Google Chat odpowie za pomocą odpowiedzi agenta Domyślne generowanie pomysłów.

Aby dodać zaufanych testerów i dowiedzieć się więcej o testowaniu funkcji interaktywnych, przeczytaj artykuł Testowanie funkcji interaktywnych w aplikacjach Google Chat.

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

Ostrzeżenie: usunięcie projektu spowoduje, że:

• Wszystkie dane projektu zostaną usunięte. Jeśli na potrzeby tego samouczka używasz istniejącego projektu, po jego usunięciu usuniesz też wszystkie inne prace wykonane w tym projekcie.
• Niestandardowe identyfikatory projektu zostaną utracone. Podczas tworzenia tego projektu możesz utworzyć niestandardowy identyfikator projektu, którego chcesz używać w przyszłości. Aby zachować adresy URL, które używają identyfikatora projektu, np. adres URL w domenie 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.

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

   Otwórz Resource Manager

2. Z listy projektów wybierz projekt do usunięcia, a potem kliknij Usuń .
3. W oknie wpisz identyfikator projektu i kliknij Wyłącz, aby usunąć projekt.

Powiązane artykuły

• Tworzenie agentów Gemini Enterprise, którzy są ściśle zintegrowani z magazynami danych Workspace, interfejsami API i aplikacjami Google Chat
• Tworzenie agentów AI Vertex AI ściśle zintegrowanych z magazynami danych, interfejsami API i aplikacjami do obsługi czatu w Workspace
• Tworzenie aplikacji do Google Chat z agentem AI ADK
• Tworzenie aplikacji do Google Chat z agentem AI pakietu ADK udostępnianym przez A2A
• Tworzenie aplikacji do Google Chat z agentem AI pakietu ADK udostępnianym przez A2UI
• Sprawdzanie faktów za pomocą agenta AI z pakietu ADK i modelu Gemini
• Planowanie podróży z pomocą agenta AI dostępnego w różnych usługach Google Workspace
• Integracja podstawowych koncepcji AI z aplikacjami Google Chat
• Odpowiadanie na pytania na podstawie rozmów na czacie za pomocą aplikacji Gemini AI Chat
• Reagowanie na incydenty za pomocą Google Chat, Vertex AI, Apps Script i uwierzytelniania użytkowników
• Zarządzanie projektami za pomocą Google Chat, Vertex AI i Firestore