Wprowadzenie do AI Asystenta

Poznaj inteligentnego pomocnika, który odpowiada na pytania o zarządzanie serwerami ARK i FiveM.

Czym jest AI Asystent?

AI Asystent to zaawansowany chatbot oparty na OpenAI GPT-4, zintegrowany bezpośrednio z platformą SGS Hub. Został zaprojektowany, aby pomagać w:

• Konfigurowaniu serwerów - ustawienia, parametry, optymalizacja
• Zarządzaniu modami - instalacja, konflikty, kolejność ładowania
• Rozwiązywaniu problemów - diagnostyka błędów, troubleshooting
• Uczeniu się platformy - jak korzystać z funkcji SGS Hub
• Planowaniu klastrów - konfiguracja multi-serwerowa
• Optymalizacji wydajności - CPU, RAM, sieć

W przeciwieństwie do zwykłego ChatGPT, AI Asystent:

• ✅ Ma aktualną wiedzę o ARK, FiveM i SGS Hub (aktualizowana co tydzień)
• ✅ Rozumie kontekst Twoich serwerów i konfiguracji
• ✅ Podaje konkretne instrukcje dostosowane do platformy
• ✅ Weryfikuje odpowiedzi z oficjalną dokumentacją
• ❌ Nie zna ogólnych tematów niezwiązanych z grami serwerowymi

Technologia RAG

AI Asystent wykorzystuje RAG (Retrieval-Augmented Generation) - hybrydową metodę łączącą:

1. Retrieval (Pobieranie) - wyszukiwanie w bazie wiedzy
2. Augmented (Wzbogacanie) - dodanie kontekstu do zapytania
3. Generation (Generowanie) - tworzenie odpowiedzi przez GPT-4

Jak to działa?

Twoje pytanie: "Jak zwiększyć XP multiplier?"
      ↓
[1] System wyszukuje w bazie wiedzy:
    - Oficjalna dokumentacja ARK
    - Wiki SGS Hub
    - Poradniki społeczności
      ↓
[2] Znajduje fragmenty:
    - "XPMultiplier w GameUserSettings.ini"
    - "Zakres wartości: 0.1 - 100.0"
    - "Domyślnie: 1.0"
      ↓
[3] GPT-4 generuje odpowiedź:
    "Aby zwiększyć mnożnik XP, edytuj plik
     GameUserSettings.ini w sekcji [/Script/ShooterGame.ShooterGameMode]
     i ustaw XPMultiplier=3.0 dla 3x doświadczenia..."

Zalety RAG

Aspekt	Zwykły ChatGPT	AI Asystent (RAG)
Wiedza o ARK	Do stycznia 2022	Aktualizowana co tydzień
Znajomość SGS Hub	Brak	Pełna dokumentacja
Źródło informacji	Ogólny internet	Oficjalne wiki + testy
Halucynacje (zmyślanie)	Częste przy szczegółach	Minimalne (weryfikacja)
Kontekst rozmowy	4-8 wiadomości	Całą sesja + Twoje serwery

Wiarygodność

AI Asystent podaje źródła informacji (linki do dokumentacji), dzięki czemu możesz zweryfikować odpowiedź samodzielnie.

Dostępność według planów

Dostęp do AI Asystenta zależy od Twojego planu subskrypcji:

Plan	Zapytania/godzinę	Zapytania/dzień	Priorytet	Historia
Free	5	20	Niski	7 dni
Starter	20	100	Normalny	30 dni
Pro	50	300	Wysoki	90 dni
Enterprise	100	1,000	Najwyższy	365 dni

Priorytet oznacza kolejność przetwarzania zapytań podczas dużego obciążenia:

• Niski - odpowiedź w ciągu 5-15 sekund
• Normalny - odpowiedź w ciągu 3-8 sekund
• Wysoki - odpowiedź w ciągu 2-5 sekund
• Najwyższy - odpowiedź w ciągu 1-3 sekund

Historia to okres przechowywania rozmów. Starsze rozmowy są automatycznie usuwane.

Limity

Po przekroczeniu limitu godzinowego zobaczysz komunikat "Rate limit exceeded. Spróbuj ponownie za X minut." Limit dzienny resetuje się o 00:00 UTC.

Sprawdzanie pozostałych zapytań

Obecny status limitów znajdziesz:

1. W interfejsie AI Asystenta - licznik w prawym górnym rogu:

   Pozostało: 15/20 (godz.) | 85/100 (dzień)

2. W Dashboard → Wellness → Monitorowanie - sekcja "API Usage"

   • Wykres zapytań w czasie
   • Prognoza przekroczenia limitu

3. Przez API - endpoint /api/user/usage:

   curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://sgshub.eu/api/user/usage

Przypadki użycia

AI Asystent najlepiej sprawdza się w następujących scenariuszach:

1. Konfiguracja serwera ARK

Pytanie:

"Jak skonfigurować serwer PvP z szybszym oswajaniem i 3x XP?"

Odpowiedź AI:

• Konkretne parametry INI
• Wartości dla PvP balance
• Dodatkowe ustawienia (dino damage, player damage)
• Ostrzeżenia o konfliktach

2. Rozwiązywanie problemów z modami

Pytanie:

"Mój serwer nie startuje po dodaniu moda Structures Plus. Co robić?"

Odpowiedź AI:

• Diagnostyka problemu (logi, kolejność ładowania)
• Znane konflikty S+ z innymi modami
• Kroki naprawcze
• Alternatywne mody (jeśli konflikt nierozwiązywalny)

3. Optymalizacja wydajności

Pytanie:

"Serwer laguje przy 50 graczy. Jak zoptymalizować?"

Odpowiedź AI:

• Parametry launch (CPU, RAM allocation)
• Ustawienia INI zmniejszające obciążenie
• Rekomendacje hardware
• Narzędzia monitorowania

4. Nauka platformy SGS Hub

Pytanie:

"Jak ustawić automatyczne backupy co 6 godzin?"

Odpowiedź AI:

• Krok po kroku: Dashboard → Servers → [ID] → Schedules
• Wyrażenie cron: 0 */6 * * *
• Konfiguracja akcji BACKUP
• Limity backupów według planu

5. Planowanie klastra

Pytanie:

"Chcę stworzyć klaster z 5 map ARK. Jak to skonfigurować?"

Odpowiedź AI:

• Wymagania (Pro plan, serwery w tej samej lokalizacji)
• Proces tworzenia klastra (Settings → Cluster)
• Konfiguracja każdego serwera
• Transfer items/dinos (AllowForeignDinoDownloads, etc.)
• Testowanie transferów

6. Porady społecznościowe

Pytanie:

"Jakie mody są najpopularniejsze na serwerach PvE?"

Odpowiedź AI:

• Top 10 modów PvE z opisami
• Linki do CurseForge
• Kombinacje modów (stackable, quality of life)
• Ostrzeżenia o kompatybilności

Co AI Asystent potrafi?

✅ Możliwości

• Wyjaśnianie parametrów - szczegółowe opisy ustawień INI, launch parameters
• Diagnozowanie błędów - analiza logów, komunikatów o błędach
• Rekomendowanie modów - sugestie na podstawie stylu gry (PvP/PvE/RP)
• Generowanie konfiguracji - gotowe snippet'y INI, cron expressions
• Porównywanie opcji - ASE vs ASA, różne mody, plany hostingowe
• Tłumaczenie terminów - wyjaśnianie żargonu ARK/FiveM
• Planowanie upgradów - kiedy przejść na wyższy plan, dodać RAM
• Edukacja - tutorials, best practices, poradniki krok po kroku

❌ Ograniczenia

• Brak dostępu do Twoich danych - AI nie widzi zawartości Twoich plików serwera (bezpieczeństwo)
• Nie wykonuje akcji - nie może uruchomić serwera, zainstalować moda, edytować plików za Ciebie
• Nie zna przyszłości - nie wie o nieogłoszonych aktualizacjach ARK/FiveM
• Ogólne tematy - nie odpowie na pytania niezwiązane z serwerami (np. "jak ugotować pizzę?")
• Nie zastępuje supportu - złożone problemy techniczne wymagają kontaktu z zespołem

Weryfikuj odpowiedzi

AI Asystent stara się być dokładny, ale może popełniać błędy. Zawsze testuj sugestie na serwerze testowym przed wdrożeniem na produkcję.

