Skip to main content
Não quer configurar isso manualmente? Cole um link para esta página em uma sessão do Devin e peça que ele configure tudo para você.
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 > Enterprise settings > Devin API e abra a aba Service users
  2. Clique em Provision > Enterprise service user e atribua a ele uma função de enterprise com as permissões ViewAccountMetrics, ViewAccountConsumption, ViewAccountSessions e ViewAccountMembership — elas são necessárias para ler os endpoints de métricas, consumo, sessões e usuários do enterprise. Adicione ViewOrganizations se você também quiser o filtro de organização descrito abaixo
  3. Copie o token de API mostrado após o provisionamento — 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 time_after e time_before (timestamps Unix) 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
    • Uma visão por usuário montada percorrendo as páginas de /members/users e /members/idp-users, removendo duplicatas por user_id, chamando /consumption/daily/users/{user_id} para cada um e agregando os totais
    • 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 de intervalo de tempo 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: