Filament ChatGPT Agent is a Filament plugin that allows you to easily integrate ChatGPT into your Filament project, enabling ChatGPT to access context information from your project by creating GPT functions.
Dark Mode:
Select a text to quickly insert it:
Light Mode:
ChatGPT can read the page content for extra context:
I asked ChatGPT to generate a full list of the plugin features:
- Seamless ChatGPT Integration: Easily integrates OpenAI’s ChatGPT into your Filament project.
- Customizable Chat Interface: Modify bot name, button text, panel width, and more.
- Select To Insert: Select some text on the page and insert that with one click.
- Supports Laravel GPT Functions: Define and register custom GPT functions to enhance AI capabilities.
- Page Watcher: Sends the page content and URL to ChatGPT for better contextual responses.
- Configurable OpenAI Model: Choose different models like
gpt-4oorgpt-4o-miniand control temperature and token usage. - Custom System Message: Define how the AI should behave using a system instruction.
- Full Screen Mode: The more space the better.
- Dark Mode Support: Specially tailored to night owls.
You need to have Laravel GPT from Malkuhr installed to use this package. If you haven't done so, follow the installation instructions:
You can install the package via composer:
composer require maltekuhr/laravel-gptNext you need to configure your OpenAI API Key and Organization ID. You can find both in the OpenAI Dashboard.
OPENAI_ORGANIZATION=YOUR_ORGANIZATION_ID
OPENAI_API_KEY=YOUR_API_KEYNow install this package:
composer require likeabas/filament-chatgpt-agentOptionally, you can publish the views:
php artisan vendor:publish --tag="chatgpt-agent-views"Optionally, you can publish translations:
php artisan vendor:publish --tag="chatgpt-agent-translations"Modify your Filament Panel Configuration to include the plugin:
use LikeABas\FilamentChatgptAgent\ChatgptAgentPlugin;
public function panel(Panel $panel): Panel
{
return $panel
...
->plugin(
ChatgptAgentPlugin::make()
)
...
}Also see all available options below.
use App\GPT\Functions\YourCustomGPTFunction;
use LikeABas\FilamentChatgptAgent\ChatgptAgentPlugin;
...
public function panel(Panel $panel): Panel
{
return $panel
...
->plugin(
ChatgptAgentPlugin::make()
->defaultPanelWidth('400px') // default 350px
->botName('GPT Assistant')
->model('gpt-4o')
->buttonText('Ask ChatGPT')
->buttonIcon('heroicon-m-sparkles')
// System instructions for the GPT
->systemMessage('Act nice and help')
// Array of GPTFunctions the GPT can use
->functions([
new YourCustomGPTFunction(),
])
// Default start message, set to false to not show a message
->startMessage('Hello sir! How can I help you today?')
->pageWatcherEnabled(true)
)
...
}Other language strings can be altered in the translations file. Just publish the translations.
See the full list of available options
You can embed the ChatGPT agent in any Blade file:
<body>
@livewire('filament-chatgpt-agent')
</body>This works for all Livewire pages in any Laravel project, not just Filament. Ensure Tailwind CSS, Filament, and Livewire are properly imported.
<body>
...
@livewire('filament-chatgpt-agent')
</body>| Option | Type | Default | Description |
|---|---|---|---|
enabled() |
bool,Closure |
auth()->check() |
Enables or disables the ChatGPT agent. |
botName() |
string,Closure |
'ChatGPT Agent' |
Sets the displayed name of the bot. |
buttonText() |
string,Closure |
'Ask ChatGPT' |
Customizes the button text. |
buttonIcon() |
string,Closure |
'heroicon-m-sparkles' |
Defines the button icon. |
sendingText() |
string,Closure |
'Sending...' |
Text displayed while sending a message. |
model() |
string,Closure |
'gpt-4o-mini' |
Defines the ChatGPT model used. |
temperature() |
float,Closure |
0.7 |
Controls response randomness. Lower is more deterministic. 0-2. |
maxTokens() |
int,Closure |
null |
Limits the token count per response. null is no limit. |
systemMessage() |
string,Closure |
'' |
Provides system instructions for the bot. |
functions() |
array,Closure |
[] |
Defines callable GPT functions. See Using Laravel GPT Functions |
defaultPanelWidth() |
string,Closure |
'350px' |
Sets the chat panel width. |
pageWatcherEnabled() |
bool,Closure |
false |
See the Page wachter option. |
pageWatcherSelector() |
string,Closure |
'.fi-page' |
Sets the CSS selector for the page watcher. |
pageWatcherMessage() |
string,Closure,null |
null |
Message displayed when the page changes. |
startMessage() |
string,bool,Closure |
false |
Default message on panel open. Set to false to disable. |
Laravel GPT allows you to define custom GPTFunctions that ChatGPT can call to execute tasks within your application. This is useful for integrating dynamic data retrieval, calculations, or external API calls into the ChatGPT responses.
Refer to the Laravel GPT documentation for more details.
The Page Watcher feature allows the ChatGPT agent to receive additional context about the current page by including the .innerText of a specified page element (default: .fi-page, the Filament page container) along with the page URL in each message sent to ChatGPT. This helps provide better contextual responses based on the page content.
Use this feature with caution. Since the entire page content (or the selected element's content) is sent to ChatGPT, users should be informed of this behavior. The pageWatcherEnabled option supports a closure, allowing you to provide an opt-in mechanism for users.
To enable the Page Watcher feature, set the pageWatcherEnabled option to true and define a selector for the element to monitor:
public function panel(Panel $panel): Panel
{
return $panel
->plugin(
ChatgptAgentPlugin::make()
->pageWatcherEnabled(true) // Enable page watcher
->pageWatcherSelector('.custom-content') // Specify the selector
->pageWatcherMessage(
"This is the plain text the user can see on the page, use it as additional context for the previous message:\n\n"
) // Optional custom message for ChatGPT
);
}Alternatively, you can use a closure to enable the feature conditionally, such as requiring users to opt-in:
public function panel(Panel $panel): Panel
{
return $panel
->plugin(
ChatgptAgentPlugin::make()
->pageWatcherEnabled(fn () => auth()->user()->settings['enable_page_watcher'] ?? false) // User opt-in
->pageWatcherSelector('.fi-page')
);
}Please see CHANGELOG for more information on what has changed recently.
Please review our security policy on how to report security vulnerabilities.
- Package created by Bas Schleijpen.
- The view and livewire component structure was inspired by Martin Hwang.
- All Contributors