Bezpieczeństwo i prywatność

Co AI widzi?

AI Asystent ma dostęp tylko do:

• ✅ Pytań, które zadajesz w czacie
• ✅ Historii rozmowy (w ramach sesji)
• ✅ Metadanych Twoich serwerów (nazwy, gra, liczba modów)
• ❌ NIE widzi zawartości plików
• ❌ NIE widzi haseł, kluczy API, tokenów
• ❌ NIE widzi adresów IP, portów RCON

Przechowywanie rozmów

Rozmowy są przechowywane na serwerach SGS Hub:

• Szyfrowanie: AES-256 w spoczynku, TLS 1.3 w tranzycie
• Retencja: Według planu (7-365 dni)
• Dostęp: Tylko Ty + systemy AI (zautomatyzowane)
• Usuwanie: Automatyczne po upływie retencji lub na żądanie (Settings → Data → Delete AI history)

GDPR

Rozmowy z AI są objęte polityką prywatności GDPR. Możesz wyeksportować lub usunąć je w dowolnym momencie. Zobacz Eksport danych.

Ulepszanie AI

SGS Hub wykorzystuje rozmowy do:

• Treningu modeli - anonimizowane dane poprawiają jakość odpowiedzi
• A/B testing - testowanie różnych promptów dla lepszej trafności
• Feedback loop - "Czy ta odpowiedź była pomocna?" poprawia przyszłe odpowiedzi

Możesz wyłączyć udział w ulepszaniu:

1. Dashboard → Wellness → Ustawienia
2. Zakładka "Prywatność"
3. Odznacz: ☐ "Zezwól na używanie moich rozmów do ulepszania AI"

Uwaga: Wyłączenie nie wpływa na jakość odpowiedzi, ale ogranicza naszą zdolność do personalizacji AI.

Jak zacząć?

Gotowy do rozmowy z AI Asystentem?

1. Przejdź do Dashboard → AI Assistant
2. Wpisz pytanie w pole tekstowe
3. Kliknij "Wyślij" lub naciśnij Enter
4. Poczekaj 2-5 sekund na odpowiedź
5. Oceń odpowiedź: 👍 Pomocna / 👎 Niepomocna

Przykładowe pierwsze pytanie:

"Wyjaśnij mi różnicę między ARK: Survival Evolved a ARK: Survival Ascended."

Konkretność

Im bardziej szczegółowe pytanie, tym lepsza odpowiedź. Zamiast "Jak ustawić serwer?", zapytaj "Jak ustawić serwer ARK ASA PvP z 3x rates na mapie The Island?".

Metryki i analityka

AI Asystent zbiera anonimowe metryki:

Metryka	Opis	Cel
Query count	Liczba zadanych pytań	Monitorowanie limitów
Response time	Czas generowania odpowiedzi (ms)	Optymalizacja wydajności
Satisfaction score	Średnia ocen 👍/👎	Jakość odpowiedzi
Token usage	Zużycie tokenów GPT-4	Koszty, limitowanie
Topic distribution	Rozkład tematów (serwery/mody/troubleshooting)	Priorytetyzacja treści
Follow-up rate	% rozmów z więcej niż 1 pytaniem	Engagement

Swoje statystyki zobaczysz w: Dashboard → Wellness → Monitorowanie → sekcja "AI Assistant"

Eksperymentalne funkcje (Beta)

Dla użytkowników Pro i Enterprise dostępne są funkcje beta:

🧪 Asystent kontekstowy

AI automatycznie "czyta" kontekst z aktualnej strony:

• Jesteś na Servers → [ID] → Mods → AI wie, o którym serwerze mówisz
• Pytasz "Jaki mod dodać?" → AI sugeruje mody pasujące do Twojej listy

Włączanie: Settings → Interfejs → Eksperymenty → ☑ "Asystent kontekstowy"

🧪 Multi-turn conversations

AI "pamięta" wcześniejsze pytania w sesji:

• Pytanie 1: "Jak zwiększyć taming speed?"
• Pytanie 2: "A co z breeding?" ← AI rozumie, że chodzi o ARK, kontynuuje temat

Domyślnie włączone dla Pro+, można wyłączyć dla szybszych odpowiedzi.

