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 Google Chat możesz też utworzyć za pomocą zdarzeń interakcji z interfejsem Google Chat API. Więcej informacji znajdziesz w artykule Rozszerzanie Google Chat.

Agenty 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 generowania pomysłów, który jest domyślnie udostępniany przez Google i pomaga użytkownikom firmowym w innowacjach i rozwiązywaniu problemów.

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

Na powyższym schemacie użytkownik korzystający z aplikacji do Google Chat zaimplementowanej za pomocą agenta AI Gemini Enterprise ma następujący przepływ informacji:

1. Użytkownik wysyła wiadomość do aplikacji do Google Chat na czacie lub w pokoju w Google Chat.
2. Logika aplikacji do 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 do Google Chat lub agent AI może zintegrować się z usługami Google Workspace, takimi jak Kalendarz czy Arkusze, lub innymi usługami Google, takimi jak Mapy Google czy YouTube.
5. Aplikacja do 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ę do Google Chat,
• skonfigurować aplikację do Google Chat,
• przetestować aplikację do Google Chat.

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ć płatności, 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 w chmurze Google. W jednym projekcie Google Cloud możesz włączyć co najmniej 1 interfejs API.

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

Włączanie API

Konfigurowanie ekranu zgody OAuth

Wszystkie aplikacje korzystające z OAuth 2.0 wymagają skonfigurowania 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 interfejsów API Google kliknij Menu > Platforma uwierzytelniania Google > Elementy marki.

   Przejdź na stronę Elementy marki

2. Jeśli platforma uwierzytelniania Google jest już skonfigurowana, możesz skonfigurować te ustawienia ekranu zgody OAuth w sekcjach Elementy marki, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat Platforma uwierzytelniania Google nie została jeszcze skonfigurowana, 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, na który użytkownicy mogą się kontaktować, jeśli mają pytania dotyczące zgody.
3. Kliknij Dalej.
4. W sekcji Odbiorcy wybierz Wewnętrzni.
5. Kliknij Dalej.
6. W sekcji Dane kontaktowe wpisz Adres e-mail, na który chcesz otrzymywać powiadomienia o 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 i jeśli się z nimi zgadzasz, zaznacz pole 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

Aby utworzyć nowe konto usługi z rolą Discovery Engine User:

Google Cloud Console

1. W konsoli Google Cloud kliknij Menu > Uprawnienia i administracja > Konta usługi.

   Otwórz stronę Konta usługi

   Pozostałe kroki będą wykonywane w konsoli Google Cloud.

2. Wybierz projekt w chmurze Google Cloud.
3. Kliknij Utwórz konto usługi.
4. Wpisz nazwę konta usługi, która ma być wyświetlana w konsoli Google Cloud.
   Uwaga: domyślnie Google tworzy unikalny identyfikator konta usługi na podstawie jego nazwy. Możesz zmodyfikować identyfikator w polu Identyfikator konta usługi. Później nie będzie już można go zmienić.
5. Jeśli nie chcesz konfigurować kontroli dostępu już teraz, kliknij Gotowe , aby zakończyć tworzenie konta usługi. Aby skonfigurować kontrolę dostępu, kliknij Utwórz i kontynuuj , a potem przejdź do następnego kroku.
   Uwaga: przyznanie kontroli dostępu w tym miejscu dotyczy tylko zasobów Google Cloud. Zasoby Google Workspace (takie jak Arkusze Google i Dysk Google) są udostępniane i konfigurowane oddzielnie.
6. Opcjonalnie: przypisz role do konta usługi, aby przyznać mu dostęp do zasobów projektu Google Cloud oprócz zasobów Google Workspace. Więcej informacji znajdziesz w artykule Zarządzanie dostępem do projektów, folderów i organizacji.
7. Kliknij Dalej.
8. 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 Przejmowanie tożsamości konta usługi.
9. Aby zakończyć tworzenie konta usługi, kliknij Gotowe.

   Zapisz adres e-mail konta usługi.

gcloud CLI

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ć mu dostęp do zasobów projektu Google Cloud oprócz zasobów Google Workspace. Więcej informacji znajdziesz w artykule Zarządzanie dostępem do projektów, folderów i organizacji.

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

Tworzenie klucza prywatnego

Ostrzeżenie: w tym przykładzie dla uproszczenia używamy wyeksportowanego klucza konta usługi. Eksportowanie klucza prywatnego nie jest zalecane w środowisku produkcyjnym, ponieważ nie powinien on być przechowywany w niezabezpieczonej lokalizacji, takiej jak kontrola źródła.

Więcej informacji o bezpiecznych implementacjach konta usługi i sprawdzonych metodach znajdziesz w artykule Wybieranie kiedy używać kont usługi.

Aby utworzyć i pobrać klucz prywatny dla konta usługi:

