Tworzenie prostego agenta podróży za pomocą pakietu ADK i interfejsu wiersza poleceń Gemini

1. Wprowadzenie

Last Updated: 2026-06-22

Tworzenie prostego agenta turystycznego za pomocą pakietu ADK

Witamy na warsztatach ADK Python(*), które dzięki interfejsowi wiersza poleceń Gemini są gotowe do użycia od razu po uruchomieniu.

Ten codelab jest podzielony na 2 etapy:

1. Typowa, prosta ścieżka szkoleniowa: konfiguracja + natychmiastowa satysfakcja.
2. Spersonalizowana ścieżka, na której wybierasz zadanie do rozwiązania przy pomocy interfejsu wiersza poleceń Gemini

Druga część sprawia, że te ćwiczenia są idealne na hackathon (z nagrodami za najbardziej kreatywne rozwiązania!).

Etap 1. Tworzenie pierwszego agenta za pomocą pakietu ADK i interfejsu wiersza poleceń Gemini

Celem tego etapu jest krok po kroku utworzenie prostego agenta turystycznego za pomocą pakietu ADK. Najpierw skonfigurujemy interfejs wiersza poleceń Gemini, aby ułatwić Ci pisanie kodu za pomocą ADK. Dzięki temu lokalna powłoka będzie mogła wybrać najnowszą wersję ADK Pythona, interpretować kod i dokumenty oraz udostępniać najnowszy i najlepszy kod, który pomoże Ci osiągnąć cel.

To część, w której krok po kroku tworzymy w pełni działającą aplikację. Zwykle zajmuje to około godziny (plus czas instalacji).

Uwaga (*): to ćwiczenie zakłada, że używasz pakietu Python ADK, ale możesz je wykonać w Go, Javie lub TypeScript, wprowadzając tylko niewielkie zmiany. Jeśli masz doświadczenie tylko z ADK w Pythonie, to ćwiczenie jest świetną okazją, aby wypróbować tę ścieżkę w innym języku. Podziel się z nami swoją opinią, korzystając z linku poniżej.

Etap 2. Rozszerzanie zakresu działania agenta

Następnie przedstawiamy Ci kilkanaście opcji (o różnym stopniu trudności), które pozwolą Ci dostosować aplikację do swoich potrzeb. Dzięki temu możesz poznać różne aspekty (interfejs, operacje, złożone interakcje z agentem itp.).

Co utworzysz

W tym ćwiczeniu utworzysz aplikację Travel Agent za pomocą pakietu ADK i interfejsu wiersza poleceń Gemini. Twoja aplikacja będzie:

• Połącz się z interfejsami API Airbnb za pomocą platformy MCP Airbnb.
• Wyszukiwanie w internecie aktualnych informacji (pogoda, daty itp.)
• wykonywać niestandardowe narzędzia,
• Twórz obrazy apartamentów lub pokoi za pomocą Nano Banana.

Interfejs wiersza poleceń Gemini przeprowadzi Cię przez cały ten proces: pisanie i sprawdzanie kodu oraz wyszukiwanie najnowszej dokumentacji w lokalnej kopii repozytorium ADK (w Pythonie lub w Twoim ulubionym języku).

Czego się nauczysz

• Tworzenie aplikacji za pomocą pakietu ADK
• Jak używać interfejsu wiersza poleceń Gemini do kodowania aplikacji na podstawie lokalnych dokumentów
• Jak wchodzić w interakcje z serwerem MCP, aby łączyć się ze źródłami danych zewnętrznych w czasie rzeczywistym, np. w ten sposób:

Czego potrzebujesz

• komputer, na którym można instalować pakiety (np. npm install ..);
• Podstawowe umiejętności programowania w języku Python, TypeScript, Go lub Java.
• Zdecydowanie zalecamy korzystanie z IDE (Antigravity, vscode, IntelliJ, vim).

Dlaczego warto używać pakietu ADK i interfejsu wiersza poleceń Gemini?

