adk-agent-builder

Skill do tworzenia produkcyjnych agentów AI opartych na Google Agent Development Kit. Generuje gotowy scaffold projektu z rejestrem narzędzi, wzorcami ReAct dla pojedynczych agentów oraz orkiestrację wieloagentową (sekwencyjna, równoległa, pętlowa). Zawiera konfigurację testów, listę walidacji do CI i opcjonalne wdrożenie na Vertex AI Agent Engine. Idealne dla zespołów budujących złożone systemy agentów z dostępem do Google Cloud.

1. Sprawdź wymagania: upewnij się, że masz zainstalowany Python 3.10+ oraz pakiet google-adk dostępny w projekcie. Jeśli planujesz wdrożenie na Vertex AI, przygotuj dostęp do projektu Google Cloud z włączonym Vertex AI i odpowiednimi uprawnieniami.

2. Zdefiniuj zakres agenta: zdecyduj, czy budujesz lokalny scaffold agenta, czy system gotowy do wdrożenia na Agent Engine. Wybierz architekturę — pojedynczy agent ze wzorcem ReAct do zadań opartych na narzędziach, lub system wieloagentowy ze specjalistami i orkiestratorem dla złożonych przepływów wieloetapowych.

3. Określ powierzchnię narzędzi: wypisz wbudowane narzędzia ADK oraz wszelkie niestandardowe narzędzia potrzebne agentowi. Przygotuj wymagane poświadczenia i zmienne środowiskowe — nigdy nie koduj sekretów na stałe.

4. Wygeneruj strukturę projektu: skill tworzy katalogi src/agents/, src/tools/, tests/ oraz plik zależności (pyproject.toml lub requirements.txt). Zaimplementuj minimalny agent i test dymny z przykładowym promptem, dodaj testy regresyjne dla scenariuszy awarii narzędzi.

5. Zwaliduj konfigurację: uruchom listę walidacji zawierającą lint, testy jednostkowe i smoke prompty — ta lista jest gotowa do integracji z CI/CD. Sprawdź, czy wszystkie narzędzia są prawidłowo zarejestrowane i dostępne dla agenta.

6. Jeśli wdrażasz na Vertex AI: wygeneruj konfigurację wdrożenia Agent Engine, zweryfikuj uprawnienia do projektu Google Cloud i uruchom polecenie adk deploy z odpowiednimi parametrami.