---
title: Configure with AI
description: Gunakan asisten AI untuk siapkan dan jalankan NexCMP: AI Chat di admin, klien AI Anda via MCP, atau file YAML. Pelajari fungsi dan aturan keamanannya.
url: https://nexcmp.com/id/docs/configure-with-ai/overview/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Configure with AI {#configure-with-ai}

> **Di mana letaknya di admin:** AI Chat (`/agent`) dan System › Settings › API & AI agents (`/agent/keys`). Segala hal di halaman ini khusus untuk administrator.

## Fungsi {#what-it-does}

Mulai NexCMP 1.4.0 Anda dapat meminta asisten AI untuk mengonfigurasi panel untuk Anda: menghubungkan Proxmox VE atau CloudStack, membuat zona, menyusun tabel paket dari biaya Anda, menyiapkan email, pembayaran, dan branding, mencari pelanggan, atau mengekspor seluruh konfigurasi. Asisten bekerja melalui sekumpulan **admin tools** tetap. Asisten tidak pernah mendapatkan shell, tidak pernah membaca file di server, dan tidak pernah melihat kata sandi atau API key yang disimpan.

Gunakan saat Anda ingin pengaturan awal selesai dalam hitungan menit alih-alih mengklik selusin halaman, atau saat Anda mengelola beberapa instalasi dan ingin menjaga konfigurasinya dalam sebuah file.

## Tiga cara menggunakannya {#three-ways-to-use-it}

| Cara | Siapa yang berbicara dengan AI | Tempat berjalannya | Mulai di sini |
|---|---|---|---|
| **AI Chat di admin** | Anda, di admin NexCMP | Sumber AI yang Anda pilih: API key dari OpenAI, Anthropic, Gemini, atau OpenRouter, penyedia AI panel Anda sendiri, atau CLI AI resmi tempat Anda masuk | [AI Chat di admin](https://nexcmp.com/id/docs/configure-with-ai/ai-chat-in-admin/) |
| **Klien AI Anda sendiri melalui MCP** | Anda, di Claude Code, Codex CLI, Gemini CLI, Cursor, Claude Desktop, claude.ai, atau ChatGPT | Di mesin Anda atau di aplikasi vendor, terhubung ke panel Anda di `https://cloud.example.com/mcp/admin` | [Connect an AI client](https://nexcmp.com/id/docs/configure-with-ai/mcp-admin/) |
| **Konfigurasi sebagai kode** | Anda atau sebuah skrip | File YAML dan perintah `nexcmp config` di server (atau halaman Import/Export) | [Configuration as code](https://nexcmp.com/id/docs/configure-with-ai/config-as-code/) |

Ketiganya memanggil alat yang sama dan melewati lapisan keamanan yang sama, sehingga Anda dapat menggabungkannya: menyusun draf konfigurasi dengan asisten, mengekspornya sebagai YAML, meninjaunya di editor Anda, dan menerapkannya nanti.

## Model keamanan {#safety-model}

| Aturan | Artinya bagi Anda |
|---|---|
| **Cakupan (Scopes)** | Key atau koneksi dibatasi pada cakupan yang Anda centang (`admin:read`, `catalog:write`, `infra:write`, `billing:write`, `customers:write`, `settings:write`, `ai:write`, `secrets:write`). Tanpa cakupan, panggilan akan ditolak. Lihat [Admin API keys](https://nexcmp.com/id/docs/configure-with-ai/admin-api-keys/#scopes). |
| **Expiry** | Setiap key dan koneksi memiliki masa kedaluwarsa: 1 hingga 90 hari untuk key yang Anda buat, 30 hari secara default. Token akses OAuth berlaku selama satu jam. |
| **Pembatasan IP dan batas laju (Rate limit)** | Key dapat dibatasi ke rentang IP dan ke jumlah panggilan tertentu per menit (120 secara default). |
| **Konfirmasi dua langkah** | Tindakan yang memindahkan dana, menghapus data, mengubah kredensial pembayaran, atau mengubah keamanan masuk akan menampilkan pratinjau terlebih dahulu dan tidak melakukan apa pun hingga Anda menyetujuinya. Di dalam AI Chat, setiap perubahan adalah kartu konfirmasi yang Anda tekan sendiri. |
| **Hal yang tidak boleh dilakukan oleh key** | Membuat administrator, mengubah 2FA, membuat atau mencabut key, masuk sebagai pelanggan, mencadangkan, memulihkan, atau memperbarui panel, dan sejenisnya. Hal-hal ini memerlukan kehadiran Anda di admin. |
| **Log aktivitas** | Setiap panggilan, baik yang diizinkan maupun yang ditolak, dicatat beserta key, klien, alat, IP, dan hasilnya. Lihat System › Settings › API & AI agents › Activity. |
| **Informasi rahasia tidak pernah dikembalikan** | Kata sandi, kunci API, dan token dapat diatur tetapi tidak pernah dapat dibaca kembali. Jawaban yang dilihat oleh AI menampilkan hal tersebut dalam keadaan disamarkan. |
| **Instalasi demo bersifat hanya-baca** | Pada panel demo, setiap penulisan ditolak dengan `demo_read_only`. |

::: important Apa yang dapat dibaca oleh AI
Dengan `admin:read`, asisten dapat membaca nama pelanggan, alamat e-mail, saldo, dan catatan penagihan. Saat Anda menggunakan sumber AI yang berjalan di vendor (OpenAI, Anthropic, Google, OpenRouter), data tersebut dikirim ke vendor tersebut untuk menjawab pertanyaan Anda. Berikan set cakupan terkecil yang dibutuhkannya kepada asisten, dan pilih sumber yang Anda percayai untuk data tersebut.
:::

## Mulai cepat {#quick-start}

1. Masuk ke admin dan buka **AI Chat**. Jika belum ada sumber AI yang terhubung, buka **System › Settings › AI accounts** dan hubungkan satu (lihat [AI accounts and subscriptions](https://nexcmp.com/id/docs/configure-with-ai/ai-accounts-and-subscriptions/)).
2. Ketik "Check my setup progress" dan tekan Enter. Asisten akan membaca [Setup progress checklist](https://nexcmp.com/id/docs/configure-with-ai/setup-checklist/) dan memberi tahu Anda apa saja yang belum selesai.
3. Minta asisten untuk melakukan langkah berikutnya. Tinjau setiap kartu konfirmasi dan tekan **Confirm** untuk menerapkannya.

Untuk melihat contoh pertanyaan yang dapat diajukan, lihat [Example prompts](https://nexcmp.com/id/docs/configure-with-ai/example-prompts/).

![Halaman AI Chat dengan percakapan, hasil alat, dan kartu konfirmasi](https://nexcmp.com/id/docs/images/configure-with-ai/overview-01-ai-chat.webp)

## Batas & catatan {#limits-notes}

- **Demo dan hanya-baca.** Halaman-halaman tersebut terlihat pada panel demo, tetapi tidak ada yang dapat disimpan di sana.
- **Tidak ada shell.** Asisten hanya dapat memanggil alat admin yang tercantum dalam [Connect an AI client](https://nexcmp.com/id/docs/configure-with-ai/mcp-admin/#tools). Asisten tidak dapat menjalankan perintah di server.
- **Modul jaringan dan perutean** (BGP, XDP, antarmuka, NAT, dan sejenisnya) hanya-baca untuk AI, dan area sensitif seperti akun administrator, cadangan, serta pembaruan tertutup sepenuhnya dari kunci.
- **Harga** dalam USD: harga paket dalam dolar per jam, saldo dalam sen.
- **Biaya.** Jawaban AI dibayarkan ke sumber AI yang Anda hubungkan (penggunaan API, atau langganan Anda sendiri). Di AI Chat, Anda dapat mengatur batas pengeluaran harian. Untuk model lisensi NexCMP, lihat https://nexcmp.com/pricing.

## Pemecahan Masalah {#troubleshooting}

| Gejala | Penyebab | Solusi |
|---|---|---|
| AI Chat mengatakan tidak ada sumber AI yang terhubung | Tidak ada sumber yang disiapkan untuk akun admin Anda | Buka System › Settings › AI accounts dan hubungkan satu. |
| Asisten menjawab `insufficient_scope` | Kunci atau koneksi tidak memiliki cakupan untuk alat tersebut | Buat kunci dengan cakupan yang diperlukan, atau hubungkan ulang dan centang pada layar izin. Lihat [Admin API keys](https://nexcmp.com/id/docs/configure-with-ai/admin-api-keys/#errors). |
| Setiap perubahan menampilkan kartu konfirmasi | Diharapkan dalam AI Chat | Tekan **Confirm** untuk menerapkan atau **Reject** untuk membatalkan. |
| Penulisan gagal dengan `demo_read_only` | Panel berada dalam mode demo | Gunakan instalasi non-demo. |