Niektórzy z Was mogą się zastanawiać: dlaczego muszę używać pakietu ADK (pakietu SDK do tworzenia agentów) w połączeniu z lokalnym narzędziem do pomocy w kodowaniu agentów (np. interfejsem wiersza poleceń Gemini)? Powodem jest to, że oba narzędzia są niezwykle wydajne, ale ich interakcja nie jest prosta. Wiele osób próbowało z nich korzystać jednocześnie, ale bez powodzenia (głównie z powodu problemów z „pętlą w pętli”). W tym ćwiczeniu znajdziesz kilka wskazówek, jak to zrobić.

2. Przygotowania

Wybierz jedną z tych opcji: Self-paced environment setup (Konfiguracja środowiska we własnym tempie), jeśli chcesz uruchomić ten przewodnik na własnym komputerze, lub Start Cloud Shell (Uruchom Cloud Shell), jeśli chcesz uruchomić go w całości w chmurze.

Samodzielne konfigurowanie środowiska

1. Zaloguj się w konsoli Google Cloud i utwórz nowy projekt lub użyj istniejącego. Jeśli nie masz jeszcze konta Gmail lub Google Workspace, musisz je utworzyć.

• Nazwa projektu to wyświetlana nazwa dla uczestników tego projektu. Jest to ciąg znaków, który nie jest używany przez interfejsy API Google. Zawsze możesz ją zaktualizować.
• Identyfikator projektu jest unikalny we wszystkich projektach Google Cloud i nie można go zmienić po ustawieniu. Konsola Cloud automatycznie generuje unikalny ciąg znaków. Zwykle nie musisz się tym przejmować. W większości ćwiczeń z programowania musisz odwoływać się do identyfikatora projektu (zwykle oznaczanego jako PROJECT_ID). Jeśli wygenerowany identyfikator Ci się nie podoba, możesz wygenerować inny losowy identyfikator. Możesz też spróbować własnej nazwy i sprawdzić, czy jest dostępna. Po tym kroku nie można go zmienić i pozostaje on taki przez cały czas trwania projektu.
• Warto wiedzieć, że istnieje też trzecia wartość, numer projektu, której używają niektóre interfejsy API. Więcej informacji o tych 3 wartościach znajdziesz w dokumentacji.

Ostrzeżenie: identyfikator projektu jest unikalny globalnie i po jego wybraniu nie może być używany przez nikogo innego. Jesteś jedynym użytkownikiem tego identyfikatora. Nawet po usunięciu projektu nie można ponownie użyć jego identyfikatora.

Uwaga: jeśli używasz konta Gmail, możesz pozostawić domyślną lokalizację ustawioną na Brak organizacji. Jeśli używasz konta Google Workspace, wybierz lokalizację odpowiednią dla Twojej organizacji.

2. Następnie musisz włączyć płatności w konsoli Cloud, aby korzystać z zasobów i interfejsów API Google Cloud. Wykonanie tego laboratorium nie będzie kosztować dużo, a może nawet nic. Aby wyłączyć zasoby i uniknąć naliczania opłat po zakończeniu tego samouczka, możesz usunąć utworzone zasoby lub projekt. Nowi użytkownicy Google Cloud mogą skorzystać z bezpłatnego okresu próbnego, w którym mają do dyspozycji środki w wysokości 300 USD.

Uruchamianie Cloud Shell

Z Google Cloud można korzystać zdalnie na laptopie, ale w tym ćwiczeniu użyjesz Google Cloud Shell, czyli środowiska wiersza poleceń działającego w chmurze.

W konsoli Google Cloud kliknij ikonę Cloud Shell na pasku narzędzi w prawym górnym rogu:

Uzyskanie dostępu do środowiska i połączenie się z nim powinno zająć tylko kilka chwil. Po zakończeniu powinno wyświetlić się coś takiego:

Ta maszyna wirtualna zawiera wszystkie potrzebne narzędzia dla programistów. Zawiera również stały katalog domowy o pojemności 5 GB i działa w Google Cloud, co znacznie zwiększa wydajność sieci i usprawnia proces uwierzytelniania. Wszystkie zadania w tym laboratorium możesz wykonać w przeglądarce. Nie musisz niczego instalować.

3. Wymagania wstępne (instalacja)

