Skip to main content
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: