Apa Itu llms.txt: Cara Menulis dan Apakah Anda Membutuhkannya

Apa itu llms.txt, dan apa yang terkandung dalam file tersebut?

llms.txt adalah konvensi yang diusulkan untuk menerbitkan panduan terkurasi ke konten penting sebuah situs web. Biasanya digambarkan sebagai file Markdown di root situs, yang dimaksudkan untuk memudahkan alat model bahasa menemukan dan menafsirkan halaman-halaman yang berguna. Proposal dan contohnya tersedia di llmstxt.org.

Idenya sengaja dibuat sederhana: menawarkan orientasi singkat dan sekumpulan tautan terpilih, daripada menyalin seluruh situs ke dalam satu dokumen. Sebuah file dapat menunjuk ke dokumentasi produk, gambaran umum perusahaan, materi dukungan, atau halaman otoritatif tentang suatu proyek. Setiap entri harus membantu pembaca memahami mengapa halaman itu penting.

Untuk Web3 project, kandidat terkuat adalah halaman publik yang stabil yang menjelaskan produk, protokol, token, atau praktik keamanan dalam bahasa langsung. Daftar tautan bukanlah pengganti halaman-halaman tersebut. Jika informasi yang mendasarinya tidak jelas, usang, atau tidak dapat diakses, file direktori tidak dapat memperbaikinya. Anggap llms.txt sebagai petunjuk editorial: ia menjelaskan di mana informasi berguna berada, sementara halaman tujuan membawa bukti dan detailnya.

Bukti apa yang menunjukkan apakah llms.txt berguna?

Bukti paling jelas bahwa sebuah file melakukan tugas dasarnya dapat diperiksa: file tersebut diterbitkan di alamat yang dimaksud, berisi tautan yang akurat, dan memberi pembaca rute yang koheren menuju informasi penting. Pemeriksaan ini menunjukkan bahwa file tersebut ada dan dipelihara; pemeriksaan ini tidak menunjukkan bahwa asisten AI telah membaca atau mengandalkannya.

Pisahkan tiga pertanyaan saat mengevaluasi llms.txt:

• Apakah valid dan dapat diakses? Buka URL publik dan periksa apakah respons menampilkan teks yang dimaksud.
• Apakah berguna bagi seseorang? Tanyakan apakah pembaca yang tidak terbiasa dapat mengidentifikasi halaman kunci proyek tanpa menebak-nebak.
• Apakah ada bukti penggunaan eksternal? Carilah sumber yang dapat diatribusikan atau observasi yang terdokumentasi, daripada berasumsi bahwa file yang diterbitkan menyebabkan perubahan dalam jawaban.

Simpan salinan setiap revisi yang diberi tanggal dan catat mengapa tautan ditambahkan atau dihapus. Jika Anda memonitor visibilitas AI, catat prompt, platform, jawaban, dan sumber yang dikutip secara terpisah dari pemeliharaan file. Perbedaan ini memungkinkan untuk mendiskusikan observasi tanpa menetapkan penyebab secara prematur. Untuk tinjauan tingkat situs yang lebih luas, lihat AEO teknis: schema, llms.txt, dan crawler dan monitoring visibilitas AI.

Bagaimana cara menulis file llms.txt?

Tulis llms.txt untuk pembaca yang membutuhkan orientasi yang dapat diandalkan, bukan sebagai inventaris kata kunci. Mulailah dengan nama proyek dan deskripsi singkat yang netral. Kemudian kelompokkan sekumpulan kecil tautan yang berguna di bawah label deskriptif, dengan penjelasan satu baris jika membantu pembaca memilih halaman yang tepat.

Garis besar sederhana bisa terlihat seperti ini:

Nama proyek

Deskripsi singkat tentang proyek dan tujuannya.

Ikhtisar

• Tentang proyek: https://example.com/about — ruang lingkup produk dan pengguna yang dituju. - Dokumentasi: https://example.com/docs — panduan produk dan integrasi.

