Jak przygotować dokumentację na potrzeby ChatGPT i Claude

Zaktualizowano 3 listopada 2026 r.

Aby przygotować dokumentację pod AI, zacznij od podstaw, które mają udowodnione znaczenie: crawlery AI muszą być w stanie pobierać strony jako zwykły HTML, plik robots.txt musi wpuszczać boty wyszukiwarek, a każdy artykuł musi jasno odpowiadać na jedno pytanie, określając plan, rolę i ograniczenia. Dbaj o aktualność stron, a następnie dodaj kopie w formacie Markdown, plik llms.txt oraz serwer MCP dla agentów AI. Te dodatki są tanie, ale ich mierzalny wpływ na odpowiedzi AI jest na razie niewielki.

Ten przewodnik jest przeznaczony dla liderów wsparcia, których klienci pytają teraz ChatGPT, Perplexity lub AI Overviews od Google o to, jak korzystać z produktu, oraz dla zespołów, których programiści wskazują Claude Code lub Cursor na dokumentację. Rozdziela on to, co ma potwierdzenie w faktach, od tego, co wciąż jest tylko zakładem.

Co oznacza dokumentacja gotowa na AI?#

Dokumentacja gotowa na AI to taka, którą systemy AI mogą pobrać, zrozumieć i poprawnie zacytować: dokumentacja czytelna dla silników odpowiedzi oraz dokumentacja dla agentów AI, którzy na jej podstawie działają. Liczą się dwa rodzaje odbiorców:

• Silniki odpowiedzi (wyszukiwarka ChatGPT, Perplexity, Claude, Google AI Overviews i AI Mode) odpowiadają na pytania klientów i cytują strony jako źródła.
• Agenci AI (Claude Code, Cursor, Codex, niestandardowi asystenci) czytają dokumentację, aby wykonać zadanie, często za pośrednictwem plików Markdown lub serwera MCP.

Obie grupy szybko rosną. Badanie Stack Overflow z 2025 r. wykazało, że 84% programistów używa lub planuje używać narzędzi AI, a Similarweb odnotował 1,13 miliarda wizyt skierowanych z platform AI w czerwcu 2025 r., co oznacza wzrost o 357% rok do roku, przy czym ChatGPT odpowiada za ponad 80% z nich. A kiedy Google wyświetla podsumowanie AI, ludzie rzadziej klikają w linki: Pew Research ustalił, że użytkownicy klikali w link do wyniku w 8% wizyt z podsumowaniem AI, w porównaniu do 15% bez niego. Jeśli odpowiedź jest wyświetlana bez kliknięcia, musi być poprawna, a jest tylko tak poprawna, jak Twoja dokumentacja. Więcej liczb na temat tego, gdzie klienci szukają pomocy, znajduje się w naszych statystykach samoobsługi klientów.

Czy crawlery AI faktycznie potrafią przeczytać Twoje centrum pomocy?#

Sprawdź to w pierwszej kolejności, ponieważ nic innego nie ma znaczenia, jeśli odpowiedź brzmi „nie”.

Czy tekst znajduje się w kodzie HTML? Analiza ruchu crawlerów przeprowadzona przez Vercel w grudniu 2024 r. wykazała, że żaden z głównych crawlerów AI nie renderuje JavaScriptu, z wyjątkiem crawlera Gemini od Google i crawlera Apple. Centrum pomocy, które ładuje artykuły za pomocą JavaScriptu po stronie klienta, może wyglądać na puste dla crawlerów ChatGPT i Claude. Przetestuj to:

curl -s -A "GPTBot" https://help.example.com/your-article \
  | grep "a sentence from the article"

Jeśli zdania nie ma w odpowiedzi, crawler również go nie widzi. Strony renderowane po stronie serwera lub wstępnie renderowane rozwiązują ten problem.

Czy Twoje adresy URL działają? W tych samych danych Vercel około 35% pobrań przez crawlery ChatGPT i Claude trafiało na strony 404. Zachowaj przekierowania podczas przenoszenia lub zmiany nazw artykułów i dbaj o aktualność mapy witryny. Jeśli zmieniasz platformę, skorzystaj z listy kontrolnej migracji centrum pomocy.

Czy strona jest publiczna? Silniki odpowiedzi nie mogą czytać stron za logowaniem. Jeśli masz prywatną dokumentację dla klientów, pogódź się z tym, że odpowiedzi AI będą pochodzić z Twoich publicznych stron, forów i witryn stron trzecich.

Które boty AI powinny mieć dostęp w Twoim pliku robots.txt?#

Każda firma AI prowadzi oddzielne boty do trenowania i do wyszukiwania. Blokowanie „wszystkich botów AI” usuwa Cię również z odpowiedzi AI.

