Skip to main content
Non vuoi configurarlo manualmente? Incolla un collegamento a questa pagina in una sessione di Devin e chiedigli di impostare tutto per te.
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 > Enterprise settings > Devin API e apri la tab Service users
  2. Fai clic su Provision > Enterprise service user e assegnagli un enterprise role con le autorizzazioni ViewAccountMetrics, ViewAccountConsumption, ViewAccountSessions e ViewAccountMembership — sono necessarie per leggere gli endpoint enterprise di metriche, consumo, sessioni e utenti. Aggiungi ViewOrganizations se vuoi anche il filtro per organizzazione descritto di seguito
  3. Copia il token API mostrato dopo il provisioning — 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 time_after e time_before (timestamp Unix) 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
    • Una suddivisione per utente ottenuta scorrendo le pagine di /members/users e /members/idp-users, eliminando i duplicati in base a user_id, chiamando /consumption/daily/users/{user_id} per ciascun utente e aggregando i totali
    • 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 di intervallo temporale 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: