Agentic AI Chatbot Builder
CommunityBuild agentic AI chatbots and assistants in Filament with real-data answers, API/database actions, embeddable chat widgets, and visual workflows to design their behavior.
filament/
namespace. Review the source and install at your own risk. Found
malware or an unresolved security issue the author won't
address?
Report it
.
Author:
Heiner Giehl
Documentation
- Live Demo
- What It Is
- Product Tour
- What Ships
- Best Fit
- Not The Best Fit
- Requirements
- Installation
- Configuration
- Embedding The Widget
- Documentation
- Support
- License
A native Filament control plane for grounded AI assistants, embeddable chat widgets, and visual agentic workflows.
Filament Agentic Chatbot helps Laravel teams build assistants inside the admin panel they already use. Start with a source-grounded support bot, then add guided workflows when you need branching intake, lead qualification, API calls, data capture, quality checks, and human handoff.
This is a young commercial product that is being developed actively. The current public docs snapshot is v0.16.0; the installable runtime line is ^0.16.0. Purchases and commercial support directly fund maintenance, documentation, and new product updates.
#Live Demo
Try the public demo before buying:
filament-agentic-chatbot.heinerdevelops.tech
Use Enter Demo on the login page. The demo includes configured bots, sources, workflows, API connectors, quality tests, and the public widget.
#What It Is
- A Filament-native admin surface for bots, prompts, model settings, widget styling, sources, conversations, workflows, connectors, and quality checks
- A source-grounded chatbot runtime with citations, conversation history, feedback, and optional workflow execution
- A visual workflow editor for multi-step assistant behavior: ask, branch, search knowledge, call APIs, run backend actions, remember values, and reply
- A public embeddable widget that can be styled from the bot editor and reused across websites or authenticated Laravel areas
- Production-minded tooling for release gates, saved quality tests, handoff queues, usage tracking, provider diagnostics, and privacy workflows
#Product Tour
#Live Widget Preview
Style the embedded widget inside the bot editor and see the result immediately. Teams can tune template, font, accent color, size, copy, starter prompts, source visibility, and context-area overrides without leaving Filament.

#Data Resource Readiness
v0.15.0 adds a guided Data Resources workflow for safe live Eloquent reads. Admins approve the model, returned fields, answer-ready defaults, filters, ranking, result limits, and safety scope before a bot or workflow can query live records.

#Compound Requests
v0.16.0 adds bot-level Compound Request modes for legacy, shadow, and structured execution. Structured mode can safely plan multi-item read/write operations against registered actions, Laravel AI tools, and API Connector capabilities while pending workflow turns and confirmations remain authoritative.
#Workflow Focus Canvas
The workflow editor is the strongest differentiator. Focus mode removes the surrounding Filament chrome and side panels, so the graph can be reviewed as a real flow instead of a cramped admin table. The screenshot uses a compact fit-advisor workflow with nodes zoomed out enough to see the structure.

#Dark Mode
The workflow editor follows Filament theme mode. Dark mode keeps nodes, handles, branches, toolbar controls, and labels readable for longer authoring or debugging sessions.

#Workflow Quality Checks
Saved workflow tests sit beside the draft. The Quality panel shows current pass state, release-gate status, expected checks, and publish readiness without sending operators to a separate QA tool.

#Conversation Review
Review full transcripts with citations, message feedback, session metadata, handoff actions, flags, and export controls. This makes the feedback-to-quality loop practical: inspect a real conversation, then turn important failures into saved tests.

#Public Widget Experience
The same bot configuration can power the Filament panel, public landing pages, product docs, authenticated Laravel areas, and API-backed channels. The widget supports signed tokens, context areas, per-bot styling, starter prompts, citations, and mobile layouts.

#API Connectors And Channels
Reusable API connector profiles and channel integrations let teams use the same bot/workflow configuration across widget, API, Slack, Telegram, and backend surfaces without duplicating assistant logic.