Uwaga: jeśli zdecydujesz się wykonać to ćwiczenie w Cloud Shell, Python, uv i interfejs wiersza poleceń Gemini (gemini) będą już wstępnie zainstalowane.

W tym samouczku musisz zainstalować:

1. Python i uv

python i uv (menedżer pakietów dla Pythona). Jest to wymagane w przypadku ADK. Sprawdź, czy masz zainstalowany pakiet uv:

$ curl -LsSf https://astral.sh/uv/install.sh | sh

Dlaczego uv? Możesz używać dowolnego menedżera Pythona, ale użycie uv zapewni, że konfiguracja ENV/PATH dla Pythona będzie taka sama dla Ciebie i interfejsu wiersza poleceń Gemini, więc środowisko powłoki będzie w większości takie samo jak w przypadku interfejsu wiersza poleceń Gemini. Jeśli na przykład użyjesz virtualenv , interfejs wiersza poleceń Gemini będzie zmuszony do wykonania czynności takich jak „source .env/venv/bin/activate && my-original-command”, aby naśladować Twoje środowisko.

2. Interfejs wiersza poleceń Gemini

Instrukcje instalacji interfejsu gemini CLI znajdziesz tutaj: https://github.com/google-gemini/gemini-cli .

# Note: This requires having npm or npx installed.
npm install -g @google/gemini-cli

1. Na Mac możesz użyć brew zgodnie z oficjalnymi dokumentami.
2. W systemie Windows możesz użyć chocolatey lub po prostu pobrać plik wykonywalny ze strony https://nodejs.org/en/download.

W kroku 4 (później) będziesz też potrzebować zainstalowanej aplikacji npx. Zarówno npm, jak i npx powinny być naturalną częścią interfejsu wiersza poleceń Gemini. Jeśli nie, poproś o pomoc interfejs wiersza poleceń Gemini.

Uwierzytelnianie

Musisz mieć projekt Google Cloud z włączoną usługą Vertex AI lub klucz interfejsu API Google AI Studio.

Opcja A (zalecana w przypadku warsztatów): wyeksportuj klucz interfejsu API:

export GOOGLE_API_KEY="your-api-key"

Opcja B (Vertex AI): uwierzytelnij się za pomocą gcloud:

export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
export GOOGLE_CLOUD_LOCATION="YOUR_PROJECT_LOCATION"
export GOOGLE_GENAI_USE_VERTEXAI=true
gcloud auth application-default login

Konfigurowanie środowiska pracy

W sekcji mysolution/ utworzysz WŁASNE rozwiązanie, więc utwórz folder i 2 potrzebne pliki.

W tym momencie możesz otworzyć IDE (Visual Studio Code, IntelliJ, RubyMine itp.) i otworzyć folder.

# 1. Find an empty directory, and download this repo.
git clone https://github.com/palladius/adk-gemini-cli-workshop
cd adk-gemini-cli-workshop/

# 2. Create your solution empty skeleton
mkdir -p mysolution/
touch mysolution/__init__.py mysolution/agent.py

# 3. This installs ADK and MCP via `uv` by reading pyproject.toml
uv init
uv sync

# 4. Call Gemini CLI
gemini  # This runs Gemini CLI under the adk-gemini-cli-workshop/ folder.
# Login with your GMail account.

Synchronizacja uv nie jest bezwzględnie wymagana, ale jeśli się nie powiedzie, oznacza to, że musisz naprawić instalację Pythona lub uv. Powinno to zainstalować adk i inne przydatne skrypty w folderze ./.venv/bin/.

Aby przetestować konfigurację, wystarczy uruchomić make test-step1 i sprawdzić, czy nie otrzymasz 403 PERMISSION DENIED..

Ważne: Upewnij się, że uruchamiasz interfejs wiersza poleceń Gemini z folderu 📁 adk-gemini-cli-workshop/. IDE powinien też wyświetlać tę nazwę jako nazwę główną. Dzięki temu interfejs wiersza poleceń Gemini wybierze odpowiednią konfigurację. Zawsze możesz dodać foldery zewnętrzne za pomocą /dir add /your/other/folder, ale 📁 adk-gemini-cli-workshop/ to najlepsza lokalizacja początkowa.

