Agentic Chatbot

• Live Demo
• Screenshots
  • Bot management
  • Bot customization
  • Knowledge sources
  • Conversation history
  • Chat widget
  • Visual workflow builder
  • AI-assisted drafting
  • Run history and live tracing
  • Versions and releases
  • API connectors
• Features
  • RAG foundation
  • Visual agentic workflows
  • API connectors
  • Chat widget
  • Production tooling
• Requirements
• Installation
• Configuration
• Usage
  • Fastest path to a working bot
  • Navigation customization
• Embedding the Chat Widget
  • Option 1 — Blade component (Laravel views)
  • Option 2 — Script tag embed (any site)
  • Option 3 — NPM package
• Workflow Node Types
• Importable Example Workflows
• Documentation
• Support
• License

Build, manage, and embed production-ready AI assistants directly in your Filament panel — from a simple grounded Q&A bot to fully guided agentic workflows with branching logic, AI nodes, backend actions, and external API calls.

#Live Demo

Try every feature before you buy:

filament-agentic-chatbot.heinerdevelops.tech

Click Enter Demo on the login page. Pre-configured bots, ingested documentation sources, sample workflows, and a live chat widget are all ready.

#Screenshots

#Bot management

Manage multiple assistants from a Filament-native control plane. Each bot has its own model, prompt, retrieval settings, and analytics.

#Bot customization

Tune widget style, copy, quick prompts, area overrides, and live preview without leaving the bot editor.

#Knowledge sources

Add URL, file, sitemap, or raw-text sources. Track ingestion status and refresh stale sources directly from the panel.

#Conversation history

Inspect conversation transcripts without leaving Filament. Review what users asked, what was retrieved, and which citations backed each answer.

#Chat widget

Show the live embedded chat experience up close, including the branded header, structured replies, and quick prompts.

#Visual workflow builder

Use the plugin feedback collector as a concrete example: the node library stays on the left, the canvas sits in the middle, and inline settings remain visible on the right while you build.

#AI-assisted drafting

Describe the flow you need in natural language, generate a draft workflow, then refine and publish.

#Run history and live tracing

Inspect every execution with completed-path highlighting, step traces, variables, halt reasons, and timestamps.

#Versions and releases

Publish versioned releases with notes and roll back to any prior version in seconds.

#API connectors

Define reusable external API connection profiles and reference them across any workflow HTTP Request node.

#Features

#RAG foundation

• Multi-bot management — unlimited bots, each with its own identity, model, prompt, retrieval config, and access controls
• Source types — URL page, PDF / file upload, plain-text snippet, XML sitemap
• Queue-based ingestion — async chunking, embedding, and upsert with per-source status tracking
• Vector backends — PostgreSQL + pgvector (recommended) or ChromaDB; configurable dimensions
• Provider support — OpenAI, Gemini, Anthropic, xAI, or any provider compatible with laravel/ai
• Streaming chat with grounded retrieval, inline source citations, and citation coverage metrics
• Conversation history — full transcripts with per-message retrieval context and citation links
• Per-bot analytics — conversation count, message volume, source health score, citation coverage chart

#Visual agentic workflows

• 10 node types: Trigger, Send Message, Collect Input, AI Agent, Knowledge Base, Switch/Router, Join, Condition, Action (Database), HTTP Request
• Multi-branch canvas powered by Vue Flow — drag, connect, and organize nodes freely
• AI Agent node — configurable Provider, Model, and System Prompt per node within the same workflow
• Knowledge Base node — inline RAG retrieval mid-flow, configurable result count
• Switch/Router node — N branches + default; route by intent, field value, or AI classification
• HTTP Request node — call external APIs with variable interpolation in body and headers
• Variable interpolation — {{variable_name}} syntax in system prompts, messages, and node configs
• AI Draft — generate a complete workflow graph from a natural-language description in seconds
• Run history with step-level traces, current node, variable snapshot, halt reason, and timestamps
• Versioned releases with release notes; rollback to any prior version without re-editing
• Import / Export — share workflows as JSON between environments

#API connectors

• Reusable connection profiles — URL, auth method (Bearer, API Key, Basic Auth), custom headers
• Referenced by name in any HTTP Request node; update credentials in one place, all workflows update automatically

#Chat widget

• Blade component for Laravel views — authenticated or guest access
• JavaScript loader — single <script> tag embed for any external site (no npm required)
• NPM package for React, Vue, or any bundled frontend
• Signed widget tokens for access-controlled deployments (RAG_WIDGET_SIGNING_ENABLED)
• Mobile-polished — responsive layout, keyboard-safe positioning, iOS safe-area support
• Customizable — colors, placeholder text, greeting, launcher position, and z-index

