Skip to main content
¿No quieres configurarlo manualmente? Pega un enlace a esta página en una sesión de Devin y pídele que lo configure todo por ti.
1

Crear un usuario de servicio para el acceso a la API

La API v3 se autentica con tokens de usuario de servicio, no con API keys personales. Necesitarás crear uno antes de que Devin pueda extraer datos.
  1. Ve a app.devin.ai > Settings de Enterprise > Devin API y abre la pestaña Service users
  2. Haz clic en Provision > Enterprise service user y asígnale un rol de enterprise con los permisos ViewAccountMetrics, ViewAccountConsumption, ViewAccountSessions y ViewAccountMembership, que son necesarios para leer los endpoints de métricas, consumo, sesiones y usuarios de enterprise. Añade ViewOrganizations si también quieres el filtro de organización descrito a continuación
  3. Copia el token de la API que se muestra después del provisioning — solo se muestra una vez
  4. Almacena el token como un Secret llamado DEVIN_SERVICE_USER_TOKEN para que Devin pueda usarlo durante la sesión sin incluirlo directamente en el código
Para más detalles sobre la autenticación de usuarios de servicio, consulta la Guía de autenticación de la API v3.
2

Indica a Devin qué debe construir

Devin tiene acceso nativo a su propia documentación a través de Devin docs MCP; no necesitas pegar la referencia de la API en el prompt. Solo apunta a Devin a los endpoints correctos y leerá la documentación para aprender los formatos de las solicitudes, los parámetros de consulta y las estructuras de las respuestas.
3

Qué construye Devin

Devin lee la documentación de la API v3 a través de docs MCP para aprender los formatos exactos de las solicitudes y luego crea el esqueleto de la aplicación:
  1. Lee la documentación de la API — Busca en Devin docs MCP los esquemas de los endpoints de consumo y métricas, aprendiendo parámetros de consulta como time_after y time_before (marcas de tiempo Unix) y las estructuras de las respuestas
  2. Crea rutas de API — Construye rutas de API de Next.js que actúan como proxy de las solicitudes a https://api.devin.ai/v3/enterprise/* usando el token de usuario de servicio del secreto DEVIN_SERVICE_USER_TOKEN
  3. Construye la interfaz del panel — Crea una página de panel responsiva con Recharts, que incluye:
    • Tarjetas de KPI que muestran sesiones totales, ACUs consumidos y usuarios activos semanales
    • Un gráfico de series temporales del consumo diario obtenido del endpoint /consumption/daily
    • Un desglose por usuario que se obtiene paginando /members/users y /members/idp-users, eliminando duplicados por user_id, llamando a /consumption/daily/users/{user_id} para cada uno y sumando los totales
    • Una tabla de sesiones del endpoint de lista de sesiones con estado, duración y costo de ACU
  4. Añade filtrado — Conecta un selector de rango de fechas que vuelve a consultar todos los endpoints con parámetros de rango de tiempo actualizados
  5. Abre un PR — Envía la aplicación con un README.md que cubre variables de entorno, configuración de desarrollo local (npm run dev) y despliegue en Vercel
4

Amplía el panel

Una vez que el panel base esté funcionando, pide a Devin que añada más paneles en mensajes de seguimiento: