laxmanhalaki 56258205ea ai conlusion flow added and TAT triggering got issue resolved enhanced system config for ai setup

2025-11-11 17:43:37 +05:30

10 KiB

Raw Blame History

Admin Panel - AI Provider Configuration

Overview

Admins can configure AI providers directly through the admin panel without touching code or .env files. The system supports three AI providers with automatic failover.

🎯 Quick Start for Admins

Step 1: Access Admin Panel

Navigate to the admin configurations page in your workflow system.

Step 2: Configure AI Provider

Look for the AI Configuration section with these settings:

Setting	Description	Example Value
AI Provider	Choose your AI provider	`claude`, `openai`, or `gemini`
Claude API Key	API key from Anthropic	`sk-ant-xxxxxxxxxxxxx`
OpenAI API Key	API key from OpenAI	`sk-proj-xxxxxxxxxxxxx`
Gemini API Key	API key from Google	`AIzaxxxxxxxxxxxxxxx`
Enable AI Features	Turn AI on/off	`true` or `false`

Step 3: Get Your API Key

Choose ONE provider and get an API key:

Option A: Claude (Recommended)

Go to https://console.anthropic.com
Create account / Sign in
Generate API key
Copy key (starts with sk-ant-)

Option B: OpenAI

Go to https://platform.openai.com
Create account / Sign in
Navigate to API keys
Create new key
Copy key (starts with sk-proj- or sk-)

Option C: Gemini (Free Tier Available!)

Go to https://ai.google.dev
Sign in with Google account
Get API key
Copy key

Step 4: Configure in Admin Panel

Example: Setting up Claude

Set AI Provider = claude
Set Claude API Key = sk-ant-api03-xxxxxxxxxxxxx
Leave other API keys empty (optional)
Set Enable AI Features = true
Click Save Configuration

✅ Done! The system will automatically initialize Claude.

🔄 How It Works

Automatic Initialization

When you save the configuration:

Admin saves config
  ↓
System clears cache
  ↓
AI Service reads new config from database
  ↓
Initializes selected provider (Claude/OpenAI/Gemini)
  ↓
✅ AI features active

You'll see in server logs:

info: [Admin] AI configuration 'AI_PROVIDER' updated
info: [AI Service] Reinitializing AI provider from updated configuration...
info: [AI Service] Preferred provider from config: claude
info: [AI Service] ✅ Claude provider initialized
info: [AI Service] ✅ Active provider: Claude (Anthropic)
info: [Admin] AI service reinitialized with Claude (Anthropic)

Automatic Failover

If your primary provider fails, the system automatically tries alternatives:

-- Example: Admin configured Claude, but API key is invalid
UPDATE admin_configurations 
SET config_value = 'claude' 
WHERE config_key = 'AI_PROVIDER';

UPDATE admin_configurations 
SET config_value = 'sk-ant-INVALID' 
WHERE config_key = 'CLAUDE_API_KEY';

System Response:

warn: [AI Service] Claude API key not configured.
warn: [AI Service] Preferred provider unavailable. Trying fallbacks...
info: [AI Service] ✅ OpenAI provider initialized
info: [AI Service] ✅ Using fallback provider: OpenAI (GPT-4)

✅ AI features still work! (if OpenAI key is configured)

📋 Configuration Guide by Provider

Claude (Anthropic) - Best for Production

Pros:

✅ High-quality, professional output
✅ Excellent instruction following
✅ Good for formal business documents
✅ Reliable and consistent

Cons:

⚠️ Paid service (no free tier)
⚠️ Requires account setup

Configuration:

AI_PROVIDER = claude
CLAUDE_API_KEY = sk-ant-api03-xxxxxxxxxxxxx

Cost: ~$0.004 per conclusion generation

OpenAI (GPT-4) - Industry Standard

Pros:

✅ Fast response times
✅ Well-documented
✅ Widely used and trusted
✅ Good performance

Cons:

⚠️ Paid service
⚠️ Higher cost than alternatives

Configuration:

AI_PROVIDER = openai
OPENAI_API_KEY = sk-proj-xxxxxxxxxxxxx

Cost: ~$0.005 per conclusion generation

Gemini (Google) - Cost-Effective

Pros:

✅ Free tier available!
✅ Good performance
✅ Easy Google integration
✅ Generous rate limits

Cons:

⚠️ Slightly lower quality than Claude/GPT-4
⚠️ Rate limits on free tier

Configuration:

AI_PROVIDER = gemini
GEMINI_API_KEY = AIzaxxxxxxxxxxxxxxx

Cost: FREE (up to rate limits), then $0.0001 per generation

🔐 Security Best Practices

1. API Key Storage

✅ Stored in database (encrypted in production)
✅ Marked as sensitive (hidden in UI by default)
✅ Never exposed to frontend
✅ Admin access only

2. Key Rotation

Rotate API keys every 3-6 months
Update in admin panel
System automatically reinitializes

3. Access Control

Only Super Admins can update AI configurations
Regular users cannot view API keys
All changes are logged in audit trail

🧪 Testing AI Configuration

Method 1: Check Status via API

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://localhost:5000/api/v1/ai/status

Response:

{
  "success": true,
  "data": {
    "available": true,
    "provider": "Claude (Anthropic)",
    "status": "active"
  }
}

Method 2: Check Server Logs

Look for initialization logs when server starts:

info: [AI Service] Preferred provider from config: claude
info: [AI Service] ✅ Claude provider initialized
info: [AI Service] ✅ Active provider: Claude (Anthropic)

Method 3: Test in Application