1. W konsoli Google Cloud kliknij Menu > Uprawnienia i administracja > Konta usługi.

   Otwórz stronę Konta usługi

   Pozostałe kroki będą wykonywane w konsoli Google Cloud.

2. Wybierz projekt w chmurze Google Cloud.
3. Kliknij adres e-mail konta usługi, dla którego chcesz utworzyć klucz.
4. Kliknij kartę Klucze.
5. Kliknij menu Dodaj klucz i wybierz Utwórz nowy klucz.
6. W polu Typ klucza wybierz JSON i kliknij Utwórz.

   Nowa para kluczy publicznych/prywatnych zostanie wygenerowana i pobrana na Twoje urządzenie jako plik klucza konta usługi. Zapisz pobrany plik JSON jako credentials.json w katalogu roboczym. Jest to jedyna kopia tego klucza. Po pobraniu pliku klucza nie można go pobrać ponownie. Informacje o tym, jak bezpiecznie przechowywać klucz, znajdziesz w artykule Sprawdzone metody zarządzania kluczami kont usługi.

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

Tworzenie i konfigurowanie projektu aplikacji do Google Chat

1. W Konsoli interfejsów API Google kliknij Menu > Administracja > Ustawienia.

   Otwórz Ustawienia w obszarze Administracja

2. Zanotuj wartości w polach Numer projektu i Identyfikator projektu.

3. Otwórz Gemini Enterprise:

   Otwórz Gemini Enterprise

4. Zanotuj Lokalizację i Identyfikator aplikacji.

5. Kliknij ten przycisk, 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 zanotowanych 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 polu Numer projektu GCP wklej numer projektu Google Cloud zanotowany 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 potrzebujesz identyfikatora wdrożenia, aby móc go użyć w następnym kroku.

Aby uzyskać identyfikator wdrożenia głównego:

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

Konfigurowanie aplikacji do Google Chat

Aby wdrożyć aplikację do Google Chat na potrzeby testowania, wykonaj te czynności za pomocą wdrożenia Apps Script:

1. W Konsoli interfejsów API wyszukaj Google Chat API, i kliknij Google Chat API.
2. Kliknij Zarządzaj.

3. Kliknij Konfiguracja i skonfiguruj aplikację do Google Chat:

   1. W polu Nazwa aplikacji wpisz GE Quickstart.
   2. W polu 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łączaj do pokoi i rozmów grupowych.
   5. W sekcji Ustawienia połączenia wybierz Projekt Apps Script.
   6. W polu Identyfikator wdrożenia wklej identyfikator wdrożenia głównego skopiowany wcześniej.
   7. W sekcji Widoczność wybierz Określeni użytkownicy i grupy w Twojej domenie i wpisz swój adres e-mail.

4. Kliknij Zapisz.

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

Testowanie aplikacji do Google Chat

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

1. Otwórz Google Chat za pomocą 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 Google Chat.

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

   Uwaga: jeśli nie widzisz aplikacji do Google Chat 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 interfejsów API Google.

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

   Aplikacja do Google Chat odpowie za pomocą odpowiedzi agenta Generowanie pomysłów.

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

Rozwiązywanie problemów

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

Chociaż komunikat o błędzie może się nie wyświetlać w interfejsie Google Chat, dostępne są opisowe komunikaty o błędach i dane logów, które pomogą Ci naprawić błędy gdy włączone jest rejestrowanie błędów w aplikacjach do Google Chat. Aby uzyskać pomoc w wyświetlaniu, debugowaniu i naprawianiu błędów, przeczytaj artykuł Rozwiązywanie problemów z Google Chat.

Zwalnianie miejsca

Aby uniknąć obciążania 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 w tym samouczku 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 appspot.com, usuń wybrane zasoby w projekcie zamiast całego projektu.

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 interfejsów API Google otwórz stronę Zarządzanie zasobami. Kliknij Menu > Uprawnienia i administracja > Zarządzanie 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 ściśle zintegrowanych z magazynami danych, interfejsami API i aplikacjami do Google Chat
• Tworzenie agentów Vertex AI ściśle zintegrowanych z magazynami danych, interfejsami API i aplikacjami do Google Chat
• Tworzenie aplikacji do Google Chat z agentem AI ADK
• Tworzenie aplikacji do Google Chat z agentem AI ADK udostępnianym przez A2A
• Tworzenie aplikacji do Google Chat z agentem AI ADK udostępnianym przez A2UI
• Sprawdzanie faktów za pomocą agenta AI ADK i modelu Gemini
• Planowanie podróży za pomocą agenta AI dostępnego w Google Workspace
• Integracja podstawowych koncepcji AI z aplikacjami do Google Chat
• Odpowiadanie na pytania na podstawie rozmów w Google Chat za pomocą aplikacji do Google Chat opartej na AI Gemini
• 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