Dostępne rozwiązania

Cały kod znajduje się w folderze 📂 steps/. Możesz stamtąd skopiować kod.

To ćwiczenie nie dotyczy pisania dobrego kodu ADK, ale konfigurowania środowiska, aby automatycznie generować DOBRY kod zgodnie z Twoimi instrukcjami.

1. Instalowanie oprogramowania
2. konfigurowanie lub uruchamianie,
3. wchodzenie w pozytywną pętlę informacji zwrotnych.

Tego właśnie chcemy Cię tutaj nauczyć. Możesz też przetestować je wszystkie jednocześnie za pomocą $ make web-4steps.

4. Krok 1. Podstawowy agent

Zacznijmy od utworzenia podstawowego agenta, który może prowadzić rozmowę.

Edytuj plik o nazwie mysolution/__init__.py, dodając do niego ten kod:

from .agent import root_agent

To takie proste. Dzięki temu pakiet ADK będzie wiedzieć, gdzie znajduje się Twój kod: w agent.py.

Edytuj plik o nazwie mysolution/agent.py, dodając do niego ten kod:

from google.adk.agents import Agent

root_agent = Agent(
    name="travel_basic",
    model="gemini-2.5-flash",
    instruction="You are a helpful travel assistant." +
    "You can help with general travel advice based on your knowledge.",
)

Testowanie agenta

Dotyczy to wszystkich kroków. ADK umożliwia testowanie agenta na 2 sposoby: za pomocą interfejsu CLI i w internecie.

• CLI najlepiej sprawdza się w przypadku szybkich i zautomatyzowanych testów.
• Internet to najlepsze narzędzie do wizualnego sprawdzania, co się dzieje, korzystania z mikrofonu (!) i rozwiązywania problemów.

Wskazówka: na potrzeby tego ćwiczenia, aby wykonać dowolne działanie (z wyjątkiem testów jednostkowych), użyj internetu. To naprawdę niesamowite! Zachowaj interfejs CLI tylko na potrzeby testów zautomatyzowanych.

Dobry prompt, który prawidłowo testuje kroki 1–2–3–4, może wyglądać tak (inteligentny „prompt lakmusowy”):

Dzień dobry, chcę zarezerwować hotel w Paryżu na jutrzejszy wieczór, na jedną noc, w centrum Paryża. Najlepiej w pobliżu dworca Gare de Lyon. Budżet: poniżej 200 EUR za noc.

1. Podaj datę w formacie RRRRMMDD i dzień tygodnia, który będzie jutro.
2. Podaj co najmniej 3 hotele, które widzisz na jutro. Chcę zobaczyć: > cenę, adres, ocenę (w formacie XX/YY, np. „4,7/5” – z Google Hotels, Booking lub Airbnb), liczbę opinii. Podaj je w FORMIE TABELI. Nazwa hotelu powinna być połączona z adresem URL hotelu (nie musisz dodawać kolumny adresu URL). Upewnij się, że link jest prawidłowy (działa, a strona zawiera informacje o hotelu).

Jest to inteligentny prompt, ponieważ testuje czas i hotele, a w krokach 1, 2 i 3 będzie działać inaczej. Powinien w pełni działać tylko w kroku 4. Możesz oczywiście użyć dowolnego prompta, jakiego chcesz.

Uruchom go w bashu (interfejs wiersza poleceń):

# 1. If ADK was installed:
adk run mysolution/
# ... but if you get: -bash: adk: command not found"
# 2. Call ADK cli script through UV to avoid python install nightmares.
uv run adk run mysolution/

Wypróbuj go, używając „testowego prompta” powyżej.

Prawdopodobnie nie będzie znać konkretnych dat. Musimy nauczyć go rozpoznawania daty.

W przypadku internetu możesz to zrobić w ten sposób:

1. uv run adk web . : uruchamia wszystkich agentów w tym folderze. Chcesz wskazać podfolder „mysolution/”
2. w prawym górnym rogu kliknij mysolution/ (zobacz obraz obok);
3. Zadaj pytanie w formie tekstu lub za pomocą mikrofonu, np. „litmus prompt”.

