Lara Dashboard Lara Dashboard
/
main (default) 0.x

AI Integration

Complete guide to using LaraDashboard's AI-powered content generation with OpenAI and Claude, including configuration and the Agentic CMS command center.

AI Integration

LaraDashboard features an Agentic CMS with AI-powered content generation capabilities. This guide covers configuring AI providers, using the command center, and integrating AI into your workflows.

Overview

What is Agentic CMS?

LaraDashboard's Agentic CMS is an AI-powered command center that allows you to:

  • Generate content using natural language commands
  • Enhance and modify existing content
  • Automate repetitive content tasks
  • Get AI assistance for writing and editing

Supported Providers

Provider Default Model Best For
OpenAI GPT-4o Mini General content generation, image generation (DALL-E 3)
Anthropic Claude 3 Haiku Long-form content, analysis, structured output
Google Gemini Gemini 2.0 Flash Fast responses, cost-effective
Ollama Llama 3.2 Local/private deployment, no API key needed

Configuration

Environment Variables

Add AI credentials to your .env file:

# Default AI Provider (openai, anthropic, gemini, ollama)
AI_DEFAULT_PROVIDER=openai

# OpenAI Configuration
OPENAI_API_KEY=sk-...
OPENAI_MODEL=gpt-4o-mini
OPENAI_MAX_TOKENS=2000
OPENAI_TEMPERATURE=0.7

# Claude / Anthropic Configuration
ANTHROPIC_API_KEY=sk-ant-...
ANTHROPIC_MODEL=claude-3-haiku-20240307
CLAUDE_MAX_TOKENS=2000

# Google Gemini Configuration
GEMINI_API_KEY=...
GEMINI_MODEL=gemini-2.0-flash

# Ollama Configuration (local LLM — no API key needed)
OLLAMA_BASE_URL=http://localhost:11434
OLLAMA_MODEL=llama3.2

Config File

Detailed configuration in config/ai.php:

<?php

return [
    /*
    |--------------------------------------------------------------------------
    | Default AI Provider
    |--------------------------------------------------------------------------
    */
    'default' => env('AI_DEFAULT_PROVIDER', 'openai'),

    /*
    |--------------------------------------------------------------------------
    | OpenAI Configuration
    |--------------------------------------------------------------------------
    */
    'openai' => [
        'api_key' => env('OPENAI_API_KEY'),
        'model' => env('OPENAI_MODEL', 'gpt-4'),
        'max_tokens' => (int) env('OPENAI_MAX_TOKENS', 2000),
        'temperature' => (float) env('OPENAI_TEMPERATURE', 0.7),
        'organization' => env('OPENAI_ORGANIZATION'),
    ],

    /*
    |--------------------------------------------------------------------------
    | Claude Configuration
    |--------------------------------------------------------------------------
    */
    'claude' => [
        'api_key' => env('ANTHROPIC_API_KEY'),
        'model' => env('CLAUDE_MODEL', 'claude-3-opus-20240229'),
        'max_tokens' => (int) env('CLAUDE_MAX_TOKENS', 2000),
    ],

    /*
    |--------------------------------------------------------------------------
    | Command Center Settings
    |--------------------------------------------------------------------------
    */
    'commands' => [
        'enabled' => env('AI_COMMANDS_ENABLED', true),
        'rate_limit' => env('AI_RATE_LIMIT', 20), // per minute
        'log_commands' => env('AI_LOG_COMMANDS', true),
    ],
];

Using the Command Center

Accessing the Command Center

The AI Command Center is available when editing content:

  1. Navigate to any post/page editor
  2. Click the AI Assistant button (🤖)
  3. The command center panel opens

Command Syntax

Enter natural language commands:

Generate a 500-word blog post about Laravel best practices

Summarize this article in 3 bullet points

Rewrite this paragraph to be more engaging

Available Commands

Content Generation

Command Description
Generate [description] Create new content
Write [description] Alias for generate
Create [type] about [topic] Generate specific content type

Examples:

Generate a product description for a wireless mouse
Write an introduction for a blog about AI
Create a headline for an article about climate change

Content Enhancement

Command Description
Improve [selection] Enhance selected text
Rewrite [selection] Rewrite in different style
Expand [selection] Make content longer
Summarize [selection] Create a summary
Simplify [selection] Make easier to read

Examples:

Improve the introduction paragraph
Rewrite this in a professional tone
Expand the features section
Summarize this article in 100 words

SEO Optimization

Command Description
Generate meta description Create SEO description
Suggest keywords for [topic] Get keyword ideas
Optimize title for SEO Improve title

Translation

Command Description
Translate to [language] Translate content
Localize for [region] Adapt for region

Streaming Responses

AI responses stream in real-time for better UX:

// Response appears progressively
"Generating... ▌"
"Here is your content: Lorem ipsum... ▌"
"Here is your content: Lorem ipsum dolor sit amet..."

Programmatic Usage

AiContentGeneratorService

Use AI in your code:

use App\Services\AiContentGeneratorService;

class ContentController extends Controller
{
    public function __construct(
        private AiContentGeneratorService $aiService
    ) {}

    public function generateContent(Request $request)
    {
        $result = $this->aiService->generate([
            'prompt' => $request->prompt,
            'max_tokens' => 1000,
            'temperature' => 0.7,
        ]);

        return response()->json([
            'content' => $result->content,
            'usage' => $result->usage,
        ]);
    }
}

Available Methods

// Generate content
$result = $aiService->generate([
    'prompt' => 'Write a product description',
    'context' => 'E-commerce website selling electronics',
]);

// Modify existing text
$result = $aiService->modify([
    'text' => $existingContent,
    'instruction' => 'Make this more concise',
]);

// Generate with streaming
$aiService->generateStream([
    'prompt' => 'Generate a long article',
    'callback' => function ($chunk) {
        echo $chunk;
    },
]);

// Use specific provider
$result = $aiService->withProvider('claude')->generate([
    'prompt' => 'Analyze this code...',
]);

API Endpoints

# Get available providers
GET /api/v1/ai/providers

# Generate content
POST /api/v1/ai/generate-content
{
    "prompt": "Write a blog post about...",
    "provider": "openai",
    "options": {
        "max_tokens": 1000
    }
}

# Modify text
POST /api/v1/ai/modify-text
{
    "text": "Original text here...",
    "instruction": "Make it shorter"
}

# Stream generation
POST /admin/ai/command/process-stream
{
    "command": "Generate article about AI",
    "context": {}
}

Command Logging

Viewing Logs

All AI commands are logged for auditing:

  1. Navigate to Settings → AI → Command History
  2. View command, response, user, and timestamp
  3. Filter by date, user, or command type

Log Structure

// ai_command_logs table
[
    'user_id' => 1,
    'command' => 'Generate blog post...',
    'provider' => 'openai',
    'model' => 'gpt-4',
    'parameters' => ['max_tokens' => 1000],
    'response_tokens' => 850,
    'duration_ms' => 2500,
    'status' => 'success',
    'created_at' => '2024-01-15 10:30:00',
]

Cost Management

Token Usage

Monitor token usage:

// Get usage statistics
$stats = $aiService->getUsageStats([
    'user_id' => auth()->id(),
    'period' => 'month',
]);

// Returns
[
    'total_tokens' => 50000,
    'total_requests' => 150,
    'estimated_cost' => 1.50,
]

Rate Limiting

Configure rate limits per user:

// config/ai.php
'rate_limits' => [
    'default' => 20,  // requests per minute
    'premium' => 100, // for premium users
],

Cost Estimation

// Estimate before generating
$estimate = $aiService->estimateCost([
    'prompt' => $prompt,
    'max_tokens' => 1000,
]);

// Returns
[
    'input_tokens' => 150,
    'output_tokens' => 1000,
    'estimated_cost' => 0.045,
]

Prompt Engineering

System Prompts

Configure default system prompts:

// In service or config
$systemPrompts = [
    'content_writer' => "You are a professional content writer...",
    'seo_expert' => "You are an SEO specialist...",
    'translator' => "You are a professional translator...",
];

Context Injection

Provide context for better results:

$result = $aiService->generate([
    'prompt' => 'Write a product description',
    'context' => [
        'brand' => 'TechCorp',
        'product_type' => 'Wireless Mouse',
        'features' => ['ergonomic', 'long battery', 'multi-device'],
        'tone' => 'professional',
        'target_audience' => 'business professionals',
    ],
]);

Template Prompts

Create reusable prompt templates:

// Store templates
$templates = [
    'blog_post' => [
        'system' => 'You are a skilled blog writer...',
        'template' => "Write a {length} word blog post about {topic}. Include {sections} sections. Tone: {tone}.",
    ],
    'product_description' => [
        'system' => 'You are an e-commerce copywriter...',
        'template' => "Write a compelling product description for {product}. Highlight: {features}. Target audience: {audience}.",
    ],
];

// Use template
$result = $aiService->generateFromTemplate('blog_post', [
    'length' => 800,
    'topic' => 'Laravel Performance',
    'sections' => 5,
    'tone' => 'informative',
]);