#Production tooling

• php artisan filament-agentic-chatbot:doctor — pre-flight checks for config, DB, vector store, queue worker, and AI provider
• Data retention policy — scheduled pruning of old conversations with configurable age thresholds
• GDPR / privacy endpoints — export and delete conversation data per user on demand
• Queue isolation — ingestion jobs run on a configurable queue separate from your default queue

#Requirements

• PHP 8.4+
• Laravel 12+
• Filament 5.2+
• PostgreSQL with pgvector extension (recommended) or a running ChromaDB instance
• AI provider API key (GEMINI_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, or XAI_API_KEY)
• A Laravel queue worker

#Installation

composer require heiner/filament-agentic-chatbot
php artisan vendor:publish --tag=filament-agentic-chatbot-config
php artisan migrate
php artisan queue:work

Register the plugin in your panel provider:

use Heiner\FilamentAgenticChatbot\FilamentAgenticChatbotPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            FilamentAgenticChatbotPlugin::make(),
        ]);
}

Include the plugin views in your custom Filament theme:

/* resources/css/filament/admin/theme.css */
@source '../../../../vendor/heiner/filament-agentic-chatbot/resources';

npm run build && php artisan filament:upgrade

#Configuration

.env reference — all values have sensible defaults, override only what you need:

# Vector backend
RAG_VECTOR_BACKEND=pgvector          # pgvector | chromadb

# Dedicated DB connection for vector data (pgvector only)
RAG_DB_CONNECTION=rag_pgsql
RAG_DB_HOST=127.0.0.1
RAG_DB_PORT=5432
RAG_DB_DATABASE=filament_agentic_chatbot
RAG_DB_USERNAME=postgres
RAG_DB_PASSWORD=secret

# AI provider and models
RAG_CHAT_PROVIDER=gemini             # gemini | openai | anthropic | xai
RAG_CHAT_MODEL=gemini-2.5-flash-lite
RAG_EMBEDDING_PROVIDER=gemini
RAG_EMBEDDING_MODEL=gemini-embedding-001
RAG_VECTOR_DIMENSIONS=1536           # must match embedding model output

# Widget authentication
RAG_WIDGET_SIGNING_ENABLED=true
RAG_WIDGET_SIGNING_KEY=replace-with-a-long-random-secret

# Provider API key
GEMINI_API_KEY=your-key-here

Verify your configuration at any time:

php artisan filament-agentic-chatbot:doctor

#Usage

#Fastest path to a working bot

1. Create a bot in Chatbots → Bots
2. Add knowledge sources in Knowledge → Sources
3. Wait for ingestion to complete
4. Test from the bot edit screen using the Test Widget button
5. Embed the widget (see below)
6. Add workflows only when you need guided multi-step behavior

#Navigation customization

FilamentAgenticChatbotPlugin::make()
    ->navigationGroup('AI')   // move all resources under a custom nav group
    ->navigationSort(80)      // control position in the sidebar

#Embedding the Chat Widget

#Option 1 — Blade component (Laravel views)

<x-filament-agentic-chatbot::widget
    bot-id="{{ $bot->id }}"
    :token="$widgetToken"
/>

Generate a signed token (when RAG_WIDGET_SIGNING_ENABLED=true):

use Heiner\FilamentAgenticChatbot\Support\WidgetToken;

$token = WidgetToken::for(botId: $bot->id, userId: auth()->id());

#Option 2 — Script tag embed (any site)

<script
  src="https://your-app.com/vendor/filament-agentic-chatbot/widget.js"
  data-bot-id="YOUR_BOT_ID"
  data-token="YOUR_SIGNED_TOKEN"
  defer
></script>

#Option 3 — NPM package

npm install @heiner/filament-agentic-chatbot-widget

import { ChatWidget } from "@heiner/filament-agentic-chatbot-widget";

<ChatWidget botId="YOUR_BOT_ID" token="YOUR_SIGNED_TOKEN" />;

#Workflow Node Types

#Importable Example Workflows

Seven ready-to-import examples covering common agentic patterns:

Browse and download on GitHub

Import any JSON file via the workflow editor's Import button.

#Documentation

• Product overview
• Quick start guide
• Core concepts
• Agentic workflows — all node types explained
• RAG sources and ingestion
• Bots
• API connectors
• Chat widget embedding
• Conversations and messages
• Workflow JSON schema reference
• Workflow prompt templates
• Operations and production readiness
• Security and privacy
• Data retention policy
• How it differs from Filament RAG
• Known limitations

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