Prestart: przygotowanie i weryfikacja środowiska przed AI Travel Scout

Ten plik jest dla świeżego agenta. Zanim zaczniesz budować workflow, sprawdź środowisko i nie udawaj, że coś działa.

Cel prestartu

Potwierdzić, czy środowisko ma wszystko, czego potrzebuje demo:

• n8n działa,
• agent ma dostęp do n8n przez MCP albo REST API,
• istnieją credentials w n8n,
• istnieje albo da się utworzyć Data Table demo,
• SerpApi działa,
• OpenAI/model w n8n działa,
• Gmail credential działa,
• mail/Gmail MCP pozwala sprawdzić, czy wiadomość doszła,
• agent może zapisać raporty do n8n_demo/outputs/.

Twarda zasada

Nie zaczynaj budować pełnego Travel Scouta, dopóki nie masz preflight statusu.

Status może być:

• READY - można budować i testować end-to-end,
• PARTIAL_READY - można budować, ale część testów będzie zablokowana,
• BLOCKED - nie zaczynaj, bo brakuje krytycznego dostępu.

Krok 1: filesystem

Sprawdź:

• [ ] możesz czytać n8n_demo/,
• [ ] możesz czytać źródła kursu Mateusza,
• [ ] możesz utworzyć n8n_demo/outputs/,
• [ ] możesz zapisać plik testowy w n8n_demo/outputs/.

Dowód w raporcie: ścieżka zapisanego pliku testowego.

Krok 2: n8n access

Sprawdź jedno z dwóch:

Opcja A: n8n MCP

• [ ] MCP jest dostępny,
• [ ] agent może listować workflowy,
• [ ] agent może utworzyć workflow testowy,
• [ ] agent może uruchomić workflow testowy,
• [ ] agent może odczytać execution logs.

Opcja B: n8n REST API

• [ ] znany jest base URL n8n,
• [ ] dostępny jest API key / token,
• [ ] /workflows odpowiada,
• [ ] można utworzyć workflow testowy,
• [ ] można odczytać execution/result.

Jeśli nie działa ani MCP, ani REST API: BLOCKED.

Krok 3: n8n credentials

Sprawdź bez wypisywania sekretów:

• [ ] istnieje credential OpenAI/modelowy, np. OpenAI Demo Credential,
• [ ] istnieje credential albo env dla SerpApi,
• [ ] istnieje credential Gmail, np. Gmail Test Sender.

Dowód: nazwy/ID credentials, ale bez sekretów.

Jeśli nie można listować credentials przez API/MCP, sprawdź przez UI/browser albo oznacz jako PARTIAL_READY i poproś Tomasza o potwierdzenie nazw.

Krok 4: test minimalnego workflowu n8n

Utwórz mały workflow testowy, który nie używa kosztownych API:

• Manual Trigger albo minimalny testowy trigger,
• Set node z polem preflight_ok=true,
• Execute,
• odczytaj execution result.

Po teście usuń workflow testowy tylko jeśli masz wyraźną zgodę na kasowanie. W przeciwnym razie zostaw go jako preflight-test-* i opisz w raporcie.

Krok 5: test OpenAI/modelu w n8n

Utwórz albo uruchom minimalny test modelu:

Prompt: Odpowiedz dokładnie JSON-em: {"ok": true}

Sprawdź:

• [ ] node modelu działa,
• [ ] odpowiedź jest parsowalna,
• [ ] nie ma błędu credential/billing/rate limit.

Jeśli test kosztowy nie jest dozwolony, oznacz jako PARTIAL_READY.

Krok 6: test SerpApi

Wykonaj minimalny request do SerpApi Google Hotels na bezpiecznych danych testowych.

Sprawdź:

• [ ] HTTP status OK,
• [ ] response nie jest błędem auth/rate limit,
• [ ] response zawiera dane hotelowe albo kontrolowany brak wyników.

Nie wykonuj wielu requestów. Jeden test wystarczy.

Krok 7: test Gmail send

Nie wysyłaj maila do przypadkowych adresów.

Jeśli Tomasz podał testowy adres:

• [ ] wyślij krótki mail testowy przez n8n Gmail credential,
• [ ] subject ma zawierać unikalny timestamp, np. AI Travel Scout preflight 2026-...,
• [ ] zapisz execution id.

Jeśli nie ma testowego adresu: PARTIAL_READY albo BLOCKED dla pełnego end-to-end.

Krok 8: test mail/Gmail MCP read

Sprawdź, czy możesz odczytać skrzynkę odbiorczą / testową:

• [ ] wyszukaj mail po subject z kroku 7,
• [ ] potwierdź from, to, subject, date,
• [ ] opcjonalnie sprawdź fragment body.

Jeśli mail MCP nie działa, pełna weryfikacja dostarczenia jest BLOCKED, nawet jeśli Gmail send działa.

Krok 9: Data Table

Sprawdź:

• [ ] istnieje tabela demo albo możesz ją utworzyć,
• [ ] ma wymagane kolumny albo możesz je dodać,
• [ ] możesz wstawić testowy rekord,
• [ ] możesz zaktualizować testowy rekord,
• [ ] możesz odczytać rekord po update.

Nie używaj produkcyjnej tabeli.

Krok 10: raport preflight

Zapisz:

n8n_demo/outputs/preflight-environment-report.md

Raport musi zawierać:

• status: READY, PARTIAL_READY albo BLOCKED,
• co działa,
• co nie działa,
• czego brakuje od Tomasza,
• nazwy credentials bez sekretów,
• n8n workflow/test execution ids,
• wynik testu Gmail send,
• wynik weryfikacji przez mail MCP,
• wynik testu Data Table,
• decyzję: czy zaczynać budowę pełnego Travel Scouta.

Krytyczne blockery

Pełne demo end-to-end jest zablokowane, jeśli brakuje:

• dostępu do n8n MCP/REST API,
• działającego OpenAI/model credential,
• działającego SerpApi,
• Gmail credential z prawem wysyłki,
• mail/Gmail MCP do odczytu i potwierdzenia dostarczenia,
• testowego adresu odbiorcy,
• Data Table demo.

Bez tych rzeczy agent może przygotować workflow i raport, ale nie może uczciwie potwierdzić, że cały flow działa.