#What Ships
#Bots And Grounded Answers
- Multi-bot management with per-bot identity, model, prompt, retrieval settings, widget settings, access controls, and analytics
- Source types for URLs, files, text snippets, and API-fed JSON records
- PostgreSQL +
pgvectorvector storage by default, with Chroma available for teams that prefer it - Source-grounded answers with citations, conversation history, feedback controls, and review screens
- Assistant profile controls for persona, tone, boundaries, fallback behavior, and answer style
- Guided Data Resources for approved live Eloquent reads, with per-field return/filter/sort policies and bot-level narrowing
#Visual Agentic Workflows
- Node catalog for triggers, replies, questions, branches, conditions, AI nodes, knowledge search, API connectors, HTTP requests, actions, memory, loops, delays, sub-workflows, and finish steps
- Canvas authoring with zoom, fit-to-view, minimap, grouping, locking, validation, import/export, focus mode, and light/dark theme support
- Workflow generation from a natural-language brief for teams that want a faster starting point
- Versioned releases with notes and rollback support
- Run tracing and draft debugging for workflow execution paths
#Quality, Operations, And Channels
- Saved quality tests for bots and workflow drafts
- Workflow-linked release gates so important checks can block publishing
- Feedback-to-test review loop for turning user feedback into repeatable checks
- Human handoff inbox for low-confidence, blocked, or operator-required conversations
- Reusable API connectors for external systems and API-backed knowledge sources
- UI-managed Data Resources for safe live database answers when indexed knowledge is not the right source of truth
- Package-owned Telegram and Slack drivers that run through the same bot, workflow, usage, and budget runtime
php artisan filament-agentic-chatbot:doctorfor configuration, provider, vector store, queue, widget signing, and commercial-profile diagnostics
#Best Fit
This plugin is a good fit when you want AI assistants inside a Laravel/Filament product and you care about admin control, grounded answers, workflow logic, reviewability, and operator tooling.
It is especially useful for:
- product support assistants
- onboarding and setup guidance
- documentation assistants with citations
- lead qualification and guided intake
- internal ops assistants
- support triage with handoff
- workflow-driven demos, concierge flows, and feedback capture
#Not The Best Fit
Be cautious if you need a mature no-code enterprise chatbot platform with years of marketplace hardening, non-Laravel hosting, or a fully managed SaaS vendor. This is a Laravel package for teams that want ownership inside their app. It is actively improving, but it is still early enough that careful staging, quality tests, queue monitoring, and normal production review matter.
#Requirements
- PHP
8.3+ - Laravel
12or13 - Filament
5.2+ laravel/ai^0.7 || ^1.0- PostgreSQL with
pgvectorrecommended, or ChromaDB - A Laravel queue worker for ingestion, workflow generation, and production background work
- At least one supported AI provider key
Supported chat providers include Gemini, OpenAI, Anthropic, xAI, OpenRouter, DeepSeek, Groq, Mistral, Ollama, Azure OpenAI, and OpenAI-compatible gateways. Embedding provider support includes Gemini, OpenAI, OpenRouter, Mistral, Ollama, Azure OpenAI, Cohere, Jina AI, and Voyage AI.
#Installation
composer require heiner/filament-agentic-chatbot:^0.16.0
php artisan vendor:publish --tag=filament-agentic-chatbot-config
php artisan migrate
php artisan queue:work
Composer installs heiner/agent-graph transitively for the workflow runtime.
Register the plugin in your Filament panel provider:
use Heiner\FilamentAgenticChatbot\FilamentAgenticChatbotPlugin;
public function panel(Panel $panel): Panel
{
return $panel
->plugins([
FilamentAgenticChatbotPlugin::make(),
]);
}
Include the package views in your custom Filament theme:
/* resources/css/filament/admin/theme.css */
@source '../../../../vendor/heiner/filament-agentic-chatbot/resources';
Then rebuild your assets:
npm run build
php artisan filament:upgrade
#Configuration
New installs should use the AGENTIC_CHATBOT_* env namespace. The older RAG_* namespace remains as a temporary compatibility fallback for one upgrade window.
# Vector backend
AGENTIC_CHATBOT_VECTOR_BACKEND=pgvector
# Dedicated pgvector connection
AGENTIC_CHATBOT_DB_CONNECTION=agentic_pgsql
AGENTIC_CHATBOT_DB_HOST=127.0.0.1
AGENTIC_CHATBOT_DB_PORT=5432
AGENTIC_CHATBOT_DB_DATABASE=filament_agentic_chatbot
AGENTIC_CHATBOT_DB_USERNAME=postgres
AGENTIC_CHATBOT_DB_PASSWORD=secret
# Providers and models
AGENTIC_CHATBOT_CHAT_PROVIDER=gemini
AGENTIC_CHATBOT_CHAT_MODEL=gemini-2.5-flash-lite
AGENTIC_CHATBOT_EMBEDDING_PROVIDER=gemini
AGENTIC_CHATBOT_EMBEDDING_MODEL=gemini-embedding-001
AGENTIC_CHATBOT_VECTOR_DIMENSIONS=1536
# Widget authentication
AGENTIC_CHATBOT_WIDGET_SIGNING_ENABLED=true
AGENTIC_CHATBOT_WIDGET_SIGNING_KEY=replace-with-a-long-random-secret
# Provider API key
GEMINI_API_KEY=your-key-here
Run the doctor command after configuration:
php artisan filament-agentic-chatbot:doctor
#Embedding The Widget
For a public site, add the package script:
<script
src="https://your-app.com/filament-agentic-chatbot/widget"
data-bot="YOUR_BOT_PUBLIC_ID"
data-token="SIGNED_TOKEN"
data-area="public"
defer
></script>
Generate signed tokens server-side when widget signing is enabled:
use Heiner\FilamentAgenticChatbot\Support\WidgetEmbedToken;
$token = WidgetEmbedToken::make(
botPublicId: $bot->public_id,
host: 'docs.example.com',
);
React, Vue, and other bundled frontends can also use the NPM helper:
npm install @heiner/filament-agentic-chatbot-widget
#Documentation
- Product overview
- Quickstart
- Core concepts
- Agentic workflows
- Quality loop
- Chat widget
- API connectors
- Compound Requests
- Workflow Turn Understanding
- Workflow Semantic Authoring
- Channel integrations
- Security and privacy
- Known limitations
- Release notes v0.16.0
- Docs snapshot v0.16.0
#Support
Open an issue in the public issue tracker. Response target: 2 business days.
See the full Support Policy.
#License
This is a commercial plugin. A license is required for production use. Source code distribution is not permitted.
See the full Refund and License terms.
The author
From the same author
RAG Chatbot
Build, manage, and embed production-ready RAG chatbots directly from Filament.
Author:
Heiner Giehl
Image Studio Pro
A powerful in-panel image editor for Filament that lets users create, edit, brand, template, and export production-ready images without leaving the admin.
Author:
Heiner Giehl
Featured Plugins
A selection of plugins curated by the Filament team
Blueprint
Filament Blueprint is a premium Laravel Boost extension that helps AI agents produce accurate, detailed implementation plans and security reports for Filament apps.
Filament
Data Lens
Advanced Data Visualization for Laravel Filament - a premium reporting solution enabling custom column creation, sophisticated filtering, and enterprise-grade data insights within admin panels.
Padmission
Advanced Tables (formerly Filter Sets)
Supercharge your tables with powerful features like user-customizable views, quick filters, multi-column sorting, advanced table searching, convenient view management, and more. Compatible with Resource Panel Tables, Relation Managers, Table Widgets, and Table Builder!
Kenneth Sese