Grav AI Chatbot: Plugin RAG Kelas Produksi untuk Grav CMS

grav-cms php rag sqlite llm web-components

Plugin Grav AI Chatbot siap produksi dengan pencarian vektor RAG SQLite lokal, sistem failover multi-provider, dan guardrail anti prompt-injection yang waspada agar chatbot tidak mengada-ada soal diskon toko.

Cerita di Balik Layar: AI di Flat-File CMS Tanpa Ribet

Sebagian besar plugin chatbot memaksa kita memilih antara widget iframe pihak ketiga yang lambat dan melacak pengunjung, atau menyalakan microservice Python bergiga-giga hanya untuk menjawab pertanyaan dasar di situs portofolio.

Saya butuh solusi yang ramping, self-hosted, dan menyatu mulus dengan Grav CMS. Lahirlah grav-ai-chatbot: plugin PHP murni yang mengubah dokumen markdown situs menjadi basis pengetahuan vektor lokal via SQLite RAG, sambil menyiarkan respons streaming via Web Components modern.

Arsitektur Grav AI Chatbot

Sorotan Arsitektur

  • SQLite Vector RAG Lokal: Melakukan pra-indeks seluruh halaman ke dalam sqlite-vec untuk pencarian tanpa latensi tanpa perlu langganan database vektor pihak ketiga.
  • Failover Multi-Provider: Mengalihkan permintaan secara mulus ke Groq, Google Gemini, OpenAI, OpenRouter, dan Ollama lokal ketika limit API tercapai.
  • Guardrail Waspada: Sanitasi regex bertingkat, token kenari, dan filter injeksi prompt untuk mencegah pembajakan instruksi sistem.
  • Web Components Mandiri: Drawer chat responsif yang dibangun dengan custom elements peramban modern, rendering markdown cepat, dan aksesibilitas ramah keyboard.
  • Integrasi Admin2: Konfigurasi lengkap lewat panel admin Grav dengan pemantauan kuota token dan pembangunan ulang indeks secara langsung.

Memulai Cepat

# Kloning langsung ke direktori plugin Grav Anda
git clone https://github.com/milkboyinchina/grav-ai-chatbot.git user/plugins/ai-chatbot

# Bangun ulang indeks vektor melalui CLI
php bin/plugin ai-chatbot index:rebuild

Lihat kode sumber lengkap di GitHub: milkboyinchina/grav-ai-chatbot.

Previous Post