Create a workflow request
Complete all approvals
As initiator, click "Finalize & Close Request"
Click "Generate with AI"
Should see AI-generated conclusion

🔄 Switching Providers

Example: Switching from Claude to Gemini

Current Configuration:

AI_PROVIDER = claude
CLAUDE_API_KEY = sk-ant-xxxxxxxxxxxxx

Steps to Switch:

Get Gemini API key from https://ai.google.dev
Open Admin Panel → AI Configuration
Update settings:
- Set AI Provider = gemini
- Set Gemini API Key = AIzaxxxxxxxxxxxxxxx
Click Save

Result:

info: [Admin] AI configuration 'AI_PROVIDER' updated
info: [AI Service] Reinitializing...
info: [AI Service] Preferred provider from config: gemini
info: [AI Service] ✅ Gemini provider initialized
info: [AI Service] ✅ Active provider: Gemini (Google)

✅ Done! System now uses Gemini. No server restart needed!

💡 Pro Tips

1. Multi-Provider Setup (Recommended)

Configure ALL three providers for maximum reliability:

AI_PROVIDER = claude
CLAUDE_API_KEY = sk-ant-xxxxxxxxxxxxx
OPENAI_API_KEY = sk-proj-xxxxxxxxxxxxx
GEMINI_API_KEY = AIzaxxxxxxxxxxxxxxx
AI_ENABLED = true

Benefits:

If Claude is down → automatically uses OpenAI
If OpenAI is down → automatically uses Gemini
Zero downtime for AI features!

2. Cost Optimization

Development/Testing:

Use gemini (free tier)
Switch to paid provider only for production

Production:

Use claude for best quality
Or use openai for fastest responses

3. Monitor Usage

Check which provider is being used:

SELECT 
  ai_model_used,
  COUNT(*) as usage_count,
  AVG(ai_confidence_score) as avg_confidence
FROM conclusion_remarks
WHERE created_at > NOW() - INTERVAL '30 days'
GROUP BY ai_model_used;

⚠️ Troubleshooting

Issue: "AI Service not configured"

Check:

Is AI_ENABLED set to true?
Is at least one API key configured?
Is the API key valid?

Fix:

Open Admin Panel
Verify AI Provider setting
Re-enter API key
Click Save

Issue: "Failed to generate conclusion"

Check:

API key still valid (not expired/revoked)?
Provider service available (check status.anthropic.com, etc.)?
Sufficient API quota/credits?

Fix:

Test API key manually (use provider's playground)
Check account balance/quota
Try switching to different provider

Issue: Provider keeps failing

Fallback Strategy:

Configure multiple providers
System will auto-switch
Check logs to see which one succeeded

📊 Admin Panel UI

The admin configuration page should show:

┌─────────────────────────────────────────────┐
│ AI Configuration                             │
├─────────────────────────────────────────────┤
│                                              │
│ AI Provider: [claude ▼]                     │
│   Options: claude, openai, gemini            │
│                                              │
│ Claude API Key: [••••••••••••••] [Show]     │
│   Enter Claude API key from console.anthr... │
│                                              │
│ OpenAI API Key: [••••••••••••••] [Show]     │
│   Enter OpenAI API key from platform.open... │
│                                              │
│ Gemini API Key: [••••••••••••••] [Show]     │
│   Enter Gemini API key from ai.google.dev    │
│                                              │
│ Enable AI Features: [✓] Enabled             │
│                                              │
│ Current Status: ✅ Active (Claude)          │
│                                              │
│ [Save Configuration]  [Test AI]             │
└─────────────────────────────────────────────┘

🎯 Summary

Key Advantages:

✅ No code changes - Configure through UI
✅ No server restart - Hot reload on save
✅ Automatic failover - Multiple providers
✅ Vendor flexibility - Switch anytime
✅ Audit trail - All changes logged
✅ Secure storage - API keys encrypted

Admin Actions Required:

Choose AI provider
Enter API key
Click Save
Done!

User Impact:

Zero - users just click "Generate with AI"
System handles provider selection automatically
Professional conclusions generated seamlessly

📞 Support

Provider Documentation:

Claude: https://docs.anthropic.com
OpenAI: https://platform.openai.com/docs
Gemini: https://ai.google.dev/docs

For System Issues:

Check /api/v1/ai/status endpoint
Review server logs for initialization
Verify admin_configurations table entries

10 KiB Raw Blame History

Admin Panel - AI Provider Configuration

Overview

🎯 Quick Start for Admins

Step 1: Access Admin Panel

Step 2: Configure AI Provider

Step 3: Get Your API Key

Option A: Claude (Recommended)

Option B: OpenAI

Option C: Gemini (Free Tier Available!)

Step 4: Configure in Admin Panel

🔄 How It Works

Automatic Initialization

Automatic Failover

📋 Configuration Guide by Provider

Claude (Anthropic) - Best for Production

OpenAI (GPT-4) - Industry Standard

Gemini (Google) - Cost-Effective

🔐 Security Best Practices

1. API Key Storage

2. Key Rotation

3. Access Control

🧪 Testing AI Configuration

Method 1: Check Status via API

Method 2: Check Server Logs

Method 3: Test in Application

🔄 Switching Providers

Example: Switching from Claude to Gemini

💡 Pro Tips

1. Multi-Provider Setup (Recommended)

2. Cost Optimization

3. Monitor Usage

⚠️ Troubleshooting

Issue: "AI Service not configured"

Issue: "Failed to generate conclusion"

Issue: Provider keeps failing

📊 Admin Panel UI

🎯 Summary

📞 Support

10 KiB

Raw Blame History