Menghubungkan agen AI ke situs dokumentasi kamu
Biarkan Claude Code, Codex, ChatGPT, atau skrip milikmu sendiri membuat draf, mengatur, dan menerbitkan halaman situs dokumentasi. Paket (Pro ke atas), izin situs dokumentasi, cakupan situs, dan aturan penerbitan, dengan tautan ke panduan lengkap agen AI & API.
Agen AI seperti Claude Code, Codex, Cursor, Claude, atau ChatGPT dapat membaca dan menulis di situs dokumentasi kamu untukmu: membuat draf artikel, memperbaiki halaman dengan rating rendah dari pembaca, menjawab kesenjangan konten, menerjemahkan, atau menerbitkan. Artikel ini membahas hal-hal khusus untuk situs dokumentasi. Token, konektor, pengeluaran, dan kesalahan dijelaskan di Agen AI & API.
Sebelum kamu mulai
- Agen AI & API tersedia pada paket Pro, Bisnis, dan Kustom, termasuk konektor untuk Claude dan ChatGPT. Paket Gratis dan Starter tidak menyertakannya; token dan aplikasi akan berhenti berfungsi jika ruang kerja berpindah ke salah satu paket tersebut.
- Agen bertindak sebagai orang yang membuat tokennya atau menghubungkannya, sesuai dengan peran orang tersebut. Agen tidak akan pernah bisa melakukan lebih banyak hal di suatu situs daripada yang bisa dilakukan orang tersebut.
- Panggilan API tidak memakan kredit. Menerjemahkan halaman dan membuat halaman situs dengan AI memakan kredit, dan hanya dengan token yang diizinkan untuk menggunakannya.
Menghubungkan agen
Buka menu ruang kerja dan pilih Agen AI & API, atau pilih Agen AI & API di menu Pengaturan situs dokumentasi (ini akan membuka aktivitas untuk situs tersebut).
- Token API untuk Claude Code, Codex, Cursor, atau skrip: Token → Token baru, lalu ikuti panduan empat langkah (Tujuan, Izin, Batas, Tinjau). Pilih preset situs dokumentasi seperti Penulis atau Penerbit, pilih situs di bawah Batas → Situs dokumentasi, dan salin token yang hanya ditampilkan sekali. Lihat Membuat token API.
- Konektor untuk Claude.ai atau ChatGPT: tempel URL konektor dari Aplikasi yang tersambung ke dalam aplikasi, masuk, lalu pilih Situs dan Akses. Lihat Menghubungkan aplikasi dan agen AI.
Preset situs dokumentasi
| Preset | Deskripsi di layar | Untuk |
|---|---|---|
| Penulis | "Agen membuat draf; seseorang meninjau dan menerbitkan." | Membuat draf artikel dan entri log perubahan, mengunggah gambar |
| Penerbit | "Otomatisasi tepercaya yang dapat mengubah apa yang dilihat pembaca." | Segala hal untuk situs dokumentasi, termasuk menerbitkan, pengaturan, dan membuat situs |
| Asisten dukungan | "Jawaban dari dokumen yang diterbitkan. Tidak ada yang lain." | Bot bantuan yang hanya mencari halaman publik yang sudah diterbitkan |
| Hanya-baca | "Penelitian, audit, dan pemeriksaan terjemahan." | Membaca konten |
| Analis | "Membaca konten dan sinyal pembaca untuk menyarankan perbaikan." | Membaca konten dan wawasan |
Produser dan Agen ruang kerja menambahkan video dan kredit pengeluaran. Setiap izin dan siapa yang dapat memberikannya: Izin agen.
Izin situs dokumentasi
| Izin | Mengizinkan |
|---|---|
content:read |
Membaca situs, halaman, artikel (termasuk draf), revisi, log perubahan, dan halaman situs |
articles:write |
Membuat draf artikel dan mengedit artikel yang belum tayang |
structure:write |
Membuat dan mengedit bagian; memindahkan, menyembunyikan, dan mengganti nama halaman |
site-pages:write |
Mengedit halaman situs seperti beranda, kontak, dan legal |
changelog:write |
Membuat dan mengedit entri log perubahan sebagai draf |
media:write |
Mengunggah gambar |
site:publish |
Menerbitkan: mengubah apa yang dilihat pembaca, mengedit konten langsung, menandai halaman siap |
insights:read |
Membaca kesenjangan pencarian, pertanyaan yang belum terjawab, dan umpan balik halaman |
site:configure |
Mengubah pengaturan situs, tampilan, dan navigasi |
sites:create |
Membuat situs dokumentasi baru |
help:read |
Mencari halaman publik yang sudah diterbitkan saja (untuk asisten dukungan) |
Membaca terbuka untuk semua anggota. Menulis dan mengatur: pemilik, admin, editor, dan Pembuat Konten. Menerbitkan dan pengaturan situs: pemilik, admin, dan editor ("Hanya pemilik, admin, dan editor yang dapat memberikan izin menerbitkan."). Membuat situs: pemilik dan admin.
Situs mana yang dicakup oleh token
Di bawah Batas → Situs dokumentasi, pilih Semua situs ("Setiap situs dokumentasi di ruang kerja ini, termasuk yang baru.") atau Situs yang dipilih. Token atau aplikasi yang tersambung hanya dapat melihat dan mengubah situs yang dicakupnya. Jika sebuah artikel juga muncul di situs di luar cakupannya, perubahan akan ditolak: "Artikel ini juga ditampilkan di situs yang tidak dapat diubah oleh token ini."
Konten langsung memerlukan hak penerbitan
Tanpa site:publish, agen tidak dapat mengubah apa yang dilihat pembaca. Mengedit artikel yang sudah tayang akan ditolak ("Konten ini sudah tayang di situs yang diterbitkan, jadi mengubahnya memerlukan kemampuan site:publish."), dan agen dapat mengirimkan drafnya untuk ditinjau sebagai gantinya. Kamu akan mendapatkan notifikasi, "agen meminta peninjauan untuk halaman di situs": "Tidak ada yang diterbitkan. Baca artikel tersebut dan terbitkan saat sudah siap."
Setiap perubahan yang dilakukan agen akan muncul di riwayat halaman sebagai "Agen nama (token)". Penerbitan dibatasi hingga 10 kali per jam per token. Situs yang dijeda bersifat hanya-baca bagi agen: "Situs ini dijeda atau offline dan hanya-baca."
Apa yang dapat dilakukan agen di suatu situs
Mencantumkan situs dan membaca pohon halaman, mencari dan membaca halaman, mempratinjau Markdown, membuat dan memperbarui artikel, mengirimkannya untuk ditinjau, mengatur bagian dan halaman, mengedit halaman situs dan log perubahan, mengunggah gambar, membaca wawasan dan menandai kesenjangan sebagai teratasi, mengubah pengaturan, tampilan, navigasi dan pengalihan, membuat situs, menerjemahkan halaman, membuat halaman situs, menerbitkan, dan membatalkan penerbitan. Masing-masing memerlukan izin yang sesuai.