🧪 Generowanie skryptów

AI może wygenerować gotowe:

• Pliki .ini z Twoją konfiguracją
• Skrypty bash do automatyzacji
• Wyrażenia cron dla harmonogramów

Przykład:

"Wygeneruj GameUserSettings.ini dla serwera PvP z 3x rates."

→ AI zwróci pełny plik do skopiowania.

Beta

Funkcje beta mogą być niestabilne. Zawsze testuj wygenerowane skrypty przed użyciem na produkcji.

Porównanie z alternatywami

Narzędzie	Wiedza ARK/FiveM	Kontekst SGS Hub	Koszt	Szybkość
AI Asystent SGS Hub	⭐⭐⭐⭐⭐ Aktualna	⭐⭐⭐⭐⭐ Pełna	Wliczone w plan	2-5s
ChatGPT (ogólny)	⭐⭐⭐ Do 2022	⭐ Brak	$20/miesiąc	1-3s
ARK Wiki	⭐⭐⭐⭐ Dobra	⭐ Brak	Darmowe	N/A (ręczne)
FiveM Forum	⭐⭐⭐⭐ Społeczność	⭐ Brak	Darmowe	Godziny (czekanie)
Support SGS Hub	⭐⭐⭐⭐⭐ Ekspercka	⭐⭐⭐⭐⭐ Pełna	Wliczone	2-24h (email)

Kiedy użyć czego?

• AI Asystent - szybkie pytania, konfiguracja, nauka
• ChatGPT - kreatywne pomysły, ogólne koncepcje
• Wiki - szczegółowa dokumentacja, referencje
• Forum - społeczność, najlepsze praktyki, mody
• Support - złożone problemy techniczne, błędy platformy

Roadmapa

Planowane funkcje AI Asystenta:

Q1 2026:

• 🔜 Integracja z Discord (zadawaj pytania przez bota)
• 🔜 Głosowe zapytania (mów zamiast pisać)
• 🔜 Tłumaczenie na angielski (rozmowy po polsku i angielsku)

Q2 2026:

• 🔜 AI Moderator (automatyczne odpowiedzi na tickety supportowe)
• 🔜 Predykcje problemów (AI przewiduje awarie na podstawie metryk)
• 🔜 Automatyczne skrypty (AI pisze i wdraża konfiguracje za Ciebie - wymaga zgody)

Q3-Q4 2026:

• 🔜 AI Cluster Planner (wizualizacja i automatyczna konfiguracja klastrów)
• 🔜 Integracja z mods (AI sugeruje mody na podstawie statystyk serwera)
• 🔜 Personalizacja (AI uczy się Twoich preferencji)

Wpływ społeczności

Masz pomysł na funkcję AI? Zgłoś w Forum Społeczności w sekcji "AI Ideas" - najbardziej popularne pomysły trafiają do roadmapy!

Często zadawane pytania

Czy AI Asystent działa offline? Nie, wymaga połączenia z internetem (zapytania są przetwarzane przez OpenAI GPT-4).

Czy mogę używać AI Asystenta przez API? Tak, endpoint /api/ai/chat jest dostępny dla kluczy API z zakresem "AI Assistant". Zobacz API Reference.

Czy AI może "zhakować" mój serwer? Nie. AI nie ma dostępu do wykonywania komend, edytowania plików ani połączeń RCON. Może tylko generować tekstowe sugestie, które Ty wdrażasz ręcznie.

Co jeśli AI da złą radę? Oceń odpowiedź negatywnie (👎) i napisz, co było nie tak. Zespół SGS Hub przegląda negatywne oceny i poprawia prompt systemu. W razie poważnych konsekwencji skontaktuj się z supportem.

Czy rozmowy są moderowane? Nie czytamy rozmów ręcznie, chyba że zgłosisz problem. Systemy automatyczne flagują abuse (spam, próby hakowania, obraźliwe treści).

Powiązane strony

• Jak używać AI Asystenta - praktyczny tutorial z przykładami
• Najlepsze praktyki - jak formułować pytania dla najlepszych odpowiedzi
• Monitorowanie użycia - śledzenie limitów i metryk AI
• API Reference: AI Chat - programatyczny dostęp do AI