Cara membuat dokumentasi siap-AI untuk ChatGPT dan Claude

Diperbarui 3 November 2026

Untuk membuat dokumentasi siap-AI, mulailah dengan dasar-dasar yang terbukti penting: perayap AI harus dapat mengambil halaman Anda sebagai HTML biasa, robots.txt Anda harus mengizinkan bot pencari masuk, dan setiap artikel harus menjawab satu pertanyaan dengan jelas, dengan paket, peran, dan batasan yang dinyatakan. Jaga agar halaman tetap terkini, lalu tambahkan salinan Markdown, llms.txt, dan server MCP untuk agen AI. Tambahan tersebut murah, tetapi efek terukurnya pada jawaban AI sejauh ini masih kecil.

Panduan ini ditujukan bagi pimpinan dukungan yang pelanggannya kini bertanya kepada ChatGPT, Perplexity, atau AI Overviews Google tentang cara menggunakan produk Anda, dan bagi tim yang pengembangnya mengarahkan Claude Code atau Cursor ke dokumentasi Anda. Panduan ini memisahkan apa yang memiliki bukti pendukung dari apa yang masih berupa spekulasi.

Apa arti dokumentasi siap-AI?#

Dokumentasi siap-AI adalah dokumentasi yang dapat diambil, dipahami, dan dikutip dengan benar oleh sistem AI: dokumentasi yang dapat dibaca AI untuk mesin penjawab, dan dokumentasi untuk agen AI yang bertindak berdasarkan dokumentasi tersebut. Dua jenis pembaca yang penting:

• Mesin penjawab (penelusuran ChatGPT, Perplexity, Claude, Google AI Overviews, dan AI Mode) menjawab pertanyaan pelanggan Anda dan mengutip halaman sebagai sumber.
• Agen AI (Claude Code, Cursor, Codex, asisten kustom) membaca dokumentasi Anda untuk melakukan tugas, sering kali melalui file Markdown atau server MCP.

Keduanya berkembang pesat. Survei Stack Overflow tahun 2025 menemukan 84% pengembang menggunakan atau berencana menggunakan alat AI, dan Similarweb mencatat 1,13 miliar kunjungan rujukan dari platform AI pada Juni 2025, naik 357% dari tahun sebelumnya, dengan ChatGPT menyumbang lebih dari 80% di antaranya. Dan ketika Google menampilkan ringkasan AI, orang lebih jarang mengeklik: Pew Research menemukan pengguna mengeklik tautan hasil dalam 8% kunjungan dengan ringkasan AI, dibandingkan 15% tanpa ringkasan. Jika jawaban ditampilkan tanpa klik, jawaban tersebut harus benar, dan kebenarannya hanya seakurat dokumentasi Anda. Angka lebih lanjut tentang di mana pelanggan mencari bantuan ada dalam statistik layanan mandiri pelanggan kami.

Bisakah perayap AI benar-benar membaca pusat bantuan Anda?#

Periksa ini terlebih dahulu, karena hal lain tidak akan berarti jika jawabannya tidak.

Apakah teks ada di dalam HTML? Analisis Vercel pada Desember 2024 tentang lalu lintas perayap menemukan bahwa tidak ada perayap AI utama yang merender JavaScript, dengan pengecualian perayap Gemini milik Google dan milik Apple. Pusat bantuan yang memuat artikelnya dengan JavaScript sisi klien bisa terlihat kosong bagi perayap ChatGPT dan Claude. Uji ini:

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

Jika kalimat tersebut tidak ada dalam respons, perayap juga tidak melihatnya. Halaman yang dirender server atau dirender sebelumnya memperbaiki masalah ini.

Apakah URL Anda teratasi? Dalam data Vercel yang sama, sekitar 35% pengambilan perayap ChatGPT dan Claude mencapai halaman 404. Pertahankan pengalihan saat Anda memindahkan atau mengganti nama artikel, dan jaga agar peta situs tetap terkini. Jika Anda mengganti platform, ikuti daftar periksa migrasi pusat bantuan.

Apakah halaman tersebut publik? Mesin penjawab tidak dapat membaca halaman di balik login. Jika Anda memiliki dokumentasi pribadi untuk pelanggan, terimalah bahwa jawaban AI akan datang dari halaman publik, forum, dan situs pihak ketiga Anda sebagai gantinya.

Bot AI mana yang harus diizinkan oleh robots.txt Anda?#

Setiap perusahaan AI menjalankan bot terpisah untuk pelatihan dan untuk pencarian. Memblokir "semua bot AI" juga menghapus Anda dari jawaban AI.

