Panduan Integrasi AI Agent
NocoBase mendukung penuh kolaborasi AI Agent — Anda dapat menyelesaikan pemodelan data, pembangunan halaman, orkestrasi Workflow, konfigurasi Permission, bahkan mengembangkan Plugin kustom dengan bahasa natural. Apa pun AI tool yang Anda gunakan, baik Claude Code, Codex, Cursor, atau lainnya, Anda dapat berkolaborasi dengan NocoBase melalui dua komponen dasar berikut:
- NocoBase CLI — adalah tool baris perintah yang digunakan untuk menginisialisasi, menghubungkan, dan mengelola aplikasi NocoBase di workspace lokal. Tool ini membantu Anda menyiapkan aplikasi NocoBase, menyimpan konfigurasi env CLI, dan menyediakan perintah pengelolaan harian seperti memulai, menghentikan, melihat log, mengupgrade, dan membersihkan, sehingga AI Agent dapat terhubung dan menggunakan NocoBase.
CLI mendukung dua metode inisialisasi yang umum:
- Menghubungkan aplikasi NocoBase yang sudah ada, agar AI Agent dapat langsung menggunakannya.
- Memasang aplikasi NocoBase baru melalui Docker, npm, atau Git, dan menyimpannya sebagai env CLI.
- NocoBase Skills — paket pengetahuan domain, yang memungkinkan AI Agent memahami sistem konfigurasi dan standar pengembangan NocoBase. Mencakup area kemampuan seperti pemodelan data, konfigurasi UI, manajemen Workflow, konfigurasi Permission, pengembangan Plugin, dan lainnya. NocoBase CLI akan secara otomatis menginstal Skills selama proses inisialisasi (
nb init), tanpa perlu instalasi manual.
Setelah memasang CLI dan menyelesaikan inisialisasi, AI Agent dapat langsung mengoperasikan aplikasi NocoBase Anda.
Prasyarat
Sebelum memulai, pastikan Anda telah memenuhi persyaratan lingkungan berikut:
- Node.js >= 22
- Yarn 1.x
- Disarankan menggunakan AI Agent yang digerakkan oleh model besar arus utama seperti Claude, GPT. Hasil aktual sangat terkait dengan model yang digunakan, disarankan memilih model flagship terbaru terlebih dahulu untuk mendapatkan pengalaman terbaik.
Memasang NocoBase Baru dan Menghubungkan AI Agent
Jika Anda sudah memiliki instance NocoBase yang berjalan, Anda dapat langsung merujuk ke bagian berikutnya AI Agent Menghubungkan NocoBase yang Sudah Ada.
Jika Anda belum memiliki aplikasi NocoBase, Anda dapat memasang dan menginisialisasi aplikasi NocoBase baru melalui CLI, kemudian membiarkan AI Agent terhubung dengannya.
Langkah 1: Pasang CLI
Langkah 2: Inisialisasi
File konfigurasi dan data aplikasi yang dihasilkan oleh inisialisasi disimpan secara default di direktori home pengguna, lihat variabel lingkungan NB_CLI_ROOT.
Browser akan secara otomatis membuka halaman konfigurasi visual, yang memandu Anda menyelesaikan konfigurasi dalam 5 langkah:
- Mulai Konfigurasi — Atur nama aplikasi (sekaligus menjadi nama lingkungan CLI), pilih "Instalasi Baru"
- Buat Aplikasi — Pilih metode instalasi (Docker / npm / Git), atur port, dan konfigurasi dasar lainnya
- Unduh File Aplikasi — Pilih sumber dan versi, unduh kode sumber atau image NocoBase
- Konfigurasi Database — Gunakan database bawaan atau konfigurasikan database eksternal (PostgreSQL, MySQL, MariaDB)
- Buat Akun Administrator — Atur email dan password administrator
Setelah instalasi selesai, buka browser dan akses http://localhost:13000 (port default), gunakan akun administrator yang baru Anda atur untuk login.
(Jika Anda lebih terbiasa dengan operasi baris perintah, Anda juga dapat langsung menjalankan nb init untuk masuk ke wizard interaktif, atau nb init --env=app -y untuk menggunakan konfigurasi default dengan satu perintah.)
Langkah 3: Biarkan AI Agent Mulai Bekerja
Buka sesi baru atau restart sesi AI Agent, dan AI Agent dapat mulai mengoperasikan NocoBase. Konfigurasi CLI disimpan di direktori global (default ~/.nocobase/), AI Agent dapat mengaksesnya dari direktori mana pun.
AI Agent Menghubungkan NocoBase yang Sudah Ada
Jika Anda sudah memiliki instance NocoBase yang berjalan, Anda dapat langsung membiarkan AI Agent terhubung dengannya. Karena kemampuan AI berkembang dengan cepat, saat ini hanya versi beta terbaru yang mendukung pengalaman lengkap, dengan persyaratan versi minimum >= 2.1.0-beta.20, sangat disarankan untuk memperbarui ke versi terbaru.
Langkah 1: Pasang CLI
Langkah 2: Inisialisasi dan Hubungkan
File konfigurasi yang dihasilkan oleh inisialisasi disimpan secara default di direktori home pengguna, lihat variabel lingkungan NB_CLI_ROOT.
Browser akan secara otomatis membuka halaman konfigurasi visual. Pada langkah pertama "Mulai Konfigurasi", pilih "Hubungkan Aplikasi yang Sudah Ada", kemudian:
- Isi Alamat API — Masukkan alamat API instance NocoBase yang sudah ada (misalnya:
http://localhost:13000/api) - Pilih Metode Autentikasi — Pilih metode autentikasi (untuk mulai cepat disarankan OAuth)
Tidak perlu mengonfigurasi metode instalasi, database, dan akun administrator, wizard akan melewati langkah-langkah ini.
Langkah 3: Biarkan AI Agent Mulai Bekerja
Buka sesi baru atau restart sesi AI Agent, dan AI Agent dapat mulai mengoperasikan NocoBase. Konfigurasi CLI disimpan di direktori global (default ~/.nocobase/), AI Agent dapat mengaksesnya dari direktori mana pun.
Selanjutnya
Mengelola Lingkungan Aplikasi
Jika Anda perlu mengelola instance NocoBase yang sudah ada (misalnya lingkungan testing, lingkungan production), atau mengelola peralihan antara beberapa lingkungan, silakan lihat Manajemen Lingkungan — mencakup pemeriksaan lingkungan, penambahan lingkungan, upgrade, dan diagnostik masalah.
Mulai Pembangunan AI
Jelaskan kebutuhan dengan bahasa natural, AI akan membantu Anda menyelesaikan pemodelan data, pembangunan halaman, orkestrasi Workflow — gunakan percakapan sebagai pengganti konfigurasi manual. Silakan lihat Mulai Cepat Pembangunan AI.
Lanjutkan Pengembangan Plugin AI
Jika Anda perlu mengembangkan Plugin kustom, AI juga dapat membantu — mulai dari pembuatan scaffold hingga kode komponen, logika bisnis, mencakup seluruh proses pengembangan Plugin. Silakan lihat Pengembangan Plugin AI.
Menggunakan Karyawan AI
Berkolaborasi langsung dengan Karyawan AI di antarmuka NocoBase — analisis data, pembuatan laporan, terjemahan, bantuan pengambilan keputusan, tanpa perlu meninggalkan sistem bisnis. Silakan lihat Karyawan AI.
Referensi Perintah NocoBase CLI
Jika Anda sudah memiliki aplikasi NocoBase yang berjalan, atau telah berhasil menginisialisasi sebelumnya, dan ingin melanjutkan pengembangan, debugging, atau pengelolaan aplikasi, penjelasan parameter lengkap untuk semua perintah nb silakan lihat Referensi Perintah NocoBase CLI.
Tautan Terkait
- Pembangunan AI — Bangun aplikasi NocoBase dari nol dengan AI
- Pengembangan Plugin AI — Gunakan AI untuk membantu mengembangkan Plugin NocoBase
- Karyawan AI — Berkolaborasi dengan AI di antarmuka bisnis
- Manajemen Lingkungan — Pemeriksaan lingkungan, penambahan lingkungan, upgrade, dan diagnostik masalah
- Referensi Perintah NocoBase CLI — Penjelasan parameter lengkap untuk semua perintah
- Perbandingan Metode Instalasi dan Versi — Berbagai metode instalasi dan saluran versi NocoBase