Szczegóły pochodzą z dokumentacji każdej z firm: OpenAI, Anthropic i Perplexity. Centrum pomocy, które chce być cytowane, ale nie chce być używane do trenowania, może określić:

User-agent: GPTBot
Disallow: /

User-agent: ClaudeBot
Disallow: /

User-agent: Google-Extended
Disallow: /

User-agent: *
Allow: /

Sitemap: https://help.example.com/sitemap.xml

Bot, który ma własną grupę, ignoruje reguły *, więc powtórz wszystkie linie Disallow (takie jak /admin) w każdej nazwanej grupie. Zablokowanie Google-Extended powstrzymuje również aplikacje Gemini przed ugruntowywaniem odpowiedzi na podstawie Twoich stron; wyszukiwarka Google i AI Overviews pozostają bez zmian.

Sprawdź również swój CDN lub zaporę sieciową. Przełącznik „blokuj boty AI” w tych miejscach może nadpisać permisywny plik robots.txt.

Jak pisać artykuły pomocy, aby AI odpowiadała poprawnie?#

Silniki odpowiedzi pobierają fragment, a nie całą witrynę. Każdy fragment musi bronić się sam.

• Jedno zadanie na artykuł, nazwane tak, jak pytają klienci. „Anuluj lub wstrzymaj subskrypcję”, a nie „Zarządzanie subskrypcją”.
• Odpowiedź na wstępie. Pierwsze dwa zdania pod każdym nagłówkiem powinny odpowiadać na ten nagłówek. Nasz szablon artykułu centrum pomocy jest zbudowany w ten sposób.
• Określ warunki. Jaki plan, jaka rola, jaka platforma. „Tylko administratorzy mogą usunąć obszar roboczy” nadaje się do cytowania; „możesz usunąć obszar roboczy” generuje błędne odpowiedzi dla wszystkich innych.
• Powiedz, czego produkt nie potrafi. Asystenci są często pytani „czy mogę…?”. Jeśli Twoja dokumentacja opisuje tylko to, co istnieje, model zgaduje.
• Używaj jednej nazwy dla jednej rzeczy i zdefiniuj ją raz. Jeśli „obszar roboczy”, „konto” i „organizacja” oznaczają to samo, wybierz jedno i prowadź krótki słowniczek definiujący terminy Twojego produktu.
• Nadaj każdej stronie czyste metadane. Konkretny tytuł, opis w jednym zdaniu, datę ostatniej aktualizacji oraz, jeśli dotyczy, plan lub obszar produktu. Silniki odpowiedzi i Twoja własna wyszukiwarka używają ich do decydowania, która strona odpowiada na pytanie.
• Nie ukrywaj kroków na obrazkach lub w filmach. Nadaj każdemu zrzutowi ekranu prawdziwy tekst alternatywny i upewnij się, że każdy krok pokazany na filmie istnieje również w formie tekstowej.
• Omów podstawy przed przypadkami brzegowymi. Jeśli dopiero budujesz centrum pomocy, zacznij od tego, jak zbudować bazę wiedzy z AI.
• Dbaj o aktualność. Nieaktualny artykuł to teraz nieaktualna odpowiedź, powtarzana z pewnością siebie. Nasz przewodnik po utrzymywaniu dokumentacji w aktualności obejmuje rutynę wydanie po wydaniu, a jak automatycznie aktualizować dokumentację przy każdym wydaniu pokazuje, jak zacząć od samego wydania.

Google mówi to samo prostszymi słowami: w przypadku swoich funkcji AI „nie ma dodatkowych wymagań” i nie są potrzebne żadne specjalne optymalizacje poza standardowym SEO. Jego przewodnik mówi również, że nie ma wymogu dzielenia treści na małe kawałki dla AI, więc nie tnij artykułów na fragmenty, aby dopasować je do modelu.

Czy warto dodać llms.txt do dokumentacji?#

Pomaga to mniej, niż sugerują dostawcy. llms.txt to plik Markdown w katalogu głównym Twojej witryny, który wymienia Twoje najbardziej przydatne strony z krótkimi opisami. Jeremy Howard zaproponował go we wrześniu 2024 r. jako mapę dla modeli językowych.

Dotychczasowe dowody:

• Google to ignoruje. Przewodnik Google mówi, że nie potrzebujesz nowych plików czytelnych dla maszyn, plików tekstowych AI, znaczników ani Markdown, aby pojawić się w wyszukiwarce Google, a pliki llms.txt ani nie pomogą, ani nie zaszkodzą, ponieważ wyszukiwarka je ignoruje. W 2025 roku John Mueller z Google porównał llms.txt do meta tagu słów kluczowych.
• Niewiele botów o to prosi. Ahrefs przeanalizował 137 210 domen i odkrył, że 97% plików llms.txt nie otrzymało żadnych zapytań w maju 2026 roku. Boty pobierające dane dla AI stanowiły zaledwie 1,1% zapytań, które faktycznie dotarły (asystenci AI kolejne 2,5%); agenci kodujący, tacy jak Claude Code, byli wśród głównych wymienionych czytelników.

