Que fait agentlens ?
Observabilité locale pour les sessions d'agents IA — lit les traces OTEL et les fichiers journaux locaux de Copilot, Claude Code et Codex. Utilisation de jetons, coûts, résumés et informations sur l'efficacité. Extension VS Code, npx et Docker.
📦 Installation
# Avec npx (recommandé pour une utilisation ponctuelle)
npx agentlens
# Avec Docker
docker run -v $(pwd):/app -it rogerreed/agentlens
# Extension VS Code
# Recherchez "AgentLens" dans le Marketplace des extensions VS Code
🚀 Utilisation
Via npx
npx agentlens scan ./chemin/vers/logs
Via Docker
docker run -v $(pwd):/app -it rogerreed/agentlens scan /app/logs
Via l'extension VS Code
- Ouvrez la palette de commandes (
Cmd+Shift+PouCtrl+Shift+P) - Exécutez
AgentLens: Analyser les logs - Sélectionnez le dossier contenant vos logs
🔧 Configuration
AgentLens peut être configuré via des variables d'environnement ou un fichier agentlens.config.js à la racine.
| Variable | Description | Valeur par défaut |
|---|---|---|
AGENTLENS_LOG_DIR | Chemin vers le dossier de logs | ./logs |
AGENTLENS_OTEL | Chemin vers les traces OTEL | ./otel-traces |
AGENTLENS_FORMAT | Format de sortie (table/json/html) | table |
📊 Fonctionnalités
- Analyse des traces OTEL : Lit et interprète les traces OpenTelemetry générées par les sessions d'agents.
- Lecture des logs locaux : Supporte les formats de logs de Copilot, Claude Code et Codex.
- Calcul des coûts : Estime le coût des appels API basé sur les modèles utilisés.
- Résumé des sessions : Génère un résumé textuel de chaque session d'agent.
- Informations d'efficacité : Met en évidence les appels redondants ou inefficaces.
- Export HTML : Génère un rapport HTML consultable pour le partage.
🤝 Contribution
Les contributions sont les bienvenues ! Consultez le dépôt GitHub pour plus de détails.
📄 Licence
MIT