Skip to main content

Crea un panel de uso personalizado de la API

Devin incluye un panel de uso integrado, pero si necesitas métricas personalizadas o quieres combinar los datos de Devin con otras fuentes, haz que Devin cree una versión a medida usando la API v3.
AuthorCognition
CategoryDatos y analítica
FeaturesAPI
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 > Service Users
  2. Haz clic en Create Service User y asígnale un rol con permisos ViewAccountMetrics y ManageBilling, que son necesarios para leer métricas de sesión y datos de consumo
  3. Copia el token de la API que se muestra después de la creación — 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 start_date, end_date 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/organizations
    • Un desglose por usuario desde /consumption/daily/users
    • 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 start_date y end_date 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: