Skip to main content

Créer un tableau de bord personnalisé d'utilisation de l'API

Devin dispose d'un tableau de bord d'utilisation intégré, mais si vous avez besoin de métriques personnalisées ou souhaitez combiner les données de Devin avec d'autres sources, demandez à Devin de créer une version sur mesure en utilisant l'API v3.
AuthorCognition
CategoryDonnées et analytique
FeaturesAPI
1

Créer un utilisateur de service pour l’accès à l’API

L’API v3 utilise des jetons d’utilisateur de service, et non des API keys personnelles, pour l’authentification. Vous devez en créer un avant que Devin puisse récupérer des données.
  1. Accédez à app.devin.ai > Settings > Service Users
  2. Cliquez sur Create Service User et assignez-lui un rôle avec les permissions ViewAccountMetrics et ManageBilling — elles sont nécessaires pour lire les métriques de session et les données de consommation
  3. Copiez le jeton d’API affiché après la création — il n’est affiché qu’une seule fois
  4. Stockez le jeton comme un Secret nommé DEVIN_SERVICE_USER_TOKEN afin que Devin puisse l’utiliser pendant la session sans le coder en dur
Pour plus de détails sur l’authentification des utilisateurs de service, consultez le Guide d’authentification de l’API v3.
2

Indiquer à Devin quoi construire

Devin a un accès natif à sa propre documentation via le Devin docs MCP — vous n’avez pas besoin de coller la référence d’API dans le prompt. Pointez simplement Devin vers les bons endpoints et il lira la documentation pour apprendre les formats de requête, les paramètres de requête et la structure des réponses.
3

Ce que Devin construit

Devin lit la documentation de l’API v3 via le docs MCP pour apprendre les formats de requête exacts, puis met en place l’ossature de l’application :
  1. Lit la documentation de l’API — Recherche dans le Devin docs MCP les schémas des endpoints de consommation et de métriques, en apprenant les paramètres de requête comme start_date, end_date, et la structure des réponses
  2. Crée les routes d’API — Construit des routes d’API Next.js qui servent de proxy aux requêtes vers https://api.devin.ai/v3/enterprise/* en utilisant le jeton d’utilisateur de service provenant du secret DEVIN_SERVICE_USER_TOKEN
  3. Construit l’interface du tableau de bord — Crée une page de tableau de bord responsive avec Recharts, comprenant :
    • Des cartes de KPI affichant le nombre total de sessions, les ACUs consommés et les utilisateurs actifs hebdomadaires
    • Un graphique de séries temporelles de la consommation quotidienne provenant de l’endpoint /consumption/daily/organizations
    • Une répartition par utilisateur à partir de /consumption/daily/users
    • Un tableau des sessions à partir de l’endpoint de liste des sessions, avec statut, durée et coût en ACU
  4. Ajoute des filtres — Connecte un sélecteur de plage de dates qui relance toutes les requêtes vers les endpoints avec des paramètres start_date et end_date mis à jour
  5. Ouvre une PR — Pousse l’application avec un README.md couvrant les variables d’environnement, la configuration de développement local (npm run dev) et le déploiement sur Vercel
4

Étendre le tableau de bord

Une fois que le tableau de bord de base fonctionne, demandez à Devin d’ajouter d’autres panneaux dans des messages de suivi :