Pilih izin untuk agen AI
Setiap izin yang dapat dimiliki oleh token API atau aplikasi terhubung, apa fungsinya, preset mana yang menyertakannya, dan peran mana (pemilik, admin, editor, Pembuat Konten) yang dapat memberikannya.
Setiap token API dan aplikasi terhubung memiliki serangkaian izin (kemampuan) yang menentukan apa yang boleh dilakukan agen di ruang kerja kamu. Artikel ini mencantumkan setiap izin, fungsinya, preset mana yang menyertakannya, dan peran mana yang dapat memberikannya.
Cara kerja izin
- Agen bertindak sebagai orang yang membuat token tersebut, sesuai dengan batasan peran orang tersebut. Agen tidak akan pernah bisa melakukan lebih dari yang bisa dilakukan pemiliknya di aplikasi, dan hanya dapat melihat rekaman, video, serta koleksi yang dapat dilihat oleh pemiliknya.
- Peran kamu menentukan apa yang bisa kamu berikan. Di panduan token dan pada layar koneksi, izin yang tidak dapat diberikan oleh peran kamu akan berwarna abu-abu dengan keterangan "Peran kamu tidak dapat memberikan ini." (atau "Hanya pemilik, admin, dan editor yang dapat memberikan izin publikasi." untuk publikasi). Preset yang memuat salah satu izin tersebut akan berwarna abu-abu dengan keterangan "Peran kamu tidak dapat memberikan setiap kemampuan dalam preset ini."
- Peran diperiksa pada setiap panggilan, bukan hanya saat token dibuat. Jika peran pemilik berubah di kemudian hari, panggilan yang memerlukan izin yang tidak diizinkan oleh peran baru akan ditolak, dan token akan menampilkan Melebihi peran di daftar token: "Peran pemilik berubah. Panggilan yang memerlukan kemampuan yang dicoret akan ditolak."
- Setiap izin memiliki jenis, yang ditampilkan sebagai lencana di panduan: Baca, Edit, Publikasikan, Kelola, atau Menggunakan kredit.
- Agen hanya melihat alat (MCP) dan endpoint (REST) yang diizinkan oleh izinnya. Memanggil alat yang tidak dimiliki akan menghasilkan "Token ini tidak memiliki kemampuan …."
Preset
Langkah pertama panduan token (Apa tujuannya?) menawarkan preset. Memilih salah satu akan mencentang izinnya; kamu dapat mengubah izin apa pun pada langkah berikutnya, dan panduan kemudian akan menampilkan Disesuaikan dengan Reset ke preset.
| Preset | Deskripsi di layar | Izin |
|---|---|---|
| Penulis | "Agen membuat draf; seseorang meninjau dan mempublikasikan." | content:read, articles:write, changelog:write, media:write |
| Penerbit | "Otomatisasi tepercaya yang dapat mengubah apa yang dilihat pembaca." | Setiap izin situs dokumentasi kecuali help:read dan insights:read |
| Asisten dukungan | "Jawaban dari dokumen yang dipublikasikan. Tidak ada yang lain." | help:read |
| Hanya-baca | "Riset, audit, dan pemeriksaan terjemahan." | content:read |
| Analis | "Membaca konten dan sinyal pembaca untuk menyarankan perbaikan." | content:read, insights:read |
| Produser | "Membuat draf konten dan memulai pekerjaan berbayar dalam batas pengeluaran." | Penulis, ditambah site-pages:write, library:read, videos:create, videos:export, materials:write, credits:spend, jobs:read |
| Agen ruang kerja | "Segala sesuatu yang dapat dilakukan agen di ruang kerja ini, dalam batas pengeluaran." | Setiap izin kecuali help:read |
Produser dan Agen ruang kerja menyertakan credits:spend, jadi panduan akan meminta batas pengeluaran pada langkah Batas. Lihat Kontrol pengeluaran dan persetujuan agen.
Preset Penulis, Penerbit, Asisten dukungan, Hanya-baca, dan Analis ditujukan untuk situs dokumentasi.
Izin video
| Izin | Jenis | Apa yang diizinkan |
|---|---|---|
library:read |
Baca | "Membaca rekaman, video, artikel, dan transkrip yang dapat dilihat pemilik": mencantumkan pustaka dan rekaman, membaca item, transkrip, dan artikelnya, serta mendapatkan sematan. |
videos:create |
Edit | "Mengutip dan meminta video, artikel dari rekaman, dan terjemahan": meminta kutipan dan meminta video panduan, demo produk, pembersihan, dan video bergaya dari rekaman, klip sosial, artikel dari rekaman, dan terjemahan video. Memulai pekerjaan berbayar juga memerlukan credits:spend. |
videos:export |
Edit | "Mengekspor video dan mendapatkan sematan": merender MP4 pada 1080p (default), 2K, atau 4K, selalu 60 fps, dan mendapatkan tautan unduhan. Ekspor tidak memakan kredit. |
materials:write |
Edit | "Menambahkan gambar, video, dan PDF ke unggahan ruang kerja yang digunakan untuk video baru". |
Izin ruang kerja
| Izin | Jenis | Apa yang diizinkan |
|---|---|---|
credits:spend |
Menggunakan kredit | "Menggunakan kredit untuk pekerjaan yang dikutip, dalam batas token". Ini adalah kunci kedua yang diperlukan setiap awal pekerjaan berbayar, di samping izin untuk pekerjaan tersebut (misalnya videos:create). |
jobs:read |
Baca | "Melihat pekerjaan yang dimulai oleh token lain milik pemilik". Token selalu melihat pekerjaannya sendiri; ini menambahkan pekerjaan dari token lain milik pemiliknya. Juga memungkinkan agen membatalkan pekerjaan dan membaca saldo kredit ruang kerja. |
Izin dokumen
Ini berlaku untuk situs dokumentasi. Di bawah Batas → Situs dokumentasi, token mencakup Semua situs ("Setiap situs dokumentasi di ruang kerja ini, termasuk yang baru.") atau Situs yang dipilih.
| Izin | Jenis | Apa yang diizinkan |
|---|---|---|
content:read |
Baca | "Membaca situs, halaman, artikel (termasuk draf), revisi, log perubahan, dan halaman situs". Juga pengaturan situs, tampilan, navigasi, dan pengalihan. |
articles:write |
Edit | "Membuat draf artikel dan mengedit artikel yang belum tayang". Menerjemahkan artikel (berbayar) juga memerlukan credits:spend. |
structure:write |
Edit | "Membuat dan mengedit bagian, memindahkan, menyembunyikan, dan mengganti nama halaman". |
site-pages:write |
Edit | "Mengedit halaman situs seperti beranda, kontak, dan legal". Menghasilkan atau menerjemahkan halaman situs dengan AI (berbayar) juga memerlukan credits:spend. |
changelog:write |
Edit | "Membuat dan mengedit entri log perubahan sebagai draf". |
media:write |
Edit | "Mengunggah gambar". |
site:publish |
Publikasikan | "Publikasikan: mengubah apa yang dilihat pembaca, mengedit konten langsung, menandai halaman siap". Juga mempublikasikan dan menghapus entri log perubahan serta mengembalikan situs ke versi sebelumnya. |
insights:read |
Baca | "Membaca wawasan situs: celah pencarian, pertanyaan yang belum terjawab, dan umpan balik halaman". Dengan articles:write, agen juga dapat menandai celah sebagai sudah teratasi. |
site:configure |
Kelola | "Mengubah pengaturan situs, tampilan, dan navigasi", serta menambahkan pengalihan. |
sites:create |
Kelola | "Membuat situs dokumentasi baru". |
help:read |
Baca | "Mencari halaman publik yang dipublikasikan saja (asisten dukungan)". Token dengan hanya izin ini tidak melihat hal lain. |
Siapa yang dapat memberikan apa
| Izin | Pemilik | Admin | Editor | Pembuat Konten |
|---|---|---|---|---|
content:read, help:read, insights:read, jobs:read |
Ya | Ya | Ya | Ya |
library:read |
Ya | Ya | Ya | Ya |
articles:write, structure:write, site-pages:write, changelog:write, media:write |
Ya | Ya | Ya | Ya |
videos:export |
Ya | Ya | Ya | Ya |
videos:create, materials:write, credits:spend |
Ya | Ya | Tidak | Ya |
site:publish, site:configure |
Ya | Ya | Ya | Tidak |
sites:create |
Ya | Ya | Tidak | Tidak |
Pembuat Konten dapat memberikan token credits:spend, tetapi pekerjaan berbayar yang memerlukan persetujuan selalu disetujui oleh pemilik ruang kerja atau admin, tidak pernah oleh pemilik token saja. Lihat Kontrol pengeluaran dan persetujuan agen.
Belum tersedia untuk agen
Agen belum dapat menjalankan riset situs web atau panduan rekaman, atau mempublikasikan video ke platform lain. Izin tersebut tidak dapat diberikan.