Pamiętaj, że musisz wywołać adk web z folderu wyższego poziomu, w zależności od wersji interfejsu CLI.

Oto możliwe rozwiązanie z półhalucynacją daty. Uwaga: 3 z 5 linków do rezerwacji działają. Całkiem nieźle.

5. Krok 2. Dodaj narzędzie now()

Dodaj tę funkcję do agent.py tuż przed definicją root_agent:

from datetime import datetime

def now() -> dict:
    """Returns the current date and time."""
    my_datetime = ... # Ask Gemini CLI to help you!
    return {
        "status": "success",
        "current_time": my_datetime
    }

Zaktualizuj definicję agenta, aby uwzględnić narzędzie:

  # file XXX.py

  root_agent = Agent(
        name="..",
        model="..",
        instruction="..",
        tools=[now] # <== This is the only line you want to add.
    )

Uruchom je ponownie i zadaj to samo pytanie. Powinien teraz znać datę (dobrze) i nie mieć pewności co do hoteli (źle).

Możesz też przetestować to w ten sposób:

# Let's pretend we're in Milan. This should call the tool
# and respond correctly (possibly with some TZ math issues)
echo "What time is it in Milan?" | uv run adk run mysolution/

6. Krok 3. Zmieńmy temat: google_search

google_search. Dzięki temu nasz agent może uzyskiwać dostęp do informacji w czasie rzeczywistym z internetu.

Uwaga: 🚨 modele gemini-2.x nie mogą natywnie łączyć wyszukiwarki Google z narzędziami niestandardowymi (patrz problem nr 969), dlatego dla uproszczenia zastąpimynow() symbolem google_search. Więcej informacji: ISSUES.md.

Twoim zadaniem jest zmodyfikowanie agenta z kroku 2. Zamiast narzędzia now zaimportujesz i użyjesz narzędzia google_search z biblioteki ADK.

# Full Code: `steps/step03_search/agent.py`
# Remember to REMOVE the now() tool here. See above why.
from google.adk.agents import Agent
from google.adk.tools import google_search

root_agent = Agent(
    name="travel_agent",
    model="gemini-2.5-flash",
    tools=[google_search],
    instruction="""You are a travel agent.
Your job is to help the user plan a trip.
You have access to a search engine.
If you don't know the answer, you can use the search engine.
When you are done, reply with "DONE".""",
)

Uruchamianie

Tak samo jak w kroku 1.

Tylko dla ekspertów Aby uzyskać bardziej zaawansowaną integrację (z użyciem google_search i now), sprawdź kod w steps/step03b_search_and_tool/agent.py i uruchom go za pomocą make run-step3b. Jest to całkowicie opcjonalne.

7. Krok 4. Bardziej zaawansowane narzędzie: MCP

Omówiliśmy już narzędzia niestandardowe i wbudowane, więc teraz przejdźmy do czegoś bardziej zaawansowanego: wzorca Model-as-a-Tool, który wykorzystuje Model Context Protocol (MCP).

Aby skupić się na zaawansowanych możliwościach MCP, ponownie zastąpimy poprzednie narzędzie (google_search). Wprowadzimy ponownie proste narzędzie now, które będzie działać równolegle z narzędziem airbnb_mcp. Pokazuje to, jak agent może używać wielu zgodnych narzędzi (w tym przypadku FunctionTool i MCPToolset) do wykonywania złożonych zadań.

# Full Code: steps/step04_mcp/agent.py
# ... Imports as before
from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters

def now() -> dict:
    # ... as before

# Configure the Airbnb MCP Toolset
airbnb_mcp = MCPToolset(
    connection_params=StdioConnectionParams(
        server_params=StdioServerParameters(
            command='npx',
            args=["-y", "@openbnb/mcp-server-airbnb", "--ignore-robots-txt"],
        ),
    )
)

root_agent = Agent(
    name="travel_mcp",
    model="gemini-2.5-flash",
    instruction="You are a helpful travel assistant. You can find accommodation using Airbnb, and have access to the current time.",
    tools=[now, airbnb_mcp],
)

Uruchamianie

Ten krok wymaga zainstalowania na urządzeniu aplikacji npx. W pozostałych przypadkach jest tak samo jak powyżej.

