Tworzenie aplikacji Google Chat z agentem AI ADK

Z tej strony dowiesz się, jak utworzyć dodatek do Google Workspace, który działa w Google Chat i współpracuje z agentem AI z pakietu Agent Development Kit (ADK) hostowanym w Vertex AI Agent Engine.

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 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 wdrożysz przykładową aplikację wieloagentową ADK LLM Auditor która krytykuje i poprawia fakty za pomocą Gemini i groundingu w wyszukiwarce Google.

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

Na powyższym schemacie użytkownik wchodzący w interakcję z aplikacją do Google Chat zaimplementowaną za pomocą agenta AI z pakietu ADK 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 zaimplementowany za pomocą pakietu ADK i hostowany w Vertex AI Agent Engine odbiera i przetwarza interakcję.
4. Opcjonalnie aplikacja do Google Chat lub agent AI mogą być zintegrowane z usługami Google Workspace, takimi jak Kalendarz lub Arkusze, albo z innymi usługami Google, takimi jak Mapy Google lub YouTube.
5. Aplikacja do Google Chat asynchronicznie wysyła odpowiedzi za pomocą Google Chat API, aby informować o postępach agenta AI.
6. Odpowiedzi są dostarczane do użytkownika.

Cele

• Skonfiguruj środowisko.
• Wdróż agenta AI z pakietu ADK.
• Wdróż aplikację do Google Chat.
• Skonfiguruj aplikację do Google Chat.
• Przetestuj 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.

Konfigurowanie środowiska

Włączanie interfejsów Google Cloud API

Zanim zaczniesz korzystać z interfejsów Google API, 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 interfejsy Google Chat, Vertex AI i Cloud Resource Manager API.

  Włączanie interfejsów 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 interfejsów API Google kliknij Menu > Platforma uwierzytelniania Google > Elementy marki.

   Przejdź na stronę Elementy marki

2. Jeśli platforma uwierzytelniania Google została 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 utworzysz 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 ekranu zgody OAuth.

Tworzenie konta usługi w konsoli Google Cloud

Aby utworzyć nowe konto usługi z rolą Vertex AI User , wykonaj te czynności:

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. Identyfikator możesz zmodyfikować 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.

   Zanotuj 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 kont 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 niezabezpieczonym miejscu, np. w systemie kontroli wersji.

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, wykonaj te czynności:

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.

Wdrażanie agenta AI z pakietu ADK

1. Otwórz przykładową aplikację LLM Auditor w Vertex AI Agent Garden:

   Otwórz przykład

2. Kliknij Wdróż.

3. Jeśli pojawi się taka prośba, wybierz projekt Google Cloud.

4. Kliknij Wdróż w Cloud Shell.

5. Jeśli pojawi się taka prośba, kliknij Autoryzuj i przejdź przez proces OAuth w Cloud Shell.

6. Gdy Cloud Shell zostanie w pełni załadowany, naciśnij Enter , aby uruchomić wstępnie załadowany wiersz poleceń i rozpocząć wdrażanie.

7. Jeśli pojawi się prośba o wpisanie regionu, naciśnij Enter , aby użyć domyślnego.

8. Po zakończeniu otwórz Vertex AI Agent Engine:

   Otwórz Vertex AI Agent Engine

9. Kliknij , aby skopiować nazwę zasobu nowo wdrożonego agenta z tabeli.

Tworzenie i konfigurowanie projektu aplikacji do Google Chat

1. Aby otworzyć projekt Apps Script Krótkie wprowadzenie do agenta AI z pakietu ADK , kliknij ten przycisk.

   Otwórz projekt

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

3. 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 nazwą zasobu agenta Vertex AI skopiowaną w poprzednich krokach.
   2. SERVICE_ACCOUNT_KEY z kluczem JSON konta usługi pobranym w poprzednich krokach, np. { ... }.

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

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

   Otwórz Ustawienia w obszarze Administracja

6. W polu Numer projektu skopiuj wartość.

7. W projekcie Apps Script kliknij Ustawienia projektu.

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

9. W polu Numer projektu GCP wklej numer projektu Google Cloud skopiowany w poprzednich krokach.

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

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

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 ADK Quickstart.
   2. W polu URL awatara wpisz https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png.
   3. W polu Opis wpisz ADK 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ść 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 na koncie 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 jest uwzględnione w ustawieniach Widoczność na stronie Konfiguracja interfejsu Chat API w Konsoli interfejsów API Google.

5. Na nowym czacie z aplikacją wpisz The Eiffel Tower was completed in 1900 i naciśnij enter.

   Aplikacja do Google Chat odpowie za pomocą odpowiedzi podagentów Krytyk i Poprawiacz.

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 generuje nieoczekiwany wynik, np. może się nie pojawić wiadomość na karcie.

Chociaż w interfejsie Google Chat może się nie wyświetlać komunikat o błędzie, 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 i naprawianie błędów w 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.

Uwaga: usunięcie projektu ma te skutki:

• 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 aplikacji do Google Chat z agentem AI z pakietu ADK udostępnianym przez A2A
• Tworzenie aplikacji do Google Chat z agentem AI z pakietu ADK udostępnianym przez A2UI
• Tworzenie agentów Gemini Enterprise, którzy są ściśle zintegrowani z magazynami danych, interfejsami API i aplikacjami do Google Chat
• Tworzenie agentów Vertex AI, którzy są ściśle zintegrowani z magazynami danych, interfejsami API i aplikacjami do Google Chat
• Sprawdzanie faktów za pomocą agenta AI z pakietu ADK i modelu Gemini
• Planowanie podróży za pomocą agenta AI dostępnego w Google Workspace
• Tworzenie aplikacji do Google Chat z agentem AI Gemini Enterprise
• 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