Sprawdzanie faktów za pomocą agenta AI ADK i modelu Gemini

Poziom kodowania: Zaawansowany
Czas trwania: 30 minut
Typ projektu: Funkcja niestandardowa

Przegląd

Niestandardowa funkcja weryfikacji faktów dla Arkuszy Google, która ma być używana jako powiązany projekt Apps Script obsługiwany przez agenta Vertex AI i model Gemini.

Ten przykład pokazuje, jak można wykorzystać dwa potężne typy zasobów sztucznej inteligencji bezpośrednio w arkuszach kalkulacyjnych Arkuszy Google:

1. Agenci AI zapewniają zaawansowane możliwości wnioskowania wieloetapowego i wielonarzędziowego przy użyciu agentów ADK wdrożonych w Vertex AI Agent Engine.
2. Modele AI do zaawansowanego rozumienia, generowania i streszczania treści za pomocą modeli Gemini z Vertex AI.

Cele

• Zrozum, co robi to rozwiązanie.
• Zrozum, jak wdrożono rozwiązanie.
• Wdróż agenta Vertex AI.
• Skonfiguruj skrypt.
• Uruchom skrypt.

Informacje o rozwiązaniu

Funkcja niestandardowa Arkuszy nosi nazwę FACT_CHECK i działa jako rozwiązanie kompleksowe. Analizuje ona wypowiedź, uzasadnia odpowiedź, korzystając z najnowszych informacji z internetu, i zwraca wynik w potrzebnym formacie:

• Użycie:
  • =FACT_CHECK("Your statement here"), aby uzyskać zwięzłe i podsumowane wyniki.
  • =FACT_CHECK("Your statement here", "Your output formatting instructions here") dla określonego formatu wyjściowego.
• Uzasadnienie: LLM Auditor ADK AI Agent (przykład Pythona).
• Formatowanie wyjściowe: model Gemini.

To rozwiązanie żąda interfejsów API REST Vertex AI przy użyciu aplikacji UrlFetchApp.

Architektura

Poniższy diagram przedstawia architekturę zasobów Google Workspace i Google Cloud używanych przez funkcję niestandardową.

Wymagania wstępne

Aby użyć tego przykładu, musisz spełnić te wymagania wstępne:

• Konto Google (w przypadku kont Google Workspace może być wymagana zgoda administratora).

• przeglądarkę internetową z dostępem do internetu,

• Wymagania wstępne dotyczące agenta ADK audytora LLM

  • Python 3.11+: Aby przeprowadzić instalację, postępuj zgodnie z instrukcjami na oficjalnej stronie internetowej Pythona.
  • Python Poetry: aby zainstalować to narzędzie, postępuj zgodnie z instrukcjami na oficjalnej stronie Poetry.
  • Interfejs wiersza poleceń Google Cloud: aby go zainstalować, postępuj zgodnie z instrukcjami na oficjalnej stronie Google Cloud.

Przygotuj środowisko

W tej sekcji dowiesz się, jak utworzyć i skonfigurować projekt Google Cloud.

Utwórz projekt Google Cloud

Konsola Google Cloud

1. W konsoli Google Cloud kliknij Menu  > Administracja > Utwórz projekt.

   Otwórz stronę Tworzenie projektu

2. W polu Nazwa projektu wpisz opisową nazwę projektu.

   Opcjonalnie: aby edytować identyfikator projektu, kliknij Edytuj. Po utworzeniu projektu nie można zmienić jego identyfikatora, więc wybierz taki, który będzie Ci odpowiadać przez cały okres jego istnienia.

3. W polu Lokalizacja kliknij Przeglądaj, aby wyświetlić potencjalne lokalizacje projektu. Następnie kliknij Wybierz.
   Uwaga: nie możesz znaleźć organizacji Google Workspace?
   Oznacza to, że nie korzystasz z konta Google Workspace. Niektóre funkcje opisane w dokumentacji dla deweloperów Google Workspace są dostępne wyłącznie w projektach powiązanych z daną organizacją.
4. Kliknij Utwórz. Konsola Google Cloud przejdzie do strony Pulpitu nawigacyjnego, a Twój projekt zostanie utworzony w ciągu kilku minut.

interfejs wiersza poleceń gcloud

W jednym z następujących środowisk programistycznych uzyskaj dostęp do interfejsu wiersza poleceń Google Cloud (gcloud):

• Cloud Shell: Aby korzystać z terminala online z już skonfigurowanym interfejsem wiersza poleceń gcloud, aktywuj Cloud Shell.
  Aktywuj Cloud Shell
