📊 Usage API

Aaia-WP inclut une surveillance complète de l’usage API pour vous aider à suivre votre consommation API Gemini, optimiser les coûts, et vous assurer de rester dans vos limites de quota. Cette fonctionnalité fournit des analyses détaillées et des insights sur les performances de votre chatbot.

🎯 Pourquoi Surveiller l’Usage API ?

Comprendre votre consommation API est crucial pour :

Contrôle des Coûts : Suivre les coûts estimés pour éviter les factures inattendues
Optimisation des Performances : Identifier les modèles d’usage pour optimiser votre chatbot
Gestion des Quotas : Rester dans les limites du niveau gratuit de Google
Insights Analytiques : Comprendre l’engagement des utilisateurs avec votre assistant IA

📈 Accéder aux Analyses d’Usage

Trouver l’Onglet Usage API

Dans votre tableau de bord WordPress, naviguez vers Réglages > Aaia XP et cliquez sur l’onglet “Usage API”. Cette section dédiée fournit des outils de surveillance complets et des analyses détaillées sur votre consommation API.

Mises à Jour de Données en Temps Réel

Le moniteur d’usage suit automatiquement chaque requête API faite par votre chatbot, incluant le nombre de requêtes, l’usage estimé de jetons, et les coûts calculés basés sur les modèles de tarification actuels de Gemini.

💡 Comprendre les Métriques d’Usage

Cartes de Résumé

Le tableau de bord affiche trois métriques clés pour les 30 derniers jours :

Requêtes : Nombre total d’appels API faits à Gemini. Chaque message utilisateur génère typiquement une requête, bien que les interactions complexes puissent nécessiter plusieurs appels.

Jetons Estimés : Consommation approximative de jetons basée sur la longueur des messages et les instructions système. Les jetons représentent les “unités de calcul” que Gemini utilise pour traiter vos requêtes.

Coût Estimé : Dépenses calculées basées sur la structure de tarification actuelle de Google. Cela vous aide à comprendre l’impact financier de l’usage de votre chatbot.

📊 Analyses Visuelles

Graphiques de Requêtes Quotidiennes

Les graphiques interactifs montrent vos modèles de requêtes quotidiennes, vous aidant à identifier :

Heures de Pointe : Quand vos utilisateurs sont les plus actifs
Modèles de Trafic : Tendances hebdomadaires et mensuelles
Détection de Pics : Activité inhabituelle qui pourrait indiquer du trafic de bots ou du contenu viral

Visualisation des Coûts

Les graphiques de coûts quotidiens fournissent des insights financiers en affichant :

Dépenses Quotidiennes : Suivre les coûts jour par jour
Tendances de Coûts : Identifier les modèles d’usage croissants ou décroissants
Planification Budgétaire : Projeter les dépenses futures basées sur l’usage actuel

📋 Tableaux d’Usage Détaillés

Répartition Quotidienne

Le tableau détaillé montre :

Date : Jour spécifique d’usage
Requêtes : Nombre d’appels API pour ce jour
Jetons Estimés : Consommation de jetons pour le jour
Coût Estimé : Coûts associés en USD

Ces données granulaires vous aident à comprendre exactement quand et comment votre quota API est consommé.

⚙️ Fonctionnalités d’Optimisation

Intégration du Cache de Contexte

Quand le Cache de Contexte est activé dans les Paramètres API, vous verrez des réductions significatives dans la consommation de jetons. Le cache stocke les instructions système et le contexte fréquemment utilisé pendant 24 heures, réduisant :

Usage de Jetons Répétés : Les instructions système n’ont pas besoin d’être envoyées avec chaque requête
Efficacité du Contexte : Le contexte de conversation est mis en cache et réutilisé
Économies de Coûts : Jusqu’à 60% de réduction dans la consommation de jetons pour les sites actifs

Avantages de la Gestion de Session

Avec la Gestion de Session activée (fonctionnalité Beta), vous pouvez obtenir des économies encore plus importantes :

Conversations Courtes (5-10 messages) : ~30% de réduction de jetons
Conversations Moyennes (10-30 messages) : ~70% de réduction de jetons
Conversations Longues (30+ messages) : ~90% de réduction de jetons

🔄 Gestion des Données

Fonctionnalité de Rafraîchissement

Utilisez le bouton “Actualiser les Données” pour :

Mettre à Jour les Statistiques : Obtenir les dernières informations d’usage
Synchroniser les Enregistrements : Assurer la précision entre le suivi local et l’usage réel
Surveillance en Temps Réel : Vérifier les niveaux de consommation actuels

Rétention des Données

Les données d’usage sont stockées localement dans votre base de données WordPress et automatiquement :

Maintient un Historique de 30 Jours : Garde des enregistrements détaillés pour analyse
Nettoyage Automatique : Supprime les données anciennes pour éviter l’encombrement de la base
Protection de la Vie Privée : Toutes les données restent sur votre serveur

🚨 Alertes d’Usage et Limites

Comprendre les Limites de Google

Le niveau gratuit de Google fournit :

15 requêtes par minute : Limitation de taux pour les appels API
1 500 requêtes par jour : Quota quotidien pour les comptes gratuits
Allocation Généreuse de Jetons : Suffisant pour la plupart des petits et moyens sites web

Recommandations de Surveillance

Vérifications Quotidiennes : Révisez régulièrement les modèles d’usage pour identifier les tendances

Analyse Hebdomadaire : Recherchez des pics ou baisses inhabituels d’activité

Planification Mensuelle : Utilisez les données historiques pour projeter les besoins futurs

Configuration d’Alertes : Considérez la surveillance externe si vous approchez des limites de quota

💰 Stratégies d’Optimisation des Coûts

Activer le Cache de Contexte

Activez le Cache de Contexte dans les Paramètres API pour réduire la consommation de jetons jusqu’à 60% pour les sites avec des instructions système et un contexte de page cohérents.

Optimiser les Instructions Système

Gardez vos instructions système concises mais efficaces. Les instructions plus longues consomment plus de jetons avec chaque requête.

Configurer la Gestion de Session

Activez la fonctionnalité beta Gestion de Session pour des économies de jetons dramatiques sur les sites avec des conversations plus longues.

Réviser la Configuration de l’Assistant

Évaluez régulièrement les paramètres de votre chatbot pour assurer des performances optimales sans consommation de jetons inutile.

🔍 Dépannage des Problèmes d’Usage

Préoccupations d’Usage Élevé

Si vous remarquez un usage unexpectedly élevé :

Vérifiez le Trafic de Bots : Les requêtes automatisées peuvent gonfler l’usage Révisez les Instructions Système : Les instructions longues augmentent la consommation de jetons Analysez les Modèles Utilisateur : Recherchez des longueurs de conversation inhabituelles Vérifiez la Limitation de Taux : Assurez-vous de la limitation appropriée des requêtes

Analyse d’Usage Faible

Un usage unexpectedly faible pourrait indiquer :

Problèmes de Configuration : Vérifiez si le chatbot est correctement affiché Problèmes d’Expérience Utilisateur : Vérifiez l’accessibilité et le positionnement du chatbot Pertinence du Contenu : Assurez-vous que votre assistant apporte de la valeur aux visiteurs

🚀 Prochaines Étapes

Comprendre votre usage API assure un fonctionnement rentable tout en maximisant la valeur. Continuez vers Gestion de Session pour en apprendre sur les fonctionnalités avancées d’optimisation de jetons, ou explorez Contexte de Page pour comprendre comment l’intégration de contenu affecte la consommation.