Introduction #
L’Explorateur Agents IA est l’interface d’administration permettant de superviser l’activité des agents IA dans Kafinea. Il offre une vue consolidée des exécutions (runs), des statistiques d’utilisation et des coûts associés.
Cette page est réservée aux administrateurs et aux administrateurs restreints.
1. Accès #
Accédez à l’explorateur via Paramètres > Extensions > Explorateur Agents IA.
2. Dashboard de statistiques #
Le haut de la page affiche un tableau de bord synthétique avec :
- Nombre total de runs : nombre d’exécutions d’agents IA
- Coût estimé : coût total estimé en fonction des tokens consommés
- Tokens utilisés : répartition entre tokens de prompt (entrée) et tokens de complétion (sortie)
- Statistiques par période : ventilation mensuelle ou hebdomadaire
3. Liste des exécutions #
La liste paginée affiche chaque exécution d’agent IA avec les informations suivantes :
| Colonne | Description |
|---|---|
| Run ID | Identifiant unique de l’exécution |
| Agent | Nom de l’agent ayant effectué l’exécution |
| Modèle | Modèle IA utilisé (ex : gpt-4, claude-3, etc.) |
| Utilisateur | L’utilisateur Kafinea ayant déclenché l’exécution |
| Statut | État de l’exécution : running, completed, failed |
| Tokens | Nombre de tokens de prompt / complétion / total |
| Coût | Coût estimé de l’exécution |
| Durée | Temps d’exécution |
| Date | Date et heure de lancement |
4. Filtres #
Vous pouvez filtrer la liste des exécutions par :
- Statut : running, completed, failed
- Agent : nom de l’agent
- Modèle : modèle IA utilisé
- Utilisateur : utilisateur ayant déclenché l’exécution
5. Détail d’une exécution #
En cliquant sur une exécution, vous accédez au détail qui comprend :
- Le résumé de l’entrée (prompt envoyé)
- La liste des événements (étapes intermédiaires de l’agent)
- La réponse générée
- Les métriques détaillées (tokens, coût, durée)
6. Outils disponibles pour les agents #
Les agents IA disposent d’un ensemble d’outils leur permettant d’interagir avec les données de Kafinea :
- Recherche : rechercher des enregistrements dans les modules
- Lecture : consulter le détail d’un enregistrement
- Navigation : parcourir les relations entre enregistrements
- Analyse : calculer des agrégats ou des statistiques
- Création : créer de nouveaux enregistrements (nécessite le toggle Beta)
- Modification : mettre à jour des enregistrements existants (nécessite le toggle Beta)
- Suppression : supprimer des enregistrements (nécessite le toggle Beta)
Note : Les agents respectent les droits d’accès de l’utilisateur qui déclenche l’exécution. Les outils de création, modification et suppression ne sont disponibles que si l’option (Beta) Autoriser l’Agent IA à modifier les données est activée dans Paramètres > Fonctionnalités.
7. Configuration #
La configuration des agents IA est gérée dans les fichiers de configuration de Kafinea :
- Clé API : configurée dans les paramètres de la passerelle IA
- Feature flags : activation/désactivation des fonctionnalités IA
- Modèles disponibles : liste des modèles IA utilisables
Important : La modification de ces paramètres nécessite un accès au serveur.
FAQ #
Comment voir combien coûte l’utilisation de l’IA ?
Le dashboard de l’explorateur affiche le coût estimé par exécution et le coût total. Ces estimations sont basées sur le nombre de tokens consommés.
Un agent peut-il modifier des données ?
Les agents de type workflow (VTMdsPromptAITask) peuvent mettre à jour les champs configurés dans le mapping. Le chat IA peut créer, modifier et supprimer des enregistrements uniquement si l’option (Beta) Autoriser l’Agent IA à modifier les données est activée dans Paramètres > Fonctionnalités. Lorsque cette option est désactivée, le chat IA fonctionne en lecture seule.