• Powłoka lokalna: aby użyć lokalnego środowiska programistycznego, zainstaluj i zainicjuj interfejs wiersza poleceń gcloud.
  Aby utworzyć projekt w chmurze, użyj polecenia gcloud projects create:

  gcloud projects create PROJECT_ID

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

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

Jeśli nie możesz połączyć konta rozliczeniowego, nie masz uprawnień niezbędnych do wprowadzenia tej zmiany. Aby uzyskać więcej informacji, zobacz Uprawnienia wymagane do włączenia rozliczeń.

Konsola Google Cloud

1. W konsoli Google Cloud przejdź do sekcji Rozliczenia. Trzask Menu > Rozliczanie > Moje projekty.

   Przejdź do rozliczeń moich projektów

2. W polu Wybierz organizację wybierz organizację powiązaną z projektem Google Cloud.
3. W wierszu projektu otwórz menu Akcje (), kliknij Zmień rozliczenia i wybierz konto rozliczeniowe w chmurze.
4. Kliknij Ustaw konto.

interfejs wiersza poleceń gcloud

1. Aby wyświetlić listę dostępnych kont rozliczeniowych, uruchom:

   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 projektu Cloud, w którym chcesz włączyć płatności.
   • BILLING_ACCOUNT_ID to identyfikator konta rozliczeniowego, które ma zostać połączone z projektem Google Cloud.

Włączanie interfejsu Vertex AI API

Konsola Google Cloud

1. Włącz interfejs Vertex AI API w konsoli Google Cloud.

   Włączanie interfejsów API

2. Sprawdź, czy włączasz interfejs API Vertex AI w odpowiednim projekcie w chmurze, a następnie kliknij Dalej.

3. Sprawdź, czy włączasz odpowiedni interfejs API, a potem kliknij Włącz.

interfejs wiersza poleceń gcloud

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

2. Włącz interfejs Vertex AI API za pomocą polecenia gcloud services enable:

   gcloud services enable aiplatform.googleapis.com

Utwórz konto usługi w konsoli Google Cloud

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

Konsola Google Cloud

1. W konsoli Google Cloud otwórz Menu  > 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 potem 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. Aby uzyskać więcej informacji, zapoznaj się z sekcją Przyznawanie, zmienianie i cofanie dostępu do zasobów.
5. Kliknij Dalej.
6. Opcjonalnie: wprowadź użytkowników lub grupy, które mogą zarządzać tym kontem usługi i wykonywać za jego pomocą działania. Więcej informacji znajdziesz w artykule Zarządzanie przejmowaniem 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. Aby uzyskać więcej informacji, zapoznaj się z sekcją Przyznawanie, zmienianie i cofanie dostępu do zasobów.

Konto usługi pojawi się na stronie kont usługi. Następnie utwórz klucz prywatny dla konta usługi.

Tworzenie klucza prywatnego

Ostrzeżenie: w tym przykładzie użyto wyeksportowanego klucza konta usługi, aby uprościć kod. Nie zaleca się eksportowania klucza prywatnego w środowisku produkcyjnym, ponieważ nie powinien być on przechowywany w niezabezpieczonej lokalizacji, takiej jak system kontroli źródła.

Aby dowiedzieć się więcej o bezpiecznych wdrożeniach kont usług i najlepszych praktykach, zobacz Wybór momentu korzystania z kont usług.

Aby utworzyć i pobrać klucz prywatny dla konta usługi, wykonaj następujące kroki:

1. W konsoli Google Cloud otwórz Menu  > 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 swoim katalogu roboczym. Jest to jedyna kopia tego klucza. Informacje o bezpiecznym przechowywaniu klucza znajdziesz w artykule Zarządzanie kluczami kont usługowych.

5. Kliknij Zamknij.

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

Wdróż agenta AI LLM Auditor ADK

1. Jeśli nie zostało to jeszcze zrobione, uwierzytelnij się na koncie Google Cloud i skonfiguruj Google Cloud CLI do korzystania z Twojego projektu Google Cloud.

   gcloud auth application-default login
   gcloud config set project PROJECT_ID
   gcloud auth application-default set-quota-project PROJECT_ID

   Zastąp PROJECT_ID identyfikatorem utworzonego projektu w Cloud.

2. Pobierz to repozytorium GitHub

   Pobierz

3. W preferowanym lokalnym środowisku programistycznym wypakuj pobrany plik archiwum i otwórz katalog adk-samples/python/agents/llm-auditor.

   unzip adk-samples-main.zip
   cd adk-samples-main/python/agents/llm-auditor