Detailnya berasal dari dokumentasi masing-masing perusahaan: OpenAI, Anthropic, dan Perplexity. Pusat bantuan yang ingin dikutip tetapi tidak digunakan untuk pelatihan dapat mengatakan:

User-agent: GPTBot
Disallow: /

User-agent: ClaudeBot
Disallow: /

User-agent: Google-Extended
Disallow: /

User-agent: *
Allow: /

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

Bot yang memiliki grupnya sendiri mengabaikan aturan *, jadi ulangi baris Disallow apa pun (seperti /admin) di setiap grup bernama. Memblokir Google-Extended juga menghentikan Aplikasi Gemini agar tidak melakukan grounding jawaban di halaman Anda; Penelusuran Google dan AI Overviews tidak terpengaruh.

Periksa juga CDN atau firewall Anda. Tombol "blokir bot AI" di sana dapat menggantikan robots.txt yang permisif.

Bagaimana Anda harus menulis artikel bantuan agar AI menjawab dengan benar?#

Mesin penjawab menarik bagian tertentu, bukan seluruh situs Anda. Setiap bagian harus dapat berdiri sendiri.

• Satu tugas per artikel, dinamai sesuai cara pelanggan bertanya. "Membatalkan atau menjeda langganan Anda", bukan "Manajemen langganan".
• Utamakan jawaban. Dua kalimat pertama di bawah setiap judul harus menjawab judul tersebut. Templat artikel pusat bantuan kami dibuat dengan cara ini.
• Nyatakan kondisinya. Paket mana, peran mana, platform mana. "Hanya admin yang dapat menghapus ruang kerja" dapat dikutip; "Anda dapat menghapus ruang kerja" menghasilkan jawaban yang salah untuk orang lain.
• Katakan apa yang tidak dapat dilakukan produk. Asisten sering ditanya "bisakah saya…?" Jika dokumentasi Anda hanya menjelaskan apa yang ada, model akan menebak.
• Gunakan satu nama untuk satu hal, dan definisikan sekali. Jika "ruang kerja", "akun", dan "organisasi" berarti hal yang sama, pilih satu, dan simpan halaman glosarium singkat yang mendefinisikan istilah produk Anda.
• Berikan metadata yang bersih pada setiap halaman. Judul tertentu, deskripsi satu baris, tanggal terakhir diperbarui, dan, jika berlaku, paket atau area produk. Mesin penjawab dan pencarian Anda sendiri menggunakan ini untuk memutuskan halaman mana yang menjawab pertanyaan.
• Jangan sembunyikan langkah-langkah dalam gambar atau video. Berikan setiap tangkapan layar teks alt yang nyata, dan pastikan setiap langkah yang ditunjukkan video juga ada sebagai teks.
• Cakup dasar-dasar sebelum kasus ekstrem. Jika Anda masih membangun pusat bantuan, mulailah dengan cara membangun basis pengetahuan dengan AI.
• Jaga agar tetap terkini. Artikel yang kedaluwarsa sekarang menjadi jawaban yang kedaluwarsa, diulang dengan percaya diri. Panduan kami untuk menjaga dokumentasi tetap terkini mencakup rutinitas rilis demi rilis, dan cara memperbarui dokumentasi secara otomatis pada setiap rilis menunjukkan cara memulainya dari rilis itu sendiri.

Google mengatakan hal yang sama dengan kata-kata yang lebih sederhana: untuk fitur AI-nya, "tidak ada persyaratan tambahan" dan tidak diperlukan pengoptimalan khusus di luar SEO normal. Panduannya juga mengatakan tidak ada persyaratan untuk memecah konten Anda menjadi potongan-potongan kecil untuk AI, jadi jangan memotong artikel menjadi fragmen agar sesuai dengan model.

Haruskah Anda menambahkan llms.txt untuk dokumentasi?#

Ini kurang membantu daripada yang disarankan vendor. llms.txt adalah file Markdown di root situs Anda yang mencantumkan halaman Anda yang paling berguna dengan deskripsi singkat. Jeremy Howard mengusulkannya pada September 2024 sebagai peta untuk model bahasa.

Bukti sejauh ini:

• Google mengabaikannya. Panduan Google menyatakan Anda tidak memerlukan file baru yang dapat dibaca mesin, file teks AI, markup, atau Markdown untuk muncul di Google Penelusuran, dan file llms.txt tidak akan membantu maupun merugikan karena Penelusuran mengabaikannya. Pada tahun 2025, John Mueller dari Google membandingkan llms.txt dengan meta tag kata kunci.
• Hanya sedikit bot yang memintanya. Ahrefs mempelajari 137.210 domain dan menemukan bahwa 97% file llms.txt tidak menerima permintaan sama sekali pada Mei 2026. Bot pengambilan AI hanya membuat 1,1% dari permintaan yang masuk (asisten AI lainnya 2,5%); agen pengodean seperti Claude Code termasuk di antara pembaca utama yang disebutkan.

Jadi: tambahkan llms.txt jika platform dokumentasi Anda menyediakannya secara gratis, terutama jika pengembang menggunakan dokumentasi Anda dengan agen pengodean, tetapi jangan berharap hal itu akan mengubah apa yang dikatakan ChatGPT tentang Anda. llms-full.txt (semua halaman dalam satu file) adalah konvensi umum, bukan bagian dari proposal.

Haruskah dokumentasi Anda tersedia dalam format Markdown?#

Ya, jika tidak memakan biaya. Agen yang mengambil halaman bekerja lebih baik dengan Markdown yang bersih daripada HTML yang penuh dengan navigasi dan skrip, dan proposal llms.txt menyarankan untuk menyajikan setiap halaman di URL yang sama dengan tambahan .md. Tiga detail:

• Tandai salinan Markdown dengan noindex (header X-Robots-Tag berfungsi), agar mesin pencari tidak menganggapnya sebagai duplikat dari halaman HTML.
• Pastikan salinan tersebut dibuat dari sumber yang sama dengan HTML, agar tidak pernah melenceng.
• Biarkan agen menemukannya: proposal menyarankan tag <link rel="alternate" type="text/markdown"> di setiap halaman HTML.

Bagaimana agen AI menggunakan dokumentasi melalui MCP?#

Model Context Protocol adalah standar terbuka yang memungkinkan aplikasi AI memanggil alat dan membaca data dari sistem lain. Server MCP dokumentasi memungkinkan agen mencari dokumentasi Anda sesuai permintaan alih-alih mengandalkan apa pun yang dipelajari dalam pelatihan, dan, dengan izin yang tepat, menyusun atau memperbarui halaman. Untuk perbandingan server yang tersedia, lihat server MCP untuk dokumentasi.

Aturan yang sama berlaku jika Anda membangun asisten sendiri di dokumentasi Anda (retrieval-augmented generation, atau RAG): asisten tersebut hanya bisa seakurat bagian yang diambilnya. Dua peringatan: berikan akses baca-saja ke apa pun yang menghadap pelanggan kecuali jika seseorang meninjau penulisan, dan ingat bahwa MCP membantu agen yang dihubungkan sendiri oleh pengguna Anda. Hal ini tidak mengubah apa yang dikatakan mesin jawaban publik.

Bagaimana cara menguji apa yang dikatakan asisten AI tentang produk Anda?#

Tidak ada yang bisa melihat ke dalam model, jadi ujilah keluarannya. Sebulan sekali:

1. Tulis 20 pertanyaan pelanggan nyata dari tiket dan pencarian pusat bantuan yang gagal.
2. Ajukan masing-masing pertanyaan di ChatGPT, Perplexity, Claude, dan Google (Mode AI atau Ikhtisar AI).
3. Catat apakah jawabannya benar dan halaman mana yang dikutip.

4. Perbaiki artikel yang seharusnya menjadi sumber jawaban salah tersebut, lalu tanyakan kembali bulan depan.

Untuk melihat sisi lalu lintas, segmen kunjungan berdasarkan perujuk (chatgpt.com, perplexity.ai, claude.ai), dan periksa log server Anda untuk nama bot dalam tabel di atas (kecuali Google-Extended, yang tidak memiliki agen pengguna sendiri). Google menghitung klik dari fitur AI di Laporan Performa Search Console, di bawah jenis penelusuran Web.

Cara membuat dokumentasi siap-AI: daftar periksa#

Bagaimana pusat bantuan Clevera dibangun untuk pembaca AI#

Clevera adalah platform AI yang mengubah rekaman layar menjadi video panduan bernarasi, artikel bantuan langkah-demi-langkah, dan halaman di pusat bantuan yang Anda host, dalam 74 bahasa. Pusat bantuan yang di-host-nya menangani sebagian besar bagian teknis dari daftar periksa, pada setiap paket termasuk Gratis:

• Halaman yang dirender sebelumnya dan peta situs, sehingga teks artikel ada di HTML yang diambil crawler.
• llms.txt, llms-full.txt dan salinan .md dari setiap halaman, di bawah pengaturan llms.txt dan salinan Markdown ("Memungkinkan alat AI membaca dokumentasi Anda"), yang aktif secara default. Di pusat bantuan kami sendiri, salinan Markdown disajikan dengan noindex. Pusat bantuan pribadi (Pro ke atas) menyimpan semua ini di balik login.
• Tanya AI untuk pembaca Anda (aktifkan Tampilkan asisten di Pengaturan → Asisten AI; 300 jawaban sebulan pada paket Gratis). Asisten bawaan hanya menjawab dari halaman yang Anda terbitkan, menautkan sumbernya, memberi tahu saat dokumentasi tidak mencakup pertanyaan, dan mencantumkan pertanyaan tersebut di bawah Pertanyaan yang belum terjawab sehingga Anda tahu apa yang harus ditulis selanjutnya (panduan kami tentang kesenjangan konten pusat bantuan menunjukkan cara mengatasinya).
• Agen AI dan MCP (Pro ke atas). Claude Code, Codex, Cursor, Claude, atau ChatGPT dapat mencari, menyusun, dan, dengan hak penerbitan, memperbarui pusat bantuan Anda melalui server MCP dan API Clevera. Token Asisten dukungan hanya dapat mencari halaman publik yang diterbitkan.

Ini adalah bagian atas dari llms.txt yang diterbitkan pusat bantuan kami sendiri (dipersingkat):

# 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): ...

Bagian penulisan tetap menjadi milik Anda, dan Clevera juga membantu di sana: artikel yang dihasilkan dari rekaman layar keluar sebagai langkah-langkah bernomor dengan tangkapan layar dari apa yang ada di layar, dan rekaman di balik video juga dapat menghasilkan artikel tertulisnya, sehingga langkah-langkah tidak hanya ada dalam video. Tidak ada platform yang bisa menjanjikan bahwa ChatGPT akan mengutip Anda, dan kami pun tidak.

Mulai gratis dengan pusat bantuan yang di-host, atau impor pusat bantuan Anda saat ini dari Zendesk, Intercom, GitBook, dan platform lainnya. Pengaturan ada di Kontrol siapa yang dapat membaca situs dokumentasi, Siapkan asisten situs dokumentasi dan Hubungkan agen AI ke situs dokumentasi Anda. Ikhtisar produk ada di halaman perangkat lunak pusat bantuan dan di postingan peluncuran situs dokumentasi kami.

FAQ#

Apakah llms.txt layak ditambahkan ke pusat bantuan?#

Tambahkan jika platform Anda menghasilkannya secara gratis. Ini tidak memakan biaya dan agen pengodean memang membacanya, tetapi Google tidak menggunakannya dan penelitian menunjukkan hampir tidak ada permintaan dari bot pencari AI. HTML yang dapat dirayapi serta artikel yang jelas dan terkini jauh lebih penting.

Bagaimana cara agar ChatGPT menjawab pertanyaan tentang produk saya dengan benar?#

Pastikan OAI-SearchBot dapat merayapi pusat bantuan publik Anda, bahwa teks artikel ada di HTML, dan bahwa setiap artikel menjawab satu pertanyaan dengan kondisi yang dinyatakan. Kemudian uji pertanyaan pelanggan nyata setiap bulan dan perbaiki halaman di balik jawaban yang salah. Ini meningkatkan peluang; tidak ada yang bisa membuat ChatGPT mengutip Anda.

Haruskah saya memblokir GPTBot dan ClaudeBot?#

Itu adalah keputusan pelatihan, bukan keputusan visibilitas. Memblokir GPTBot dan ClaudeBot menjaga dokumentasi Anda keluar dari pelatihan model; itu tidak menghapus Anda dari pencarian ChatGPT atau Claude, yang menggunakan OAI-SearchBot dan Claude-SearchBot. Jangan blokir bot tersebut jika Anda ingin dikutip.

Apakah data terstruktur membantu Ikhtisar AI?#

Google mengatakan tidak ada skema khusus yang diperlukan untuk fitur AI. Gunakan data terstruktur di tempat yang mendeskripsikan konten yang terlihat, seperti yang Anda lakukan untuk pencarian normal.

Apa perbedaan antara dokumentasi siap-AI dan chatbot AI di pusat bantuan saya?#

Dokumentasi yang siap untuk AI membantu asisten luar menjawab dari halaman Anda. Chatbot pusat bantuan, seperti Ask AI dari Clevera, menjawab pembaca Anda di situs Anda sendiri dari halaman yang sama. Keduanya bergantung pada artikel yang jelas dan terkini.