# Wytrenuj Atlasa na swojej bazie wiedzy

> Skonfiguruj źródła, dbaj o poprawność odpowiedzi i bezpiecznie połącz Claude Code lub Codex z bazą wiedzy TicketCord.

## Co Atlas może przetwarzać

Źródła dodajesz w konfiguracji bazy wiedzy w panelu. Są trzy:

- **Pojedyncza strona.** Wskaż Atlasowi adres URL, a on przeszuka stronę (i kilka konfigurowalnych poziomów w głąb). Najlepsze dla dokumentacji pomocy, FAQ i stron produktowych, które już utrzymujesz w swojej witrynie.
- **Kanał Discord.** Zaimportuj historię wiadomości z kanału Discord - przydatne, gdy Twój zespół wsparcia odpowiadał już publicznie na te same pytania, a Ty chcesz, aby Atlas uczył się z tych odpowiedzi.
- **Repozytorium GitHub.** Podlinkuj repozytorium i opcjonalną ścieżkę; Atlas indeksuje każdy znaleziony tam plik Markdown (`.md`, `.mdx`). Dobre dla zespołów inżynierskich, które trzymają dokumentację w tym samym miejscu co kod.

## Strukturyzowanie wpisów

Mniejsze, skoncentrowane źródła działają lepiej niż jedna ogromna strona. Z centrum pomocy z osobnym artykułem na każdy temat („Polityka zwrotów”, „Anulowania”, „Dostępność regionalna”) Atlasowi znacznie łatwiej wyciągnąć czyste odpowiedzi niż z jednego mega-dokumentu „Wszystko, co musisz wiedzieć”. Atlas cytuje w odpowiedzi użyte źródło, więc szczegółowe źródła czynią też cytaty bardziej przydatnymi.

## Pozwól personelowi uczyć w locie

Gdy personel poprawi szkic Atlasa przed wysłaniem, poprawka jest zapisywana jako wpis Q&A i dodawana do bazy wiedzy. Następnie konkuruje z pozostałymi źródłami przy kolejnym podobnym pytaniu - w rankingu według trafności i głosów społeczności - więc dobre poprawki z czasem same się przebijają. Nie trzeba uruchamiać żadnego ponownego trenowania; nowe wpisy są przeszukiwalne natychmiast.

## Czego nie umieszczać

- Sekretów, haseł, kluczy API, danych klientów.
- Nieaktualnych zasad. Atlas traktuje każdy wpis jako aktualny.
- Notatek o trwających incydentach. Do nich używaj szablonów odpowiedzi.

## Kontrola jakości

Co jakiś czas otwieraj listę bazy wiedzy w panelu i przeglądaj ją pod kątem nieaktualnych wpisów. Jeśli odpowiedź się zmieniła (cennik, zasady, obsługiwany region), edytuj lub usuń wpis, aby Atlas przestał cytować nieaktualną wersję. Po większych zmianach w dokumentacji ponownie przeszukaj wpisy oparte na URL, aby indeks odzwierciedlał to, co Twoi klienci faktycznie znajdą w Twojej witrynie.

## Zarządzaj bazą wiedzy za pomocą narzędzi AI

**MCP** to bezpieczne połączenie, które pozwala Claude Code lub Codex pracować z bazą wiedzy TicketCord po zalogowaniu i zatwierdzeniu dostępu. Możesz używać zwykłego języka zamiast przechodzić przez każdy ekran panelu.

## Przed połączeniem

- Musisz być właścicielem konta TicketCord. Pracownicy z dostępem do panelu nie mogą utworzyć połączenia MCP.
- Twój aktywny plan musi obejmować dostęp do bazy wiedzy.
- Zainstaluj Claude Code lub Codex CLI i upewnij się, że możesz zalogować się do TicketCord.
- Jedno połączenie może uzyskać dostęp do wszystkich serwerów, które posiadasz teraz lub dodasz później. Każde żądanie nadal wskazuje jednego bota i serwer, a TicketCord ponownie sprawdza własność i plan za każdym razem.

