Download the PHP package alpinedigital/craft-ai-chatbot without Composer
On this page you can find all versions of the php package alpinedigital/craft-ai-chatbot. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download alpinedigital/craft-ai-chatbot
More information about alpinedigital/craft-ai-chatbot
Files in alpinedigital/craft-ai-chatbot
Package craft-ai-chatbot
Short Description AI Chatbot voor Craft CMS met content-gebaseerde retrieval
License MIT
Informations about the package craft-ai-chatbot
AI Chatbot
Een Craft CMS plugin die je site-content synchroniseert naar een database en een AI-chatbot aanbiedt met slimme retrieval.
Vereisten
- Craft CMS 5.0.0 of later
- PHP 8.2 of later
- Minimaal één AI provider API key
Installatie
1. Installeer via Composer:
2. Installeer de plugin:
Dit voert automatisch alle database migraties uit. Geen handmatige DB-setup nodig.
3. Configureer in het CP:
Ga naar Settings → Plugins → AI Chatbot en volg de configuratiestappen hieronder.
Aanbevolen model
Uit tests blijkt dat OpenAI GPT-4.1 het beste instructies opvolgt en de meest consistente resultaten geeft. Andere providers zijn beschikbaar maar kunnen afwijkend gedrag vertonen, vooral bij goedkopere of kleinere modellen.
Providers
De plugin werkt in twee modi afhankelijk van welke API keys je configureert:
Embedding modus (aanbevolen)
Vereist een OpenAI API key. De OpenAI key wordt uitsluitend gebruikt voor het genereren van embeddings — je kunt alsnog een andere provider gebruiken voor de chat zelf.
- Slimme retrieval: enkel relevante entries worden per vraag naar de LLM gestuurd
- Geschikt voor sites van elke grootte
- Token-efficiënt: aanzienlijk lagere kosten vergeleken met niet-embedding modus
- Ondersteunt chunking: lange entries worden opgesplitst in meerdere embeddings voor nauwkeurigere retrieval
Niet-embedding modus
Werkt met elke provider zonder OpenAI key. Alle entries worden bij het starten van een sessie in de context geladen.
- Aanbevolen voor kleine sites (minder dan ~100 entries)
- Minder nauwkeurige retrieval
- Hoger tokengebruik per bericht
Configuratie
Ga naar Settings → Plugins → AI Chatbot. Het dashboard heeft 3 tabs:
Tab 1: Configuratie
- Selecteer welke secties en velden de chatbot mag gebruiken
- Klik op "Save & Sync" om op te slaan én de data te synchroniseren naar de database
- Met openai key wordt embeddings op de achtergrond gegenereerd via Craft's queue
Tab 2: Instellingen
- Configureer je AI provider, API keys, model, uiterlijk van de chatbot en meer
- Vul deze tab als eerste in voordat je synchroniseert
Tab 3: Statistieken
- Chart met het aantal vragen en limieten responses per dag/week/maand
-
Chart met het aantal vragen per uur op een dag
Systeem prompt
De systeem prompt is een van de belangrijkste instellingen van de plugin. De standaardwaarde is minimaal — het is sterk aangeraden deze uit te breiden.
Een goede prompt bevat instructies over gedrag, beperkingen, taal en toon. Bijvoorbeeld:
Gebruik in templates
Voeg de chatbot widget toe aan je Twig template:
Automatische synchronisatie
De plugin synchroniseert automatisch wanneer:
- Een entry wordt opgeslagen in een geselecteerde sectie
- Een entry geüpdate is
- Een entry wordt verwijderd
In embedding modus wordt het genereren van embeddings als achtergrondtaak uitgevoerd via de Craft queue, zodat het opslaan van entries niet geblokkeerd wordt.
Verwijderen
-
Verwijder de plugin via Craft: Settings → Plugins → AI Chatbot → Uninstall Dit verwijdert automatisch alle plugin database tabellen.
- Verwijder via Composer:
OF → Na uninstall in Craft kan er nog remove staan Je kan hier ook nog op klikken om hetzelfde resultaat te krijgen als de composer command.
-
Verwijder {{ craft.craftJsonPlugin.render()|raw }} uit de twig(s) waarop de plugin stond
- Verwijder optioneel de API keys uit je
.envbestand.