Agentic AI Chatbot Builder plugin screenshot
Dark mode ready
Multilingual support
Supports v5.x

Agentic AI Chatbot Builder

Community

Build agentic AI chatbots and assistants in Filament with real-data answers, API/database actions, embeddable chat widgets, and visual workflows to design their behavior.

Tags: Widget Developer Tool
Supported versions:
5.x
Third-party plugin. This is built by the community, not the Filament team. Filament does not review, endorse, or vet the security of plugins outside the 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 .
Heiner Giehl avatar Author: Heiner Giehl

Documentation

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.

Widget live preview

#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.

Data Resource readiness

#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.

Workflow editor focus mode

#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 editor dark mode

#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.

Workflow quality panel

#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.

Conversation review

#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.

Public widget experience

#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.

API connectors list

#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 + pgvector vector 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:doctor for 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 12 or 13
  • Filament 5.2+
  • laravel/ai ^0.7 || ^1.0
  • PostgreSQL with pgvector recommended, 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

#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.