Agen yang menjawab pertanyaan API mungkin membutuhkan satu panduan autentikasi dan satu referensi endpoint. Memuat seluruh situs web juga membawa materi yang tidak terkait dengan tugas tersebut.
Proposal llms.txt memberi penerbit tempat untuk mendeskripsikan konten mereka dan menautkan ke halaman Markdown yang berguna.
Apa isi file ini?
File ini berisi nama proyek dan dapat menyertakan ringkasan, panduan, serta tautan yang dikelompokkan ke informasi lebih lanjut.
Proposal ini menggunakan Markdown agar manusia dan program dapat memproses file yang sama. Daftar tautannya mengarah ke konten yang dapat diambil agen saat dibutuhkan.
Indeks dokumentasi dapat mengelompokkan autentikasi, pengiriman pesan, dan peristiwa pengiriman di bawah heading terpisah. Deskripsi singkat membantu agen membedakan tujuan-tujuan tersebut sebelum mengunduhnya.
Proposal ini juga mengizinkan indeks di bawah root situs. Indeks di bawah jalur dokumentasi mencakup konten di bawah jalur tersebut.
Apakah file ini sama dengan robots.txt atau sitemap?
File-file ini memiliki tujuan berbeda: panduan akses, penemuan URL, dan rute terkurasi menuju konten.
| File | Tujuan |
|---|---|
robots.txt | Memberi klien otomatis aturan crawling |
| Sitemap | Mencantumkan URL agar ditemukan mesin pencari |
llms.txt | Mendeskripsikan konten dan menautkan ke detail berguna untuk agen |
Perbandingan proposal dengan standar yang ada menjelaskan llms.txt sebagai pelengkap file lainnya. Menerbitkannya tidak memberikan akses ke konten yang dilindungi.
File ini juga tidak mengekspos tindakan yang dapat dieksekusi. Agen membutuhkan API terpisah atau koneksi MCP untuk menjalankan operasi workspace.
Apakah menerbitkannya membuktikan bahwa agen menggunakannya?
Menerbitkan indeks yang dapat dibaca menetapkan ketersediaan. Bukti penggunaan membutuhkan pengamatan bahwa klien mengambil dan menggunakan konten tersebut.
Audit Lighthouse Chrome memeriksa kesalahan server saat mengambil file. File yang tidak ada menerima hasil not-applicable karena file ini bersifat opsional. Lolos pemeriksaan tersebut tidak mengukur kualitas jawaban agen.
Untuk evaluasi Anda sendiri, catat tugas dan dokumen yang diambil klien. Periksa apakah agen mencapai jawaban yang benar atau menyelesaikan tindakan yang dimaksud. Bandingkan percobaan yang setara saat menilai apakah indeks tersebut membantu.
Permintaan dalam log akses membuktikan pengambilan. Permintaan itu sendiri tidak membuktikan bahwa klien menggunakan konten tersebut dalam jawabannya. Sitasi menetapkan observasi yang berbeda lagi. Pisahkan hasil-hasil ini saat melaporkan temuan.
Dokumentasi Bird mana yang harus saya berikan ke agen?
Anda dapat menyediakan indeks llms.txt Bird ketika agen perlu menemukan dokumentasi dan mengambil halaman yang relevan.
Panduan dokumentasi yang dapat dibaca mesin menjelaskan indeks, halaman Markdown individual, dan korpus lengkap. Indeks menyediakan tautan; halaman individual memungkinkan klien mengambil jawaban yang terfokus.
llms-full.txt menggabungkan dokumentasi beserta URL sumbernya. Format yang lebih besar ini cocok untuk alur kerja yang secara eksplisit membutuhkan korpus, dengan mempertimbangkan batas konteks klien.
Untuk menjalankan tugas pengiriman pesan setelah mengambil instruksi, hubungkan server MCP Bird. Dokumentasi menyediakan informasi; koneksi yang terautentikasi menyediakan akses ke operasi workspace.