Modelnya
- Kapabilitas adalah antarmuka bertipe, tidak pernah sebuah produk.
mailmemiliki operasimail.inbox.read,mail.inbox.search, danmail.message.send. - Paket karyawan mencantumkan kapabilitas yang dibutuhkan perannya di
requires.interfaces. - Plugin menyediakan kapabilitas dengan mengikat operasinya ke perintahnya sendiri di
interfaceBindings. - Koneksi adalah plugin yang dihubungkan pemilik untuk kapabilitas tersebut. Pemicu watch yang menyebut sebuah kapabilitas berjalan di atasnya.
Deklarasikan apa yang dibutuhkan peran
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} Sebut kapabilitas, bukan plugin. Paket karyawan yang membutuhkan ledger berfungsi untuk setiap perusahaan, sistem akuntansi apa pun yang digunakannya. Gunakan requires.plugins hanya jika peran benar-benar bergantung pada satu plugin tertentu.
Sediakan kapabilitas
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} Plugin yang mengikat operasi mail.* apa pun menyediakan mail. Setiap binding juga menjadi alat bertipe untuk karyawan, seperti mail_message_send. Sintaks templatnya ada di referensi plugin.json.
Saat workflow memantau sebuah kapabilitas, Nebo memilih plugin terpasang yang menyediakannya, dengan mengutamakan plugin tempat karyawan ini memiliki akun, lalu urutan alfabet. Jika tidak ada, workflow tetap disimpan, ditandai menurun, dan pemilik diberi tahu apa yang perlu dihubungkan.
Katalognya
Nebo menyertakan katalog kapabilitas beserta operasinya, termasuk ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring, dan incidents. Katalog ini adalah kosakata bersama, bukan pagar. Gunakan istilahnya setiap kali ada yang cocok agar karyawan dan plugin dari penerbit yang berbeda bisa bertemu; istilah baru adalah soal konvensi, bukan kesalahan.
Setiap operasi membawa salah satu dari tiga tanda.
| Tanda | Arti |
|---|---|
| Tanpa persetujuan | Membaca, atau tindakan protektif yang dapat dibatalkan dan kehilangan nilainya jika menunggu, seperti menjeda, membatalkan, atau mengembalikan ke versi sebelumnya. Berjalan tanpa bertanya. |
| Memerlukan persetujuan | Memindahkan uang, menghubungi seseorang di luar perusahaan, atau tidak dapat dibatalkan. Nebo bertanya sebelum alat yang terikat dijalankan. |
| Kritis | Perpindahan uang, pembentukan kontrak, catatan perusahaan itu sendiri, atau wewenang tetap untuk bertindak tanpa pengawasan. Selalu memerlukan persetujuan; pemilik memberikan masing-masing per karyawan dan per operasi, dan tidak ada pengaturan tingkat karyawan yang melonggarkannya. |
Persetujuan saat perekrutan
Saat pemilik merekrut karyawan, Nebo membaca kebutuhannya dari paket: kapabilitas di requires.interfaces, plugin di requires.plugins, dan setiap kapabilitas atau plugin yang disebut pemicu watch. Pemilik melihat satu kalimat yang menyatakan kebutuhan tersebut. Perekrutan memberikannya kepada karyawan itu sebagai izin tetap. Operasi yang memerlukan persetujuan tetap menjadi item persetujuan.
Memasang plugin, server MCP, aplikasi, atau skill itu sendiri merupakan pemberian izin untuk menggunakannya; semua itu tidak diaktifkan satu per satu. Kemampuan bawaan Nebo sendiri dikelompokkan sebagai chat, file, shell, web, contacts, desktop, media, dan system.
Batas dan hukum
| Dideklarasikan di | Efek |
|---|---|
ceiling di agent.json | Operasi yang tercantum selalu meminta persetujuan pemilik untuk karyawan ini. Satu-satunya nilai adalah "approval". |
ceiling pada hukum di lapisan perusahaan | Operasi yang tercantum diblokir untuk setiap karyawan. |
Hukum perusahaan dengan reserved_to: owner | Operasi yang tercantum memerlukan persetujuan pemilik sendiri, dan persetujuan itu tidak pernah bisa diberikan kepada karyawan. |
Mode izin
Setiap karyawan memiliki mode izin. Mode ini memutuskan panggilan yang tidak diatur oleh aturan mana pun, dan pemilik dapat menimpanya untuk satu kali jalan.
| Mode | Perilaku |
|---|---|
automatic | Default. Karyawan bertindak dalam lingkup pekerjaannya dan hanya bertanya untuk operasi yang memerlukan persetujuan dan aturan tanya dari pemilik. |
ask | Setiap panggilan yang mengubah sesuatu akan bertanya, kecuali ada aturan izin yang mencakupnya. |
plan | Hanya membaca dan merencanakan. Panggilan yang mengubah sesuatu tidak dijalankan. |
full_access | Tidak ada yang bertanya. Aturan penolakan dan batas keras tetap berlaku. |
Nebo memeriksa setiap tindakan dengan urutan yang sama: batas keras terlebih dahulu, lalu batas dan hukum, lalu aturan pemilik, lalu mode. Batas keras, seperti melindungi kredensial agar tidak bocor, tidak pernah dicabut, bahkan di full_access.