## Połącz Claude Code lub Codex

1. W panelu wybierz bota i serwer. Otwórz **Baza wiedzy > Konfiguracja** i znajdź **Połącz narzędzia AI**.
2. Dla Claude Code uruchom `claude mcp add --transport http ticketcord https://ticketcord.com/api/mcp --scope user`, a następnie `claude mcp login ticketcord`.
3. Dla Codex uruchom `codex mcp add ticketcord --url https://ticketcord.com/api/mcp`, a następnie `codex mcp login ticketcord`.
4. TicketCord otworzy się w przeglądarce. Zaloguj się, przeczytaj ostrzeżenie o dostępie do całego konta oraz żądane uprawnienia do odczytu, zapisu i usuwania. Następnie wybierz **Zezwól na dostęp** lub **Odmów**.
5. Gdy zobaczysz **Uwierzytelnianie zakończone**, zamknij kartę i wróć do narzędzia AI. Spróbuj: `Wyświetl moje bazy wiedzy TicketCord.`

## O co możesz poprosić

- Wyświetlić bazy wiedzy i sprawdzić ustawienia, źródła, stan indeksowania oraz wpisy.
- Wyszukiwać według znaczenia i zwracać krótkie pasujące fragmenty z nazwą źródła i poziomem pewności.
- Dodawać, edytować, włączać, wyłączać, ponownie indeksować lub usuwać strony internetowe, kanały Discord oraz wcześniej połączone źródła GitHub.
- Tworzyć i edytować wpisy, sprawdzać oczekujące wpisy oraz je zatwierdzać, odrzucać lub usuwać.
- Aktualizować ustawienia dostępne w panelu dla informacji o produkcie, wyzwalaczy, wyglądu, jakości, aktualizacji, zachowania, opinii, uczenia z ticketów i Auto Support.

## Przydatne przykładowe prośby

- `Wyświetl moje bazy wiedzy i pokaż, które nie mają gotowych źródeł.`
- `Wyszukaj naszą politykę zwrotów i podsumuj ją z nazwami źródeł.`
- `Znajdź wpisy zawierające stare ceny. Najpierw je pokaż i niczego nie zmieniaj.`
- `Dodaj https://docs.example.com jako źródło dokumentacji i rozpocznij indeksowanie.`
- `Pokaż oczekujące wpisy i przed zmianami doradź zatwierdzenie lub odrzucenie.`
- `Pokaż aktualną odpowiedź dotyczącą resetowania hasła, a potem pomóż mi ją zaktualizować.`

## Uprawnienia, bezpieczeństwo i dostęp

- Dostęp do odczytu umożliwia przeglądanie i wyszukiwanie wiedzy. Zapis pozwala zmieniać ustawienia, źródła i wpisy. Usuwanie pozwala trwale kasować źródła i wpisy.
- Przed ryzykowną zmianą poproś narzędzie AI, aby najpierw pokazało znalezione dane i wyjaśniło planowane działanie.
- Usunięcie jest trwałe. TicketCord ponownie sprawdza uprawnienia przy każdym żądaniu, nawet po zatwierdzeniu połączenia.
- Jeśli plan wygaśnie lub utraci dostęp do bazy wiedzy, połączenie zostanie wstrzymane. Może działać ponownie po przejściu na odpowiedni plan, chyba że zostało odwołane lub wygasł dostęp do odnowienia.
- Natychmiast odwołaj połączenie na karcie **Połącz narzędzia AI** w konfiguracji bazy wiedzy.
- Łączenie i odłączanie konta GitHub nadal odbywa się wyłącznie w panelu. Nigdy nie zapisuj w bazie wiedzy haseł, kluczy API, sekretów ani danych klientów.

## Zasoby do odczytu maszynowego

- [Kanoniczny HTML](https://ticketcord.com/pl/help/ai/knowledge-base)
- [TicketCord llms.txt](https://ticketcord.com/llms.txt)
- [Indeks AI stron](https://ticketcord.com/api/ai/pages)