Skip to main content

Crea una dashboard personalizzata per l'utilizzo dell'API

Devin include una dashboard di utilizzo integrata, ma se ti servono metriche personalizzate o vuoi combinare i dati di Devin con altre fonti, fai creare a Devin una versione su misura usando l’API v3.
AuthorCognition
CategoryDati e analisi
FeaturesAPI
1

Crea un service user per l'accesso all'API

L’API v3 esegue l’autenticazione con token di service user, non con API key personali. Devi crearne uno prima che Devin possa recuperare i dati.
  1. Vai su app.devin.ai > Settings > Service Users
  2. Fai clic su Create Service User e assegnagli un ruolo con i permessi ViewAccountMetrics e ManageBilling — sono necessari per leggere le metriche di sessione e i dati di consumo
  3. Copia il token API mostrato dopo la creazione — viene visualizzato solo una volta
  4. Salva il token come Secret chiamato DEVIN_SERVICE_USER_TOKEN in modo che Devin possa usarlo durante la sessione senza doverlo inserire nel codice
Per i dettagli sull’autenticazione con service user, vedi la v3 API Authentication Guide.
2

Indica a Devin cosa costruire

Devin ha accesso nativo alla propria documentazione tramite il Devin docs MCP — non è necessario incollare il riferimento API nel prompt. È sufficiente indirizzare Devin agli endpoint corretti e leggerà la documentazione per apprendere i formati delle richieste, i parametri di query e le strutture delle risposte.
3

Cosa costruisce Devin

Devin legge la documentazione dell’API v3 tramite il docs MCP per apprendere i formati esatti delle richieste, quindi crea lo scheletro dell’app:
  1. Legge la documentazione dell’API — Cerca nel Devin docs MCP gli schemi degli endpoint di consumo e metriche, apprendendo parametri di query come start_date, end_date e le strutture delle risposte
  2. Crea le route API — Costruisce route API Next.js che fanno da proxy alle richieste verso https://api.devin.ai/v3/enterprise/* usando il token del service user dal secret DEVIN_SERVICE_USER_TOKEN
  3. Costruisce la UI della dashboard — Crea una pagina di dashboard responsive con Recharts, includendo:
    • Schede KPI che mostrano sessioni totali, ACU consumati e utenti attivi settimanali
    • Un grafico a serie temporale del consumo giornaliero recuperato dall’endpoint /consumption/daily/organizations
    • Una suddivisione per utente da /consumption/daily/users
    • Una tabella delle sessioni dall’endpoint di elenco delle sessioni con stato, durata e costo in ACU
  4. Aggiunge filtri — Collega un selettore di intervallo di date che riesegue le richieste a tutti gli endpoint con parametri start_date e end_date aggiornati
  5. Apre una PR — Effettua il push dell’app con un README.md che copre variabili d’ambiente, setup di sviluppo locale (npm run dev) e deployment su Vercel
4

Estendi la dashboard

Quando la dashboard di base è funzionante, chiedi a Devin di aggiungere altri pannelli in messaggi successivi: