Jak agent AI ma czytać tę bazę

Ta baza jest pisana dla dwóch odbiorców naraz: dla osoby z klubu i dla agenta AI, który pracuje przez narzędzia MCP Sportigio (/api/v1/mcp) albo REST /api/v1. Agentem może być asystent w panelu klubu, Claude lub Codex z kluczem API, albo integracja klubu.

Skąd brać treść

• Cała baza jednym plikiem: /llms-full.txt (pełny tekst) i /llms.txt (spis stron z opisami). Oba pliki są generowane z tych samych stron, które czyta człowiek.
• Jedna strona: adres strony bez zmian; treść jest zwykłym HTML z nagłówkami H2.
• Język źródłowy to polski. Wersje EN i DE są lustrami i mogą być o krok w tyle.

Kolejność działań agenta

1. Ustal cel klubu, nie ekran. Dopasuj do scenariusza z tej bazy po tytule i polu id (UC-004).
2. Przeczytaj “Zanim zaczniesz” i sprawdź warunki narzędziami do odczytu: get_website_status, get_plan_info, get_module_catalog, list_*.
3. Wykonaj sekcję “Przez API / MCP” narzędziami dokładnie o tych nazwach. Nazwy pochodzą z tools/list; jeśli narzędzia nie ma na Twojej liście, nie zgaduj - klucz może nie mieć scope’u.
4. Zweryfikuj efekt odczytem (list_page_blocks, get_post, list_games) i podaj klubowi publiczny adres do sprawdzenia.
5. Powiedz wprost, czego nie zrobiłeś. Jeśli krok jest tylko w panelu, podaj ścieżkę dokładnie tak, jak w sekcji “Krok po kroku w panelu”, jako klikalny link.

Kontekst klubu

• Klucz klubu działa w kontekście tego klubu automatycznie.
• Klucz platformowy (Sportigio) wymaga space_id w każdym wywołaniu. use_space działa tylko w obrębie jednego requestu i nie przenosi się na kolejne. Bez space_id listy wracają puste i wygląda to jak “klub bez danych”.

Pliki i obrazy

• Każde pole graficzne w API (logo_url, photo_url, image_url) przyjmuje publiczny adres https. Adresy prywatne, lokalne i wewnętrzne są odrzucane; niektóre narzędzia w takim wypadku po cichu używają grafiki domyślnej.
• Plik z dysku wgrywasz przez POST /api/v1/uploads (multipart file=@...) i używasz zwróconego url. Narzędzie upload_file przyjmuje tylko url albo małe data_base64.

Czego nie obiecywać

• Sprzedaży i zwrotów biletów, wysyłki newsletterów i push (tylko szkice), zmian planu, zarządzania zespołem, własnej domeny (zgłoszenie do wsparcia przez report_support_issue).
• Sekcji, których nie ma w katalogu API: karuzela kart, licznik biletów, sklep, social media, sekcja z kolumnami - te tylko w panelu.

Gdy baza i narzędzie się różnią

Twoja aktualna lista narzędzi jest źródłem prawdy o tym, co umiesz. Ta baza mówi, jak to robić i co klub widzi. Jeśli narzędzie istnieje, a baza o nim milczy, użyj narzędzia i zgłoś brak w bazie (Rozwijanie bazy).