Integrasi Agen AI
Dokumentasi ini dibuat agar dapat dibaca oleh agen AI, alat berbasis LLM, dan asisten developer, bukan hanya oleh manusia. Tiga sumber daya memungkinkan hal itu:
- Versi Markdown polos dari setiap halaman.
- Indeks
llms.txtuntuk setiap bahasa, yang memetakan seluruh situs. - Bilah tindakan di bagian atas setiap halaman, yang mengirim halaman ke asisten dengan satu klik.
Versi Markdown setiap halaman
Tambahkan .md ke akhir URL halaman mana pun di browser atau klien HTTP Anda:
| URL Halaman | URL Markdown |
|---|---|
/developers/api-reference/post-processes | /developers/api-reference/post-processes.md |
/products/sign-up/multi-accounts | /products/sign-up/multi-accounts.md |
/capabilities/liveness | /capabilities/liveness.md |
/pt-BR/capabilities/liveness | /pt-BR/capabilities/liveness.md |
Responsnya adalah konten Markdown halaman, tanpa navigasi, sidebar, atau pembungkus HTML. Setiap bahasa memiliki versi Markdown sendiri, dengan awalan bahasa yang sama dengan halamannya.
Indeks llms.txt
Setiap bahasa memiliki file llms.txt, dalam format llms.txt:
| Bahasa | URL indeks |
|---|---|
| Inggris | /llms.txt |
| Portugis (Brasil) | /pt-BR/llms.txt |
| Spanyol | /es/llms.txt |
Semua bahasa lain mengikuti pola yang sama: awalan bahasa halamannya, diikuti /llms.txt.
File ini mencerminkan navigasi situs:
- Satu bagian untuk setiap tab di bilah navigasi atas. Setelahnya ada tab Dual API, masing-masing diberi label nama tab diikuti
(Dual API). - Sidebar setiap tab sebagai daftar bertingkat, dengan urutan yang sama seperti di situs.
- Tautan ke versi Markdown setiap halaman, diikuti deskripsi halaman jika halaman tersebut memilikinya.
Agen dapat memulai dari llms.txt dalam bahasa pembaca untuk memahami susunan dokumentasi. Setelah itu, agen hanya membuka halaman Markdown yang dibutuhkannya.
Bilah tindakan halaman
Setiap halaman dokumentasi, kecuali halaman beranda, memiliki bilah tindakan di bawah judulnya:
- Salin halaman — menyalin Markdown halaman ke clipboard.
- Markdown — membuka versi Markdown halaman di tab baru.
- Buka di — membuka halaman di asisten AI: ChatGPT, Claude, Gemini, Perplexity, Grok, atau Copilot. Asisten menerima prompt berisi URL Markdown halaman. Untuk Gemini dan Copilot, prompt disalin ke clipboard, lalu Anda menempelkannya ke chat.
- Salin URL Markdown — menyalin URL absolut versi Markdown, untuk ditempelkan ke agen coding seperti Cursor, Codex, atau Claude Code.
Di desktop, Salin halaman, Markdown, ChatGPT, dan Claude adalah tombol di bilah, dan tindakan lainnya ada di Lainnya. Di perangkat seluler, tindakan lainnya ada di menu yang dibuka oleh panah di samping Salin halaman.
Penemuan otomatis
HTML setiap halaman mendeklarasikan kedua sumber daya di <head>-nya, sehingga agen yang mengunjungi halaman mana pun dapat menemukannya tanpa instruksi:
<link rel="alternate" type="text/markdown" href="/capabilities/liveness.md">
<link rel="llms-txt" href="/llms.txt">
rel="alternate"mengarah ke versi Markdown halaman saat ini.rel="llms-txt"mengarah kellms.txtdalam bahasa halaman.
Kasus penggunaan
- Asisten coding AI — berikan
llms.txtatau URL.mdkepada asisten Anda, agar asisten bekerja dengan konteks yang akurat dan terkini tentang endpoint, kapabilitas, atau kasus penggunaan. - Prompt LLM — ambil halaman sebagai Markdown dan sertakan dalam prompt untuk ringkasan, terjemahan, atau pembuatan kode.
- Pipeline RAG — gunakan
llms.txtsebagai daftar sumber dan URL.mdsebagai sumber ingesti untuk sistem retrieval-augmented generation. - Skrip otomatis — urai konten dokumentasi tanpa pengurai HTML.
Contoh
Ambil indeks dokumentasi berbahasa Inggris:
curl https://developer.unico.io/llms.txt
Ambil versi Markdown halaman Autentikasi:
curl https://developer.unico.io/dual-api/developers/api-reference/authentication.md
Kedua respons berupa teks polos, siap dimasukkan ke LLM atau pipeline pemrosesan apa pun.