包简介

Plug-and-play Laravel chatbot package — Minara AI widget, Live Chat handover, and RAG Knowledge Base dashboard.

README 文档

README

Package Laravel untuk mengintegrasikan chatbot AI Minara, sistem Live Chat Handover ke admin, dan RAG Knowledge Base ke website Laravel mana saja secara plug-and-play.

Fitur

🤖 Minara AI Widget: Chatbot cerdas berbasis AI yang siap membantu pengunjung website 24/7.
👨‍💼 Human-in-the-Loop (Live Chat): Fitur oper alih percakapan dari AI ke Admin secara real-time menggunakan WebSocket.
📚 RAG Knowledge Base: Latih AI Minara dengan mengunggah dokumen (PDF, TXT, Excel, Docx) langsung dari dashboard.
🔍 Dataset Viewer: Pantau teks yang berhasil diekstraksi dan dipelajari oleh AI dari dokumen yang diunggah.
📝 Advanced Chat Logs: Rekaman riwayat obrolan yang terpisah antara interaksi AI dan Admin dengan filter rentang tanggal.
🔍 Dataset Viewer: Pantau konten teks yang berhasil diekstraksi dan dipelajari oleh AI.
📝 Advanced Chat Logs: Riwayat percakapan lengkap yang dipisahkan antara interaksi AI dan Admin.
🎨 UI Isolation: Menggunakan pre-compiled CSS sehingga tampilan chatbot tetap konsisten tanpa merusak desain website asli klien (tidak memerlukan Tailwind di aplikasi utama).---

Persyaratan

PHP ^8.1
Laravel ^10.0 | ^11.0 | ^12.0
Database MySQL / PostgreSQL / SQLite

Instalasi

1. Install via Composer

composer require aranus-tech/chatbot

2. Jalankan perintah install

Perintah ini menerbitkan file konfigurasi (config/chatbot.php) dan aset CSS/ikon ke folder public/vendor/chatbot:

php artisan chatbot:install

3. Jalankan migrasi

Package secara otomatis mendaftarkan 2 tabel yang dibutuhkan:

php artisan migrate

Konfigurasi

1. Environment variables (`.env`)

Tambahkan variabel berikut ke file .env project Anda:

# WebSocket AI dan Admin
CHATBOT_WS_URL="wss://aranus-aranus-chatbot-plugin.hf.space/ws/chat"
CHATBOT_ADMIN_WS_URL="wss://aranus-aranus-chatbot-plugin.hf.space/ws/admin"

# Endpoint upload dokumen ke AI server
CHATBOT_UPLOAD_URL="https://aranus-aranus-chatbot-plugin.hf.space/upload"

# Email yang menerima notifikasi saat pengunjung minta Live Chat
ADMIN_NOTIFICATION_EMAIL="admin@example.com"

2. Konfigurasi dashboard (`config/chatbot.php`)

Setelah chatbot:install, edit config/chatbot.php agar sesuai dengan struktur aplikasi Anda:

return [
    // Nama layout Blade utama aplikasi Anda
    // Halaman dashboard chatbot akan di-extend dari layout ini
    'layout' => 'layouts.app',

    // Prefix URL untuk semua halaman dashboard chatbot
    // Contoh: 'dashboard' -> /dashboard/chatlog, /dashboard/live-chat, dst.
    'prefix' => 'dashboard',

    // Middleware yang melindungi halaman dashboard chatbot
    'middleware' => ['web', 'auth'],
];

Penggunaan

Widget Chatbot (Frontend)

Tambahkan baris berikut ke layout utama website Anda (misalnya resources/views/layouts/app.blade.php):

<head>
    {{-- CSS widget chatbot --}}
    <link rel="stylesheet" href="{{ asset('vendor/chatbot/chatbot-ui.css') }}">
</head>

<body>
    {{-- Konten website Anda --}}

    {{-- Widget chatbot — letakkan sebelum </body> --}}
    @chatbot
</body>

Widget akan muncul sebagai tombol mengambang di pojok kanan bawah halaman.

Dashboard Admin

Package mendaftarkan rute dashboard secara otomatis berdasarkan prefix dan middleware di config/chatbot.php.

Tambahkan tautan berikut ke sidebar navigasi admin Anda:

<a href="{{ route('chatbot.index') }}">Chat Log</a>
<a href="{{ route('chatbot.livechat') }}">Live Chat</a>
<a href="{{ route('chatbot.kb') }}">Knowledge Base</a>
<a href="{{ route('chatbot.kb.dataset') }}">Dataset</a>

Daftar lengkap named routes:

Route Name	Method	URL (default prefix: `dashboard`)	Deskripsi
`chatbot.index`	GET	`/dashboard/chatlog`	Riwayat percakapan AI & Admin
`chatbot.livechat`	GET	`/dashboard/live-chat`	Dashboard Live Chat admin
`chatbot.kb`	GET	`/dashboard/knowledge-base`	Upload & kelola dokumen AI
`chatbot.kb.upload`	POST	`/dashboard/knowledge-base/upload`	Upload dokumen
`chatbot.kb.sync`	POST	`/dashboard/knowledge-base/sync`	Sinkronisasi ulang ke AI server
`chatbot.kb.toggle`	POST	`/dashboard/knowledge-base/toggle/{id}`	Aktifkan/nonaktifkan dokumen
`chatbot.kb.destroy`	DELETE	`/dashboard/knowledge-base/{id}`	Hapus dokumen
`chatbot.kb.dataset`	GET	`/dashboard/knowledge-base/dataset`	Lihat teks hasil ekstraksi

Endpoint API publik (digunakan oleh widget secara internal):

Route Name	Method	URL	Deskripsi
`chatbot.store`	POST	`/aranus-chatbot/store-chat`	Simpan percakapan AI
`chatbot.store.admin`	POST	`/aranus-chatbot/store-admin-chat`	Simpan percakapan admin
`chatbot.notify.handover`	POST	`/aranus-chatbot/notify-admin-handover`	Kirim email notifikasi handover
`chatbot.popular`	GET	`/aranus-chatbot/popular-questions`	Ambil pertanyaan populer

Kustomisasi Tampilan

Jika ingin mengubah tampilan halaman dashboard, publish view-nya terlebih dahulu:

php artisan vendor:publish --tag=chatbot-views

File view akan disalin ke resources/views/vendor/chatbot/. Setelah itu Anda bisa mengedit bebas tanpa mempengaruhi package aslinya.

Struktur Tabel Database

`chat_records`

Kolom	Tipe	Keterangan
`id`	bigint	Primary key
`session_code`	string	Kode sesi unik pengunjung
`type`	enum('ai','admin')	Jenis percakapan
`client_message`	text	Pesan dari pengunjung
`ai_message`	text	Balasan dari AI (nullable)
`admin_message`	longtext	JSON array percakapan admin (nullable)
`waktu`	datetime	Waktu percakapan

`knowledge_documents`

Kolom	Tipe	Keterangan
`id`	bigint	Primary key
`title`	string	Judul dokumen
`original_name`	string	Nama file asli
`filename`	string	Nama file tersimpan
`file_path`	string	Path di storage
`file_size`	bigint	Ukuran file (bytes)
`file_type`	string	Ekstensi file
`content`	longtext	Teks hasil ekstraksi AI (nullable)
`status`	enum('active','inactive')	Status aktif/nonaktif
`sync_status`	enum('pending','synced','failed')	Status sinkronisasi ke AI server
`uploaded_by`	string	Nama admin yang upload

Publish Aset Secara Manual

Jika perlu menerbitkan aset secara terpisah:

# Konfigurasi
php artisan vendor:publish --tag=chatbot-config

# Aset CSS & ikon (wajib untuk widget)
php artisan vendor:publish --tag=chatbot-assets

# View (opsional, untuk kustomisasi tampilan)
php artisan vendor:publish --tag=chatbot-views

aranus-tech/chatbot 适用场景与选型建议

aranus-tech/chatbot 是一款基于 Hack 开发的 Composer 扩展包，目前已累计 0 次下载、GitHub Stars 达 0，最近一次更新时间为 2026 年 05 月 08 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 aranus-tech/chatbot 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 aranus-tech/chatbot 我们能提供哪些服务？

定制开发 / 二次开发

基于 aranus-tech/chatbot 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

aranus-tech/chatbot

包简介

README 文档

README

Fitur

Persyaratan

Instalasi

1. Install via Composer

2. Jalankan perintah install

3. Jalankan migrasi

Konfigurasi

1. Environment variables (`.env`)

2. Konfigurasi dashboard (`config/chatbot.php`)

Penggunaan

Widget Chatbot (Frontend)

Dashboard Admin

Kustomisasi Tampilan

Struktur Tabel Database

`chat_records`

`knowledge_documents`

Publish Aset Secara Manual

aranus-tech/chatbot 适用场景与选型建议

统计信息

GitHub 信息

其他信息

aranus-tech/chatbot

包简介

README 文档

README

Fitur

Persyaratan

Instalasi

1. Install via Composer

2. Jalankan perintah install

3. Jalankan migrasi

Konfigurasi

1. Environment variables (.env)

2. Konfigurasi dashboard (config/chatbot.php)

Penggunaan

Widget Chatbot (Frontend)

Dashboard Admin

Kustomisasi Tampilan

Struktur Tabel Database

chat_records

knowledge_documents

Publish Aset Secara Manual

aranus-tech/chatbot 适用场景与选型建议

统计信息

GitHub 信息

其他信息

1. Environment variables (`.env`)

2. Konfigurasi dashboard (`config/chatbot.php`)

`chat_records`

`knowledge_documents`