Checklist: n8n demo AI Travel Scout

Cel: przed spotkaniem przygotować środowisko, w którym agent może zbudować pełny workflow AI Travel Scout na podstawie szkolenia Mateusza, uruchomić test end-to-end i zweryfikować, że mail testowy doszedł.

0. Decyzje bezpieczeństwa przed setupem

• [ ] Demo używa wyłącznie testowego workflowu, testowej tabeli i testowego adresu odbiorcy.
• [ ] Gmail wysyła realny mail, ale tylko na adres kontrolowany przez Tomasza.
• [ ] Agent nie dostaje prawdziwych danych klientów, prywatnych folderów ani produkcyjnego Gmaila.
• [ ] Agent nie dostaje surowych sekretów w promptach. Sekrety są w n8n credentials / env.
• [ ] Workflow ma limit kosztów: mała liczba testowych rekordów, jeden testowy mail, kontrolowany SerpApi/OpenAI usage.

1. Środowisko n8n

• [ ] Uruchomiona osobna instancja n8n do demo, najlepiej Docker.
• [ ] Ustawiony stały N8N_ENCRYPTION_KEY.
• [ ] Ustawiony login do n8n, jeśli instancja jest wystawiona poza localhost.
• [ ] Dostęp do n8n UI działa w przeglądarce.
• [ ] Dostęp do n8n API działa dla agenta albo przez n8n MCP.
• [ ] Strefa czasowa ustawiona, np. GENERIC_TIMEZONE=Europe/Warsaw.
• [ ] Jeśli workflow ma działać cyklicznie, aktywacja workflow jest testowana dopiero po ręcznych testach.

Minimalny .env dla Dockera:

N8N_ENCRYPTION_KEY=REPLACE_WITH_LONG_RANDOM_VALUE
GENERIC_TIMEZONE=Europe/Warsaw
TZ=Europe/Warsaw
N8N_HOST=localhost
N8N_PORT=5678
N8N_PROTOCOL=http

Opcjonalnie, jeśli używasz env w HTTP/Code node'ach:

OPENAI_API_KEY=...
SERPAPI_API_KEY=...

Preferowane jednak: OpenAI, SerpApi i Gmail jako n8n Credentials, nie jako jawne wartości w workflow JSON.

2. Credentials w n8n

Przygotuj wcześniej i nazwij stabilnie:

• [ ] OpenAI Demo Credential
• [ ] SerpApi Demo Credential albo bezpieczny sposób użycia SERPAPI_API_KEY w HTTP Request.
• [ ] Gmail Test Sender

Zasada: agent ma użyć istniejących credentials, nie ma prosić o klucze w promptcie.

3. Gmail OAuth

• [ ] Utworzone / wybrane konto Gmail testowe do wysyłki.
• [ ] Google Cloud OAuth consent screen skonfigurowany.
• [ ] OAuth client skonfigurowany dla n8n.
• [ ] Redirect URI z n8n dodany w Google Cloud.
• [ ] n8n credential Gmail Test Sender przechodzi test połączenia.
• [ ] Wysyłka do testowego adresu Tomasza działa ręcznie z n8n.

4. Data Table

Utwórz tabelę demo, np. travel_scout_demo / travel-scout-final-demo.

Minimalne kolumny:

• email
• original_description
• monitor_frequency
• status
• destination_country
• destination_region
• suggested_locations
• travel_type
• travel_style
• activities
• people_count
• budget
• trip_duration
• preferred_dates
• preferences
• constraints
• inspiration_suggestions
• assumptions
• missing_information
• check_in_date
• check_out_date
• adults
• currency
• last_checked_at
• top_hotels
• best_hotel
• ranking_summary
• budget_summary
• destination_guide
• recommendation_subject
• recommendation_body
• last_sent_at

Typy praktyczne:

• długie teksty / JSON jako text lub long text,
• daty jako text albo datetime, zależnie od n8n Data Table,
• email, status, currency, monitor_frequency jako tekst.