Zastrzeżenia/ błędy

1. Jeśli pojawi się robots.txtbłąd ograniczenia, możesz zastosować w MCP poprawkę z dyrektywą ignorowania robotów. Więcej informacji znajdziesz w dokumentacji: https://github.com/openbnb-org/mcp-server-airbnb
2. Jeśli pojawi się błąd timeout (5 sekund to zbyt mało, aby Airbnb uzyskało odpowiedzi), zapoznaj się z dokumentacją ADK, aby dowiedzieć się, jak wydłużyć limit czasu, np. do 30 sekund. Możesz też użyć interfejsu wiersza poleceń Gemini. Pamiętaj, że 3 grudnia 2025 r. Cloud Shell zwrócił błąd przekroczenia limitu czasu. Naprawiłem go, ale nadal pojawiały się błędy, dopóki nie wymusiłem powrotu do poprzedniej wersji: args=["-y", "@openbnb/mcp-server-airbnb@0.1.2", "--ignore-robots-txt"].

8. 🏅 Kamień milowy 1 osiągnięty!

🏅 Gratulacje! 🏅 Jesteś teraz ekspertem w zakresie ADK! Udało Ci się ukończyć pierwszą część warsztatów i skutecznie utworzyć oraz przetestować agentów AI za pomocą narzędzi niestandardowych, wbudowanych i zaawansowanych narzędzi MCP. Możesz teraz tworzyć własnych niesamowitych agentów za pomocą pakietu Google Agent Development Kit.

Masz teraz funkcjonalnego agenta podróży, który zna godzinę i może przeszukiwać internet. Teraz nie ma już żadnych ograniczeń.

Teraz możesz dodać dodatkową funkcję za pomocą „interfejsu wiersza poleceń Gemini”.

9. 🏅 Etap 2. Vibe coding w pakiecie ADK za pomocą interfejsu wiersza poleceń Gemini

Teraz przechodzimy do najciekawszej części warsztatów.

1. upewnij się, że git commitzapiszesz kod w bezpiecznym miejscu. Możesz rozwidlić oryginalny kod lub utworzyć gałąź. Nie martw się, interfejs wiersza poleceń Gemini Ci w tym pomoże.
2. Znajdź 💡 pomysł do wdrożenia. Możesz sprawdzić pomysły poniżej, znaleźć własny lub poprosić Gemini o przejrzenie dokumentacji w rag/ i zaproponowanie kilku inteligentnych pomysłów.
3. Zapoznaj się z wymaganiami wstępnymi, aby mieć pewność, że Gemini może odczytać dokumenty ADK.

💡 Pomysły