Error Handling

Common Errors

try {
    $result = $aiService->generate($params);
} catch (AiProviderException $e) {
    // Provider API error
    Log::error('AI Provider Error: ' . $e->getMessage());
} catch (RateLimitException $e) {
    // Rate limit exceeded
    return response()->json([
        'error' => 'Too many requests. Please wait.',
        'retry_after' => $e->retryAfter,
    ], 429);
} catch (InsufficientCreditsException $e) {
    // No API credits
    return response()->json([
        'error' => 'API credits exhausted.',
    ], 402);
}

Fallback Providers

Configure fallback when primary fails:

// config/ai.php
'fallback' => [
    'enabled' => true,
    'order' => ['openai', 'claude'],
    'on_errors' => ['rate_limit', 'timeout', 'server_error'],
],

Security Considerations

API Key Security

  • Never commit API keys to version control
  • Use environment variables
  • Rotate keys periodically
  • Use separate keys for production/development

Content Moderation

Enable content filtering:

// config/ai.php
'moderation' => [
    'enabled' => true,
    'block_categories' => ['hate', 'violence', 'sexual'],
    'log_blocked' => true,
],

User Permissions

Control AI access:

// Permissions
'ai.use'         // Can use AI features
'ai.settings'    // Can configure AI
'ai.view_logs'   // Can view command logs

Hooks

AI Hooks

use TorMorten\Eventy\Facades\Events as Eventy;

// Before AI generation
Eventy::action('ai.before_generate', function ($params, $user) {
    // Log or modify params
});

// After AI generation
Eventy::action('ai.after_generate', function ($result, $params, $user) {
    // Post-process result
});

// Filter AI prompt
$prompt = Eventy::filter('ai.prompt', $prompt, $context);

// Filter AI result
$content = Eventy::filter('ai.result', $content, $command);

Best Practices

Prompt Design

  1. Be specific and clear
  2. Provide context
  3. Specify format requirements
  4. Set appropriate length limits
  5. Include examples when helpful

Performance

  1. Use streaming for long content
  2. Cache repeated queries
  3. Batch similar requests
  4. Monitor token usage

Quality

  1. Review AI-generated content
  2. Edit and personalize
  3. Check facts and accuracy
  4. Maintain brand voice

Troubleshooting

No Response

  1. Check API key is valid
  2. Verify network connectivity
  3. Check rate limits
  4. Review error logs

Poor Quality Output

  1. Improve prompt specificity
  2. Provide more context
  3. Adjust temperature (lower = more focused)
  4. Try different model

Slow Generation

  1. Reduce max_tokens
  2. Use faster model (gpt-3.5 vs gpt-4)
  3. Enable streaming
  4. Check network latency

CRM AI Capabilities

The CRM module includes extensive AI integration across all major entities:

Contact Intelligence

  • Lead Scoring — Score contacts 0-100 based on profile completeness and engagement
  • Data Enrichment — Enrich contact profiles with AI-inferred data
  • Duplicate Detection — Fuzzy matching to find potential duplicate contacts
  • Smart Segmentation — AI-powered suggestions for contact segments
  • Activity Summaries — Generate narrative summaries of contact interactions

Deal Intelligence

  • Deal Scoring — Health scoring and win probability for deals
  • Pipeline Forecasting — Revenue predictions based on deal stages and velocity
  • Stale Deal Detection — Identify deals that need attention
  • Next Step Suggestions — AI recommendations for deal progression

Support Intelligence

  • Ticket Categorization — Auto-categorize incoming support tickets
  • Sentiment Analysis — Detect customer sentiment in ticket messages
  • Reply Suggestions — AI-generated reply drafts for support agents

Campaign & Invoice AI

  • Email Subject Generation — Generate high-converting subject lines
  • Email Body Improvement — Enhance campaign email content
  • Payment Prediction — Predict invoice payment likelihood
  • Follow-up Suggestions — AI-generated follow-up email drafts

Dashboard Insights

  • Daily/Weekly Digest — AI-generated summaries of CRM activity
  • Dashboard Insights — Pattern detection and trend analysis
  • Follow-up Recommendations — Prioritized follow-up suggestions

CRM AI features are controlled individually via Settings → CRM → AI. Each capability can be toggled on or off independently.

Adding AI to Your Module

LaraDashboard provides a modular AI architecture that any module can extend using the Capability / Action / Context pattern.

For a complete developer guide on integrating AI into your module, see:

Next Steps

Edit this page on GitHub
/