Kepercayaan dan kebijakan

• Informasi keamanan: https://example.com/security — detail keamanan yang dipublikasikan. - Ketentuan: https://example.com/terms — ketentuan penggunaan terkini.

Gunakan URL publik nyata dari situs Anda sendiri; alamat contoh di atas adalah placeholder, bukan tautan untuk diterbitkan. Pilih halaman yang menjawab pertanyaan berbeda dan dapat dijaga tetap terkini. Hindari label yang tidak jelas, tujuan yang berulang, superlatif promosi, dan klaim yang tidak didukung di halaman yang ditautkan. Sebelum menerbitkan, minta pemilik halaman memverifikasi redaksi dan tujuannya. File yang ringkas dengan deskripsi akurat lebih mudah dipelihara daripada inventaris panjang yang tidak ada yang bertanggung jawab untuk memperbarui.

Bagaimana cara mengimplementasikan llms.txt tanpa menimbulkan masalah pemeliharaan?

Implementasikan llms.txt sebagai perubahan konten kecil dengan pemilik yang ditunjuk. Pertama, sepakati audiens dan tujuannya: misalnya, membantu orang atau alat menemukan informasi produk dan kebijakan kanonik suatu proyek. Selanjutnya, pilih halaman tujuan dan konfirmasi bahwa masing-masing bersifat publik, terkini, dan merupakan sumber kebenaran yang dimaksud.

Sebelum publikasi, gunakan daftar periksa ini:

• Konfirmasi nama file akhir dan alamat root tempat file akan disajikan.
• Periksa setiap URL tujuan di browser dan hapus pengalihan atau tautan mati jika URL langsung tersedia.
• Pastikan deskripsi sesuai dengan konten sebenarnya dari setiap halaman yang ditautkan.
• Tinjau file untuk materi rahasia, tidak dipublikasikan, atau yang sudah digantikan.
• Tunjuk pemilik bernama dan pemicu tinjauan praktis, seperti reorganisasi dokumentasi atau perubahan produk.
• Setelah publikasi, buka alamat publik dan bandingkan dengan versi yang disetujui.

Simpan file sumber dalam alur kerja editorial yang sama dengan konten situs lainnya, sehingga pembaruan tidak bergantung pada seseorang yang mengingat tugas teknis yang terisolasi. Untuk pertanyaan terkait tentang bagaimana structured data mendeskripsikan sebuah halaman, lihat schema markup untuk AI search. Jika situs sedang dinilai secara keseluruhan, konten yang dapat dikutip untuk asisten AI adalah topik pendamping yang berguna.

LLMs.txt vs schema.org: apa perbedaannya?

llms.txt dan markup schema.org memiliki peran editorial dan teknis yang berbeda. llms.txt adalah dokumen teks terkurasi yang menunjuk ke halaman-halaman tertentu; schema.org menyediakan kosakata untuk mendeskripsikan entitas dan konten halaman dalam structured data. Keduanya tidak boleh dianggap sebagai pengganti informasi yang jelas dan lengkap di halaman itu sendiri.

Gunakan schema ketika sebuah halaman memiliki informasi yang dapat direpresentasikan secara akurat dalam tipe schema.org yang relevan. Gunakan llms.txt ketika peta ringkas dari halaman-halaman tertentu akan membantu mengorientasikan pembaca. Pilihan ini dapat hidup berdampingan, tetapi menambahkan keduanya tidak dengan sendirinya membuktikan bahwa mesin pencari atau asisten AI akan menggunakan salah satunya. Untuk bantuan membedakan sinyal teknis dari pekerjaan konten, tinjau schema markup untuk AI search bersama panduan ini.

Apakah llms.txt diperlukan untuk situs web atau Web3 project Anda?