5. Materiały źródłowe dla agenta

Agent powinien mieć dostęp tylko do tych plików/katalogów:

• PLAN.md
• ZRODLA.md
• n8n_demo/03_AGENT_BRIEF_TRAVEL_SCOUT_N8N.md
• [lokalna ścieżka do materiałów źródłowych]
• [lokalna ścieżka do materiałów źródłowych]
• istniejące workflow JSON-y z kursu:
• .../materials/extracted/w2/Travel AI scout - 2.json
• .../materials/extracted/w3/Materiały przesłane od Mateusza w trakcie/Travel AI Scout - 1 (20.15).json
• .../materials/extracted/w3/Materiały przesłane od Mateusza w trakcie/scout-3 (19.32).json

6. Dostępy narzędziowe dla agenta

Agent potrzebuje:

• [ ] Filesystem read do źródeł i write do katalogu roboczego demo.
• [ ] n8n MCP albo n8n REST API: tworzenie workflowu, aktualizacja workflowu, uruchamianie/testowanie, odczyt execution logs.
• [ ] Gmail MCP / mail MCP / IMAP read access: sprawdzenie, czy testowy mail doszedł.
• [ ] Opcjonalnie Docker/shell read: sprawdzenie statusu kontenera i logów n8n.
• [ ] Opcjonalnie browser access: awaryjna konfiguracja credentiali w UI n8n.

7. Dane testowe

Przygotuj jeden testowy request, np.:

Email: twoj-testowy-adres@example.com
Opis: Szukamy rodzinnego wyjazdu do Barcelony na 4 noce w lipcu. 2 dorosłych i 1 dziecko. Budżet około 4500 PLN za hotel. Chcemy blisko komunikacji, spokojną okolicę, śniadanie i łatwy dojazd do atrakcji. Lubimy jedzenie, spacery i muzea. Nie chcemy imprezowej okolicy.
Częstotliwość: daily

8. Test end-to-end przed spotkaniem

• [ ] Agent tworzy / aktualizuje workflow.
• [ ] Zadanie jest podzielone na małe części dla subagentów Sonnet.
• [ ] Każdy subagent Sonnet pracuje w pętli scout/plan -> work -> test -> work -> test.
• [ ] Każdy workflow / moduł ma niezależny raport testowy Sonnet.
• [ ] Agent sprawdza, że workflow ma komplet node’ów.
• [ ] Test formularza zapisuje wiersz w Data Table.
• [ ] Test scheduler/monitoringu znajduje rekord do obsłużenia.
• [ ] SerpApi zwraca hotele.
• [ ] Ranking AI zwraca TOP 3 i best hotel.
• [ ] Destination Guide zwraca poprawny JSON.
• [ ] Travel Advisor zwraca poprawny JSON.
• [ ] Parse Final Recommendation buduje pełną treść maila, nie tylko krótki wstęp.
• [ ] Gmail wysyła realny mail na testowy adres.
• [ ] Agent przez MCP sprawdza skrzynkę i potwierdza, że mail doszedł.
• [ ] Data Table ma last_sent_at, recommendation_subject, recommendation_body, destination_guide.
• [ ] Agent Opus robi finalną weryfikację całego flow end-to-end.
• [ ] Istnieje opus-final-verification.md z jednoznacznym potwierdzeniem działania albo opisem blockerów.
• [ ] Agent zapisuje raport końcowy z dowodami.

9. Fallback na spotkanie

• [ ] Eksport gotowego workflowu JSON zapisany lokalnie.
• [ ] Screenshot / krótki opis udanego maila testowego.
• [ ] Raport agenta z ostatniego przebiegu.
• [ ] Krótkie zdanie na wypadek niedowiezienia live: „agent zostawił ślad pracy, logi i punkt kolejnej iteracji, to też jest normalna praca z agentem”.