Configurer Aiterava Intelligence
La configuration se fait entièrement depuis le dashboard : Paramètres → Intelligence IA.
Mode clé plateforme (SaaS uniquement)
En mode SaaS, Aiterava fournit l'accès à l'IA via un système de crédits. Aucune clé API externe n'est requise.
- Chaque requête IA consomme des crédits selon le modèle utilisé
- Votre solde de crédits est visible dans Paramètres → Intelligence IA → Crédits
- Des alertes sont envoyées quand le solde atteint le seuil d'alerte (80% par défaut)
Mode BYOK — Bring Your Own Key
Le mode BYOK vous permet d'utiliser votre propre clé API chez n'importe quel provider. Vos tokens sont facturés directement par le provider, pas par Aiterava.
Activer BYOK
- Allez dans Paramètres → Intelligence IA.
- Dans la section Clés API, cliquez sur + Ajouter une clé.
- Sélectionnez le provider (Anthropic, OpenAI, Gemini...).
- Collez votre clé API.
- Cliquez sur Enregistrer.
Les clés sont chiffrées au repos (AESGCM) — vous ne pouvez pas les relire après enregistrement.
Providers et où obtenir les clés
| Provider | URL | Notes |
|---|---|---|
| Anthropic (Claude) | console.anthropic.com | Recommandé — meilleur rapport qualité/coût |
| OpenAI (GPT) | platform.openai.com | — |
| Google Gemini | aistudio.google.com | Quota gratuit disponible |
| Groq | console.groq.com | Très rapide, quota gratuit |
| Mistral | console.mistral.ai | Modèles européens (RGPD) |
| Ollama | Votre infrastructure locale | Zéro coût, nécessite GPU |
BYOK en on-premise
Sur une instance on-premise, activez BYOK en ajoutant dans votre .env :
# Clé de chiffrement des tokens (requise pour BYOK et WhatsApp)
AI_BYOK_MASTER_KEY=<64 caractères hex>
# Générer :
# openssl rand -hex 32
Paramètres de politique IA
Dans Paramètres → Intelligence IA → Politique, vous pouvez configurer :
| Paramètre | Description |
|---|---|
| IA activée | Active/désactive toute l'IA pour votre tenant |
| Provider préféré | Provider utilisé en priorité pour vos requêtes |
| Mode local uniquement | Bloque tout envoi de données vers des providers externes |
| Données sensibles autorisées | Autorise/bloque les données sensibles dans les prompts |
| Mode de complexité par défaut | SIMPLE (rapide/économique) → MEDIUM → COMPLEX (puissant) |
| Quota mensuel | Plafond de crédits par mois |
| Limite journalière | Plafond journalier (0 = pas de limite) |
Variables d'environnement (on-premise)
# ─── Aiterava Intelligence ───────────────────────────────────────────────────
AI_BYOK_MASTER_KEY=<openssl rand -hex 32>
# Optionnel : clé plateforme Anthropic fournie par Aiterraxis
# (si vous ne souhaitez pas gérer votre propre clé)
ANTHROPIC_PLATFORM_API_KEY=sk-ant-...
Prochaine étape → Canal — Chat visiteur