4. Utwórz nowy kontener Cloud Storage dedykowany agentowi ADK.

   gcloud storage buckets create gs://CLOUD_STORAGE_BUCKET_NAME --project=PROJECT_ID --location=PROJECT_LOCATION

   Zastąp następujące elementy:

   1. CLOUD_STORAGE_BUCKET_NAME z unikalną nazwą kontenera, której chcesz użyć.
   2. PROJECT_ID z identyfikatorem utworzonego projektu Cloud.
   3. PROJECT_LOCATION z lokalizacją utworzonego projektu w chmurze.

5. Ustaw następujące zmienne środowiskowe:

   export GOOGLE_GENAI_USE_VERTEXAI=true
   export GOOGLE_CLOUD_PROJECT=PROJECT_ID
   export GOOGLE_CLOUD_LOCATION=PROJECT_LOCATION
   export GOOGLE_CLOUD_STORAGE_BUCKET=CLOUD_STORAGE_BUCKET_NAME

   Zastąp następujące elementy:

   1. CLOUD_STORAGE_BUCKET_NAME nazwą utworzonego zasobnika.
   2. PROJECT_ID z identyfikatorem projektu w chmurze, który utworzyłeś.
   3. PROJECT_LOCATION z lokalizacją utworzonego projektu w chmurze.

6. Zainstaluj i wdroż agenta ADK ze środowiska wirtualnego.

   python3 -m venv myenv
   source myenv/bin/activate
   poetry install --with deployment
   python3 deployment/deploy.py --create

7. Pobierz identyfikator agenta. Będzie on potrzebny później do skonfigurowania funkcji niestandardowej.

   python3 deployment/deploy.py --list

Sprawdź przykładowy kod

Opcjonalnie, przed utworzeniem nowego arkusza kalkulacyjnego, poświęć chwilę na przejrzenie i zapoznanie się z przykładowym kodem udostępnionym w serwisie GitHub.

Wyświetl w GitHubie

Utwórz i skonfiguruj w nowym arkuszu kalkulacyjnym

1. Kliknij poniższy przycisk i utwórz pełną kopię przykładowego arkusza kalkulacyjnego Arkuszy Google, łącznie z powiązanym z nim projektem Apps Script.

   Kopiuj arkusz kalkulacyjny Arkuszy Google

2. W nowo utworzonym arkuszu kalkulacyjnym przejdź do Rozszerzenia > Apps Script.

3. W projekcie Apps Script przejdź do Ustawień projektu, kliknij Edytuj właściwości skryptu, a następnie kliknij Dodaj właściwość skryptu, aby dodać następujące właściwości skryptu:

   1. LOCATION z lokalizacją projektu Google Cloud utworzonego w poprzednich krokach, takich jak us-central1.
   2. GEMINI_MODEL_ID z modelem Gemini, którego chcesz użyć, takim jak gemini-2.5-flash-lite.
   3. REASONING_ENGINE_ID z identyfikatorem agenta LLM Auditor ADK wdrożonego w poprzednich krokach, takich jak 1234567890.
   4. SERVICE_ACCOUNT_KEY z kluczem JSON z konta usługi pobranego w poprzednich krokach, takich jak { ... }.

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

Przetestuj funkcję niestandardową

1. Przejdź do nowo utworzonego arkusza kalkulacyjnego.
2. Zmień instrukcje w kolumnie A.
3. Formuły w kolumnie B są wykonywane, a następnie wyświetlane są wyniki weryfikacji faktów.

Czyszczenie danych

Aby uniknąć naliczenia opłat na koncie Google Cloud za zasoby wykorzystane w tym samouczku, zalecamy usunięcie projektu Cloud.

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

• Wszystkie dane projektu zostaną usunięte. Jeśli na potrzeby tego samouczka użyłeś istniejącego projektu, to po jego usunięciu usuniesz również wszystkie inne prace wykonane w ramach tego projektu.
• Niestandardowe identyfikatory projektu zostaną utracone. Podczas tworzenia tego projektu mogłeś utworzyć niestandardowy identyfikator projektu, którego będziesz chciał używać w przyszłości. Aby zachować adresy URL korzystające z identyfikatora projektu, np. adres URL w witrynie appspot.com, usuń wybrane zasoby w ramach projektu 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 przejdź do strony Zarządzaj zasobami. Trzask Menu > IAM i administracja > Zarządzaj zasobami.

   Otwórz Menedżera zasobów

2. Na liście projektów wybierz projekt, który chcesz usunąć, a następnie kliknij Usuń .
3. W oknie wpisz identyfikator projektu i kliknij Wyłącz, aby usunąć projekt.

Dalsze kroki

• Planowanie podróży z pomocą agenta AI dostępnego w różnych usługach Google Workspace
• Funkcje niestandardowe w Arkuszach Google
• Rozszerzanie Arkuszy Google