Więc: dodaj llms.txt, jeśli Twoja platforma dokumentacji oferuje to za darmo, zwłaszcza jeśli programiści korzystają z Twojej dokumentacji za pomocą agentów kodujących, ale nie oczekuj, że zmieni to, co ChatGPT mówi na Twój temat. llms-full.txt (wszystkie strony w jednym pliku) to powszechna konwencja, a nie część propozycji.

Czy Twoja dokumentacja powinna być dostępna w formacie Markdown?#

Tak, jeśli nic Cię to nie kosztuje. Agenci pobierający stronę działają lepiej z czystym Markdownem niż z HTML-em pełnym nawigacji i skryptów, a propozycja llms.txt sugeruje serwowanie każdej strony pod tym samym adresem URL z dodanym .md. Trzy szczegóły:

• Oznacz kopie Markdown jako noindex (działa nagłówek X-Robots-Tag), aby wyszukiwarki nie traktowały ich jako duplikatów stron HTML.
• Utrzymuj je generowane z tego samego źródła co HTML, aby nigdy się nie rozbiegły.
• Pozwól agentom je znaleźć: propozycja sugeruje tag <link rel="alternate" type="text/markdown"> na każdej stronie HTML.

Jak agenci AI korzystają z dokumentacji przez MCP?#

Model Context Protocol to otwarty standard, który pozwala aplikacji AI wywoływać narzędzia i odczytywać dane z innych systemów. Serwer MCP dokumentacji pozwala agentowi przeszukiwać Twoją dokumentację na żądanie, zamiast polegać na tym, czego nauczył się podczas treningu, oraz, przy odpowiednich uprawnieniach, tworzyć lub aktualizować strony. Porównanie dostępnych serwerów znajdziesz w serwerach MCP dla dokumentacji.

Te same zasady obowiązują, jeśli budujesz własnego asystenta w oparciu o swoją dokumentację (generowanie wspomagane wyszukiwaniem, czyli RAG): może on być tylko tak dokładny, jak fragmenty, które pobiera. Dwie przestrogi: przyznaj dostęp tylko do odczytu do wszystkiego, co jest widoczne dla klienta, chyba że człowiek sprawdza zapisy, i pamiętaj, że MCP pomaga agentom, z którymi łączą się Twoi użytkownicy. Nie zmienia to tego, co mówią publiczne silniki odpowiedzi.

Jak przetestować, co asystenci AI mówią o Twoim produkcie?#

Nikt nie widzi, co dzieje się wewnątrz modeli, więc testuj wyniki. Raz w miesiącu:

1. Zapisz 20 prawdziwych pytań klientów z ticketów i nieudanych wyszukiwań w centrum pomocy.
2. Zadaj każde z nich w ChatGPT, Perplexity, Claude i Google (tryb AI lub AI Overviews).
3. Zapisz, czy odpowiedź jest poprawna i na jaką stronę się powołuje.

4. Popraw artykuł, z którego powinna pochodzić każda błędna odpowiedź, a następnie zapytaj ponownie w przyszłym miesiącu.

Aby zobaczyć stronę ruchu, segmentuj wizyty według źródła (chatgpt.com, perplexity.ai, claude.ai) i sprawdzaj logi serwera pod kątem nazw botów w powyższej tabeli (z wyjątkiem Google-Extended, który nie ma własnego user agenta). Google liczy kliknięcia z funkcji AI w raporcie skuteczności Search Console w typie wyszukiwania Web.

Jak przygotować dokumentację pod AI: lista kontrolna#

Jak centra pomocy Clevera są budowane dla czytelników AI#

Clevera to platforma AI, która zamienia nagranie ekranu w narracyjny film instruktażowy, artykuł pomocy krok po kroku oraz stronę w Twoim hostowanym centrum pomocy, w 74 językach. Jej hostowane centra pomocy obsługują większość technicznej połowy listy kontrolnej, w każdym planie, w tym Free:

• Prerenderowane strony i mapa witryny, dzięki czemu tekst artykułu znajduje się w HTML, który pobierają crawlery.
• llms.txt, llms-full.txt i .md kopia każdej strony, w ustawieniu llms.txt i kopie Markdown ("Pozwala narzędziom AI czytać Twoją dokumentację"), które jest domyślnie włączone. W naszym własnym centrum pomocy kopie Markdown są serwowane z noindex. Prywatne centra pomocy (Pro i wyżej) trzymają to wszystko za logowaniem.
• Zapytaj AI dla swoich czytelników (włącz Pokaż asystenta w Ustawienia → Asystent AI; 300 odpowiedzi miesięcznie w planie Free). Wbudowany asystent odpowiada tylko na podstawie Twoich opublikowanych stron, podaje źródła, informuje, gdy dokumentacja nie obejmuje pytania, i wymienia te pytania w sekcji Nieodpowiedziane pytania, abyś wiedział, co napisać w następnej kolejności (nasz przewodnik po lukach w treści centrum pomocy pokazuje, jak nad nimi pracować).
• Agenci AI i MCP (Pro i wyżej). Claude Code, Codex, Cursor, Claude lub ChatGPT mogą przeszukiwać, tworzyć i, przy posiadaniu praw do publikacji, aktualizować Twoje centrum pomocy za pośrednictwem serwera MCP i API Clevera. Token Asystenta wsparcia może przeszukiwać tylko opublikowane, publiczne strony.

To jest góra llms.txt, którą publikuje nasze własne centrum pomocy (skrócona):

# Clevera Help Center

> Clevera turns screen recordings into polished videos: record your screen
> or let the AI record a website, edit with zooms, captions and AI
> voice-overs, then share or embed the result. ...

Every page is also available as Markdown: append `.md` to its URL.
The full text of all pages is at https://help.clevera.ai/llms-full.txt.

### Getting started

- [Understand what Clevera makes](https://help.clevera.ai/docs/getting-started/what-clevera-makes.md): ...

Połowa pisarska nadal należy do Ciebie, a Clevera pomaga również w tym: artykuły generowane z nagrania ekranu wychodzą jako numerowane kroki ze zrzutami ekranu tego, co jest na ekranie, a nagranie za filmem może również wyprodukować swój pisemny artykuł, więc kroki nie żyją tylko w filmie. Żadna platforma nie może obiecać, że ChatGPT będzie się na Ciebie powoływał, i my też tego nie robimy.

Zacznij za darmo z hostowanym centrum pomocy lub zaimportuj swoje obecne z Zendesk, Intercom, GitBook i innych platform. Ustawienia znajdują się w Kontroluj, kto może czytać witrynę dokumentacji, Skonfiguruj asystenta witryny dokumentacji oraz Połącz agentów AI ze swoimi witrynami dokumentacji. Przegląd produktu znajduje się na stronie oprogramowania centrum pomocy oraz w naszym poście o uruchomieniu witryn dokumentacji.

FAQ#

Czy warto dodawać llms.txt do centrum pomocy?#

Dodaj go, jeśli Twoja platforma generuje go za darmo. Nic nie kosztuje, a agenci kodujący go czytają, ale Google go nie używa, a badania pokazują prawie brak zapytań od botów wyszukiwania AI. Przeszukiwalny HTML oraz jasne, aktualne artykuły mają znacznie większe znaczenie.

Jak sprawić, by ChatGPT poprawnie odpowiadał na pytania o mój produkt?#

Upewnij się, że OAI-SearchBot może przeszukiwać Twoje publiczne centrum pomocy, że tekst artykułu znajduje się w HTML i że każdy artykuł odpowiada na jedno pytanie z określonymi warunkami. Następnie co miesiąc testuj prawdziwe pytania klientów i poprawiaj strony, które kryją się za błędnymi odpowiedziami. To zwiększa szanse; nikt nie może zmusić ChatGPT do powoływania się na Ciebie.

Czy powinienem blokować GPTBot i ClaudeBot?#

To decyzja dotycząca treningu, a nie widoczności. Blokowanie GPTBot i ClaudeBot chroni Twoją dokumentację przed treningiem modeli; nie usuwa Cię to z wyszukiwania w ChatGPT lub Claude, które używają OAI-SearchBot i Claude-SearchBot. Nie blokuj ich, jeśli chcesz być cytowany.

Czy dane strukturalne pomagają w AI Overviews?#

Google twierdzi, że dla funkcji AI nie jest potrzebny żaden specjalny schemat. Używaj danych strukturalnych tam, gdzie opisują widoczną treść, tak jak w przypadku zwykłego wyszukiwania.

Czym różnią się dokumenty gotowe na AI od chatbota AI w centrum pomocy?#

Dokumentacja gotowa na AI pomaga zewnętrznym asystentom odpowiadać na pytania na podstawie Twoich stron. Chatbot w centrum pomocy, taki jak Ask AI od Clevera, odpowiada czytelnikom bezpośrednio w Twoim serwisie, korzystając z tych samych artykułów. Oba rozwiązania wymagają jasnych i aktualnych treści.