Anda mungkin tidak memerlukan llms.txt sebagai prasyarat untuk menerbitkan situs web yang berguna. Pertimbangkan untuk membuatnya ketika situs Anda memiliki beberapa sumber daya publik penting, sumber daya tersebut sulit ditemukan satu sama lain, dan seseorang dapat menjaga keakuratan file. Jika situs kecil sudah memiliki struktur navigasi yang jelas dan beberapa halaman otoritatif, meningkatkan halaman-halaman tersebut mungkin merupakan tugas pertama yang lebih berguna.

Untuk Web3 project, tanyakan apakah pembaca dapat dengan cepat mencapai informasi yang dapat diandalkan tentang produk, jaringan, dokumentasi, tata kelola, pengungkapan keamanan, dan ketentuan. Sertakan halaman hanya jika halaman tersebut publik, terkini, dan relevan dengan orientasi yang dimaksud. Jangan gunakan file untuk menyiratkan bahwa suatu proyek telah diaudit, didukung, atau diverifikasi kecuali bukti yang ditautkan mendukung pernyataan tersebut.

Keputusan praktis adalah menyusun versi pendek, meminta orang yang berpengetahuan di luar proses penulisan untuk menemukan halaman kunci, dan merevisi label apa pun yang menyebabkan keraguan. Jika pengujian mengungkapkan halaman tujuan yang lemah atau hilang, atasi hal tersebut terlebih dahulu. Jika file tidak menambahkan navigasi yang berarti di luar menu situs, tinggalkan dan tinjau kembali keputusan tersebut ketika situs berubah.

Apa yang tidak dapat ditetapkan oleh llms.txt, dan langkah selanjutnya?

File llms.txt yang diterbitkan hanya mengonfirmasi bahwa situs Anda menawarkan sekumpulan tautan dan deskripsi tertentu; ini bukan bukti bahwa suatu platform telah mengambil, menerima, atau menggunakannya. Tidak ada yang dapat menjamin bahwa Google, asisten AI, atau pihak ketiga lainnya akan membaca file, mengutip halaman yang ditautkan, atau mengubah cara mereka menyajikan proyek Anda; sistem tersebut mengontrol akses, pemilihan, dan penyajian mereka sendiri.

Jaga agar keputusan sebanding dengan nilai file. Jika Anda memiliki halaman stabil yang layak ditampilkan, pekerjaannya sederhana: pilih, deskripsikan secara akurat, terbitkan file, dan pelihara bersama halaman sumber. Jika halaman-halaman tersebut hilang atau tidak konsisten, perbaiki materi sumber sebelum mengkurasi peta. Tinjauan praktis akan memberi Anda daftar URL yang disetujui, draf teks, pemilik untuk pembaruan di masa mendatang, dan catatan tentang apa yang telah diperiksa.

Jika Anda menginginkan tinjauan independen, kirimkan Premium Promotions URL situs Anda, halaman yang Anda anggap otoritatif, dan kekhawatiran apa pun tentang informasi sensitif atau usang. Kami akan memeriksa tujuan dan deskripsi yang diusulkan, menandai celah untuk tim Anda, dan mengembalikan draf siap publikasi untuk persetujuan Anda.

Cara kerja

1. Tetapkan tujuanTuliskan siapa yang harus dibantu oleh file dan informasi apa yang harus dapat mereka temukan. Jaga agar tujuan cukup spesifik untuk memandu pemilihan halaman.
2. Pilih halaman sumberKumpulkan halaman publik dan terkini yang mewakili informasi otoritatif proyek. Minta setiap pemilik halaman untuk mengonfirmasi konten dan URL.
3. Susun petaTambahkan pengantar singkat, judul deskriptif, dan deskripsi tautan yang akurat. Hapus entri yang duplikatif atau promosi.
4. Periksa dan terbitkanVerifikasi setiap tujuan dan alamat root akhir. Bandingkan file yang diterbitkan dengan draf yang disetujui.
5. Pelihara catatanTunjuk pemilik dan perbarui file ketika halaman penting berubah, dipindahkan, atau tidak lagi otoritatif.