🌉 Menyambungkan Dua Dunia: Website di Cloud Hosting & AI Agent di Server Lokal
Di artikel sebelumnya, kita sudah menemukan racikan infrastruktur paling hemat dan tangguh: menaruh Website Utama (Laravel + MySQL) di Shared Hosting cPanel, lalu menjalankan Otak AI Agent (seperti Hermes Agent + Bot Telegram) di STB Linux Armbian rumah.
Namun muncul satu pertanyaan teknis yang sangat krusial: "Bagaimana caranya agar AI Agent di STB rumah bisa membaca stok barang atau rekap kas di dalam Database MySQL yang ada di Hosting cPanel dengan cepat dan 100% aman dari hacker?" Mari kita bedah arsitektur jembatannya lewat 4 diagram workflow!
1. Kesalahan Fatal Pemula: Membuka "Remote MySQL" (Port 3306) ke Internet!
Saat ingin menghubungkan program luar ke database cPanel, banyak pemula mengambil jalan pintas dengan membuka menu Remote MySQL di cPanel lalu mengizinkan semua alamat IP (simbol %) untuk mengakses Port 3306 secara langsung.
Ini sangat berbahaya! Membuka pintu MySQL langsung ke internet umum sama saja dengan menaruh brankas uang di pinggir jalan raya. Bot scanner milik peretas bisa melakukan tebak password (brute-force), atau jika AI Agent Anda salah menulis query, ia bisa tidak sengaja menghapus tabel penting!
📊 Workflow 1: Cara Berbahaya (Direct DB) vs Cara Aman (Jembatan REST API Laravel)
2. Analogi Pelayan Restoran: Memahami REST API & Bearer Token
Agar database MySQL tetap terkunci rapat di dalam server hosting, kita menugaskan Laravel sebagai perantara melalui jalur REST API (biasanya berada di rute domainanda.com/api/...):
Kita hanya menyediakan "menu" tertentu yang boleh diminta oleh AI Agent, misalnya: /api/cek-stok atau /api/rekap-harian. AI tidak bisa meminta di luar menu itu!
Kode acak panjang (misal dari Laravel Sanctum atau Secret Header) yang wajib ditunjukkan oleh AI Agent di setiap permintaan. Tanpa kartu ini, pintu langsung ditolak (Error 401 Unauthorized)!
Laravel tidak mengirim tampilan HTML yang berat ke AI Agent, melainkan hanya mengirim teks ringkas berformat JSON sehingga sangat hemat kuota Token LLM!
📊 Workflow 2: Cara Kerja Pemeriksaan "Kartu VIP" (Bearer Token) di Pintu Laravel
3. Urutan Kerja Lengkap (End-to-End): Dari Chat Telegram Sampai Dibalas AI!
Mari kita lihat betapa indahnya kerja sama antara HP Anda (Telegram) → STB Rumah (Hermes Agent) → Otak LLM Cloud → Hosting cPanel (Laravel + MySQL) yang semuanya berlangsung hanya dalam waktu ~2 detik:
📊 Workflow 3: Sequence Diagram Integrasi Bot Telegram + Hermes AI + Laravel API
💡 Keuntungan Ganda Arsitektur Ini: Selain 100% aman karena MySQL tidak terekspos ke luar, perhatikan Langkah 7 & 8: karena Laravel sudah menghitungkan SUM(total) di server hosting, data yang dikirim ke AI Agent hanyalah 1 baris JSON kecil. Kuota Token API gratis Anda jadi irit luar biasa!
4. Contoh Kode Jembatan API Sederhana di Laravel (Tanpa Ribet!)
Anda bahkan tidak wajib menginstal pustaka tambahan yang rumit untuk membuat pintu API yang aman bagi AI Agent pribadi Anda. Cukup tambahkan 1 baris kunci rahasia di file .env Laravel Anda, misalnya: AGENT_API_KEY=KunciRahasiaMasAnam2026, lalu pasang rute ini di routes/api.php (atau routes/web.php):
// Contoh Route API Aman untuk AI Agent di Laravel
use IlluminateHttpRequest;
use IlluminateSupportFacadesDB;
use IlluminateSupportFacadesRoute;
Route::get("/api/agent/rekap-kas", function (Request $request) {
// 1. Satpam Penjaga: Cek apakah Bearer Token sesuai dengan .env
$tokenMasuk = $request->bearerToken();
if ($tokenMasuk !== env("AGENT_API_KEY")) {
return response()->json(["error" => "Akses Ditolak! Token Salah."], 401);
}
// 2. Ambil rekap ringkas dari MySQL (Hemat Token LLM!)
$rekap = DB::table("transaksi")
->whereMonth("tanggal", date("m"))
->selectRaw("COUNT(id) as total_trx, SUM(nominal) as total_rupiah")
->first();
// 3. Kembalikan dalam bentuk JSON bersih ke AI Agent
return response()->json([
"status" => "sukses",
"bulan" => date("F Y"),
"data" => $rekap
]);
});
5. Dua Arah Komunikasi: AI Bertanya (Pull API) vs Laravel Melapor Otomatis (Push Webhook)
Selain AI Agent yang aktif bertanya ke Laravel saat kita mengirim chat (Pull / Request API), kita juga bisa membalik arahnya (Push / Webhook): setiap kali ada admin menginput transaksi baru di website Laravel, Laravel otomatis menembak pesan notifikasi ke grup Telegram detik itu juga!
📊 Workflow 4: Perbandingan Mode Tanya-Jawab (API Pull) vs Notifikasi Otomatis (Webhook Push)
📌 3 Aturan Emas Integrasi AI Agent & Website Laravel:
- Jangan Pernah Buka Port MySQL ke Luar: Biarkan database MySQL tetap terkunci di dalam hosting (`localhost`), dan bangun jembatan resmi melalui rute REST API Laravel.
- Wajib Pasang Satpam Token (Bearer Token): Pastikan setiap rute API memeriksa kunci rahasia di Header Authorization dan gunakan selalu jalur terenkripsi HTTPS.
- Olah Angka di Laravel, Bukan di Otak LLM: Biarkan MySQL dan PHP yang menghitung penjumlahan ribuan baris data (`SUM`, `COUNT`, `GROUP BY`), lalu kirimkan hasil akhirnya saja ke AI Agent agar respon super cepat dan hemat kuota token!