Skip to main content

Criar um dashboard personalizado de uso da API

Devin possui um dashboard de uso integrado, mas, se você precisar de métricas personalizadas ou quiser combinar dados do Devin com outras fontes, peça ao Devin para criar uma versão sob medida usando a API v3.
AuthorCognition
CategoryDados e Análises
FeaturesAPI
1

Criar um usuário de serviço para acesso à API

A API v3 faz autenticação usando tokens de usuário de serviço, não chaves de API pessoais. Você precisará criar um antes que o Devin possa obter dados.
  1. Vá para app.devin.ai > Settings > Service Users
  2. Clique em Create Service User e atribua a ele uma função com permissões ViewAccountMetrics e ManageBilling — elas são necessárias para ler métricas de sessão e dados de consumo
  3. Copie o token de API mostrado após a criação — ele é exibido apenas uma vez
  4. Armazene o token como um Secret chamado DEVIN_SERVICE_USER_TOKEN para que o Devin possa usá-lo durante a sessão sem precisar colocá-lo diretamente no código
Para detalhes sobre autenticação de usuário de serviço, consulte o Guia de Autenticação da API v3.
2

Informar ao Devin o que construir

O Devin tem acesso nativo à própria documentação por meio do Devin docs MCP — você não precisa colar a referência da API no prompt. Basta apontar o Devin para os endpoints corretos e ele lerá a documentação para aprender formatos de requisição, parâmetros de consulta e formatos de resposta.
3

O que o Devin constrói

O Devin lê a documentação da API v3 via docs MCP para aprender os formatos exatos de requisição e então cria o esqueleto do app:
  1. Lê a documentação da API — Pesquisa no Devin docs MCP pelos esquemas dos endpoints de consumo e métricas, aprendendo parâmetros de consulta como start_date, end_date e formatos de resposta
  2. Cria rotas de API — Constrói rotas de API do Next.js que fazem proxy das requisições para https://api.devin.ai/v3/enterprise/* usando o token do usuário de serviço armazenado no secret DEVIN_SERVICE_USER_TOKEN
  3. Constrói a interface do dashboard — Cria uma página de dashboard responsiva com Recharts, incluindo:
    • Cartões de KPI mostrando total de sessões, ACUs consumidos e usuários ativos na semana
    • Um gráfico de série temporal do consumo diário obtido do endpoint /consumption/daily/organizations
    • Uma visão por usuário a partir de /consumption/daily/users
    • Uma tabela de sessões a partir do endpoint de lista de sessões com status, duração e custo em ACU
  4. Adiciona filtragem — Conecta um seletor de intervalo de datas que refaz as requisições para todos os endpoints com parâmetros start_date e end_date atualizados
  5. Abre um PR — Envia o app (push) com um README.md cobrindo variáveis de ambiente, configuração de desenvolvimento local (npm run dev) e implantação na Vercel
4

Ampliar o dashboard

Depois que o dashboard básico estiver funcionando, peça ao Devin para adicionar mais painéis em mensagens de acompanhamento: