Bayangkan sebuah syarikat alat digital di Malaysia mempunyai panduan pemasangan dan dokumentasi API yang terbuka. Seseorang mencadangkan /llms.txt supaya pembantu AI dapat mencari arahan yang betul. Soalan sebenar ialah sama ada ejen tertentu memerlukan fail itu—atau panduan yang masih mengelirukan pelanggan patut diperbaiki dahulu.
Apakah llms.txt?
llms.txt ialah cadangan fail berformat Markdown yang memberi ejen AI panduan ringkas tentang laman web serta pautan kepada bahan penting. Laman boleh meletakkannya di akar, seperti https://example.com/llms.txt, atau dalam sublaluan yang meliputi bahagian dokumentasi. Cadangan semasa meminta nama projek sebagai tajuk peringkat satu dan mengesyorkan penerangan ringkas serta pautan berkumpulan ke halaman terperinci.
Anggap ia sebagai panduan bacaan terpilih, bukan tempat menyalin seluruh laman. Ejen yang memilih untuk membacanya boleh mengikuti pautan yang berkaitan. Sama ada produk tertentu berbuat demikian ialah soalan berasingan yang perlu disemak.
Apa yang Tidak Boleh Dilakukannya?
Fail llms.txt tidak boleh menentukan halaman yang diindeks enjin carian, memberi kebenaran kepada perayap, atau memaksa jawapan AI memetik laman anda. robots.txt digunakan untuk peraturan akses perayap; peta laman membantu enjin carian menemui URL; format llms.txt yang dicadangkan pula menyediakan konteks dan pautan terpilih. Tiada satu pun menggantikan yang lain.
Google menyatakan dengan jelas bahawa Google Search tidak menggunakan llms.txt untuk keterlihatan atau kedudukan, termasuk ciri AI generatifnya. Google masih boleh merayap atau mengindeks fail teks; kemunculan fail dalam indeks bukan bukti bahawa ia isyarat AI khas. Lighthouse dalam Chrome mempunyai audit pelayaran ejen untuk fail tersebut, tetapi dokumentasinya menandakan fail yang tiada sebagai “tidak berkenaan” kerana ia pilihan. Audit itu bukan bukti faedah kedudukan dalam Google Search.
Bilakah Ia Mungkin Berbaloi?
Laman yang mempunyai banyak dokumentasi mungkin ada kegunaan praktikal. Jika pelanggan atau ejen pengekodan perlu membezakan arahan pemasangan, rujukan API, contoh mengikut versi dan halaman dasar, indeks yang dikemas kini mungkin membantu ejen yang memilih untuk membacanya bernavigasi. Laman servis tempatan dengan beberapa halaman yang jelas mungkin tidak mendapat banyak faedah daripada satu lagi fail. Pastikan dahulu halaman tersebut tepat, boleh diakses dan saling berpaut.
Jangan anggap semua sistem carian AI membaca fail itu hanya kerana satu platform dokumentasi atau ejen membacanya. Keputusan patut berdasarkan kegunaan sebenar yang boleh diuji, bukan janji lebih banyak petikan. Panduan kesediaan carian AI merangkumi semakan asas bagi halaman awam.
Cara Membuat Fail yang Ringkas dan Berguna
Mulakan dengan tajuk H1 yang menamakan laman atau projek dokumentasi. Tambahkan ringkasan padat dan beberapa kumpulan H2 dengan pautan Markdown yang jelas. Cadangan itu mewajibkan H1; ringkasan dan kumpulan pautan menjadikan fail berguna. Bagi syarikat alat digital tadi, kumpulannya mungkin “Mula menggunakan,” “Rujukan API” dan “Dasar semasa.” Pautkan halaman awam yang benar-benar menjawab tugas tersebut. Jika ada versi Markdown yang tepat, anda boleh memautkannya; jangan cipta salinan lapuk semata-mata untuk mengisi fail.
# Example Tools
> Dokumentasi awam untuk produk digital rekaan.
## Mula menggunakan
- [Panduan pemasangan](https://example.com/docs/setup): Langkah pertama
## Rujukan
- [Rujukan API](https://example.com/docs/api): Endpoint semasaIni contoh format, bukan fail syarikat sebenar. Pastikan penerangan berasaskan fakta. Jangan sertakan papan pemuka peribadi, ciri belum dilancarkan, kelayakan akses atau halaman yang tidak mahu didedahkan. Apabila panduan yang dipautkan berubah, kemas kini fail tersebut.
Semak Sebelum Menerbitkan
Buka URL /llms.txt yang tepat dalam pelayar dan pastikan ia memaparkan teks biasa yang dimaksudkan, bukan ralat pelayan atau halaman utama HTML. Ikuti setiap pautan, periksa sama ada ia menuju ke halaman semasa yang betul dan bandingkan ringkasan dengan kandungan terbitan. Jika anda menyediakan versi Markdown bagi halaman, semak juga versi tersebut; itu bahagian tambahan cadangan, bukan keperluan setiap laman.
Catat ejen atau aliran kerja yang sepatutnya menggunakan fail ini. Uji sama ada aliran kerja itu benar-benar mengambil sumber yang berkaitan; URL awam sahaja tidak membuktikan sesiapa membacanya. Satu jawapan ujian yang baik bukan bukti corak petikan yang stabil.
Utamakan Asas Dahulu
Bagi Google Search, Google mengesyorkan halaman yang boleh diakses dan diindeks, kandungan berguna, pautan dalaman serta maklumat tepat. Bagi carian ChatGPT, panduan perayap OpenAI yang diterbitkan membincangkan kawalan robots.txt untuk OAI-SearchBot; ia tidak menyatakan llms.txt sebagai keperluan. Dasar produk ini berbeza, jadi jangan jadikan mana-mana kenyataan sebagai dakwaan tentang semua sistem AI.
Jika pelanggan tidak dapat mencari panduan pemasangan yang betul di laman anda, baiki navigasi dan panduan itu sebelum menambah indeks untuk mesin. Panduan seni bina laman menerangkan cara menghubungkan halaman penting untuk orang dan perayap.
Soalan Lazim
Adakah llms.txt Wajib?
Tidak. Ia konvensyen pilihan yang masih berkembang. Google Search menyatakan bahawa fail itu tidak digunakan untuk kedudukan atau keterlihatan carian AI, dan Lighthouse menandakan ketiadaannya sebagai “tidak berkenaan.”
Bagaimana Membuat Fail llms.txt?
Cipta fail teks biasa berformat Markdown bernama llms.txt di akar laman atau sublaluan yang berkenaan. Mulakan dengan H1 nama projek, kemudian tambah ringkasan dan pautan awam terpilih yang sah. Terbitkan pada URL yang sesuai dan kemas kini apabila halaman berubah.
Apakah Tujuan llms.txt?
Tujuan cadangan itu ialah membantu ejen yang memilih untuk membacanya mencari dokumentasi penting atau halaman awam lain. Fail itu sendiri tidak mengawal perayapan, pengindeksan, kedudukan atau petikan AI.