1. 🟢 [łatwe] Znasz wiele języków? Chcesz przekazać go, java czy TypeScript? Refaktoryzacja istniejącego kodu jest bardzo prosta. Pamiętaj tylko, aby pobrać odpowiedni pakiet ADK i poprosić interfejs wiersza poleceń Gemini o wykonanie tłumaczenia.
2. 🟢 [łatwe] Dodaj emotikony lub określ format wyjściowy (np. tabela z emotikonami hoteli, a następnie cena i emotikony gwiazdek od 1 do 5 – możesz też użyć 🌕🌕🌕🌗🌑, aby uwzględnić połówki!).
3. 🟢 [łatwe] Zmień prompt, aby nauczyć go, czego konkretnie szukasz lub czego nie chcesz (np. miejsce przyjazne zwierzętom, bez parteru, ciche, blisko transportu publicznego) i przetestuj go. Możesz dodać osobistą ocenę, np. „ocena od 1 do 10 – TWOJE_IMIĘ”, na podstawie powyższych informacji i posortować wyniki według tej oceny.
4. 🟢 [łatwe] Czy w pokoju jest jakiś operator? Wdróż w Cloud Run. lub Vertex AI Agent Engine. Czy wiesz, że możesz zintegrować tego agenta i wywoływać go bezpośrednio z nowej usługi Gemini Enterprise?
5. 🟢 [łatwe] Zintegruj adk run z 🍌 NanoBanana MCP. Wymaga klucza interfejsu Gemini API. Tutaj możesz tworzyć obrazy, ale nie możesz ich wizualizować. Poniżej znajdziesz trudniejszą wersję.
6. 🟡 [medium] Utwórz subagenta, który wykona HotelSearch, i utwórz BudgetAgent lub LocationAgent, które mogą powtarzać i iterować wyszukiwanie hoteli z uwzględnieniem Twoich potrzeb dotyczących lokalizacji, np. „nie więcej niż X km od LOKALIZACJI”. Jeśli interfejs API na to nie pozwala, może być konieczna wymiana informacji z użyciem GoogleSearch. Uwaga: interfejs wiersza poleceń Gemini może Ci pomóc.
7. 🟡 [średni] Wdróż AirbnbReviewAgent, który analizuje opinie i podsumowuje pozytywne i negatywne aspekty w kilku punktach oznaczonych kolorami dla 1 lub N hoteli w wynikach wyszukiwania. Masz już 2 składniki (GoogleSearch i MCP Airbnb), więc musisz połączyć je z głównym agentem i być może wymyślić jakiś protokół, który umożliwi im komunikację.
8. 🟡 [średni] Integracja z A2A. Utwórz agenta A2A. Ponownie poproś o pomoc interfejs wiersza poleceń Gemini.
9. 🔴 [complex] Możesz zintegrować Loty lub inne funkcje MCP, aby utworzyć wieloaspektowe, wielofunkcyjne biuro podróży.
10. 🔴 [complex] Zintegruj ADK web z 🍌 NanoBanana MCP. Jest to trudniejsze niż powyższe zadanie. Wskazówki znajdziesz na stronie https://github.com/palladius/ai-friendly-agents/issues/11. Zajęło to autorowi 3 godziny wymiany informacji z interfejsem wiersza poleceń Gemini, Gemini 3 i nami obojgiem, którzy czytaliśmy dokumenty i kod z rag/!

Szukasz dalszych inspiracji?

1. Pomysły znajdziesz w oficjalnym samouczku pakietu ADK.
2. Poproś interfejs wiersza poleceń Gemini o znalezienie pomysłów na podstawie dokumentacji rag/. Możesz użyć tego prompta: Is there a feature in here which seems very succulent to you? Give me 3 proposals and let's implement together the one I choose.

Wymagania wstępne dotyczące ADK „RAG”

Aby zakodować funkcję, zalecamy pobranie całego pakietu ADK python ADK (uwaga: można go bardzo łatwo dostosować do ulubionego języka, np. Javy lub Go!).

Kod znajduje się w katalogu ./rag i można go pobrać za pomocą polecenia ./download-adk.sh.

Ponieważ folder rag jest wymieniony w pliku .gitignore, upewnij się, że plik .gemini/settings.json zawiera te elementy:

{
 "context": {
   "includeDirectories": ["rag"]
 }
}

Why? Chcemy, aby Gemini mógł odczytywać te pliki, gdy są bezpiecznie ignorowane przez Git. Teoretycznie możesz też odkryć wszystkie pliki .gitignore, ustawiając context.fileFiltering.respectGitIgnore na false, ale spowoduje to wyświetlenie wielu niepotrzebnych plików node_modules/ i __pycache__/, więc preferowaną opcją jest jawne uwzględnienie folderu.

10. Dalsze kroki

Ciekawostka: te warsztaty zostały opracowane przy użyciu interfejsu wiersza poleceń Gemini. Jeśli chcesz się dowiedzieć, jak to zrobiłem, zajrzyj do plików GEMINI.md i WORKSHOP_PLAN.md w tym folderze.

Wyciągnięte wnioski

Dowiedzieliśmy się, jak sparować pakiet ADK z interfejsem wiersza poleceń Gemini

Materiały dodatkowe

• Zapoznaj się z tymi 2 oficjalnymi ćwiczeniami dotyczącymi Antigravity:
  • Pierwsze kroki z Google Antigravity
  • Tworzenie z użyciem Google Antigravity
  • Kompilowanie i wdrażanie w Google Cloud za pomocą Antigravity
• Pomysły znajdziesz w oficjalnym samouczku pakietu ADK.