Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

A configuração declarativa (blueprints) é a nova geração da configuração de ambiente: com controle de versão, modular e atualizada automaticamente. Este guia orienta você na migração a partir do assistente interativo clássico.
A configuração clássica de ambiente está sendo descontinuada. Há duas datas importantes que você precisa conhecer:
  • 30 de junho de 2026: Todas as organizações passarão para a configuração declarativa (blueprints). A partir dessa data, você não poderá iniciar sessões com sua configuração clássica da máquina nem editá-la. Sua configuração clássica não será excluída.
  • 31 de julho de 2026: Sua configuração clássica da máquina continuará disponível como referência somente leitura até essa data, para que você possa consultá-la enquanto conclui a migração. Após 31 de julho, ela será removida.
Faça a migração antes de 30 de junho de 2026 para evitar interrupções. Clientes Enterprise que precisarem de mais tempo devem entrar em contato com a equipe da conta.

​
Por que migrar?

Com o assistente de configuração clássico, o ambiente do Devin é um snapshot configurado manualmente que pode ficar defasado com o tempo. As dependências ficam desatualizadas, alterações de configuração exigem executar o assistente novamente, e não há histórico de versões. A configuração declarativa resolve isso:
  • Atualizações automáticas: os blueprints são reconstruídos quando seu repositório muda, para que as dependências permaneçam atualizadas
  • Controle de versão: a configuração do seu ambiente fica junto com seu código, com histórico completo
  • Combinável: blueprints do Enterprise, da org e do repositório se combinam em camadas de forma organizada
  • Reproduzível: cada build produz o mesmo resultado a partir do mesmo blueprint
  • Sessões mais rápidas: snapshots são pré-construídos com repositórios clonados e dependências instaladas, para que as sessões já comecem prontas para uso
Sua configuração clássica continua funcionando até 30 de junho de 2026 e, depois disso, permanece disponível como uma referência somente leitura para migração até 31 de julho de 2026. Migre antes de 30 de junho de 2026 para evitar interrupções.

​
Antes de começar

Procure um banner na página Configuração da máquina (a página clássica de configuração) com o texto “Mudar para a configuração declarativa do ambiente”. Se ele aparecer, sua organização está qualificada.Se você não vir o banner, a configuração declarativa ainda não foi ativada para sua organização. Ela está sendo liberada gradualmente. Entre em contato com o administrador do Enterprise ou acione o suporte.
A migração exige permissões de administrador da org (ManageOrgSettings). Se você não for um administrador da org, verá a mensagem “Acesso de administrador necessário” na página de migração.
Sim, até 30 de junho de 2026. Seu snapshot atual é preservado, então você pode reverter antes dessa data para fazer sua organização voltar a ele. Após 30 de junho, todas as organizações estarão na configuração declarativa, e você não poderá iniciar sessões pela configuração clássica da máquina, embora ela continue visível como referência somente leitura até 31 de julho de 2026.

​
Etapas da migração

​
1. Acesse a página de migração

Navegue até Configurações > migração de ambiente ou clique em Começar no banner exibido na página de Configuração da máquina.

​
2. Ative a configuração declarativa

Clique em Ativar para a organização. Isso faz com que sua org use snapshots baseados em blueprints nas novas sessões.
Isso não afeta seu snapshot existente. Ele é preservado caso você precise reverter.

​
3. Deixe o Devin gerar seus blueprints

Devin faz o trabalho para você. Clique em Start migration e selecione os repositórios que você quer migrar primeiro. Você não precisa migrar tudo de uma vez. Comece pelos repositórios que você mais usa. Quando você inicia a migração, Devin cria duas sessões:
  • Uma sessão principal em execução no novo ambiente declarativo, que gera os blueprints
  • Uma sessão auxiliar em execução no seu snapshot existente, que Devin usa para inspecionar o que está instalado no momento (versões de linguagem, pacotes do sistema, serviços em execução etc.)
Devin examina seu snapshot existente, identifica quais ferramentas e dependências estão instaladas e gera a configuração de blueprint equivalente. Os resultados aparecem na sua página de Configurações > Ambiente > Blueprints.
Seu snapshot existente é uma “caixa-preta” de tudo o que você configurou ao longo do tempo. Devin inspeciona esse snapshot, cataloga o que está instalado e registra tudo automaticamente em um blueprint reproduzível.

​
4. Revisar e ajustar

Depois que Devin gerar os blueprints:
  1. Vá para Configurações > Ambiente > Blueprints para revisar o que foi gerado
  2. Verifique o status do build. Procure por Success.
  3. Inicie uma sessão de teste para confirmar que tudo funciona:
    • Confirme se os repositórios foram clonados e se as dependências foram instaladas
    • Tente executar seus comandos de lint, teste e build
    • Verifique se as ferramentas ou runtimes personalizados estão disponíveis
Se algo estiver faltando, edite o blueprint diretamente. Você pode adicionar etapas de initialize, comandos de maintenance ou entradas de knowledge.

​
Reversão

Se algo não estiver funcionando, você pode reverter antes de 30 de junho de 2026:
  1. Acesse Configurações > Migração de ambiente
  2. Clique em Reverter para o clássico
  3. Sua organização volta imediatamente a usar o snapshot anterior
Seu snapshot existente é totalmente preservado. Nada é perdido. Você pode tentar a migração novamente quando estiver pronto.
Após 30 de junho de 2026, a reversão não estará mais disponível. Todas as organizações passarão a usar configuração declarativa, e sua configuração clássica da máquina se tornará uma referência somente leitura até 31 de julho de 2026: você não poderá iniciar sessões a partir dela nem reverter para ela. Clientes Enterprise que precisarem de mais tempo devem entrar em contato com a equipe responsável pela conta.

​
Mapeando etapas clássicas de configuração para blueprints

Se você preferir escrever seu blueprint manualmente (ou quiser entender o mapeamento), veja como as etapas do assistente clássico correspondem:
Etapa clássica de configuraçãoEquivalente em blueprintObservações
Git pullAutomáticoOs blueprints fazem git clone e git pull automaticamente
SecretsAba Secrets no editor de blueprintConfigure na aba Secrets em cada editor de blueprint
Instalar dependênciasinitializeConfiguração única: runtimes de linguagem, pacotes do sistema e ferramentas globais
Manter dependênciasmaintenanceComandos de dependência apresentados ao agente no início da sessão: npm install, pip install, etc.
Lintknowledge (name: lint)Apenas para referência, não é executado durante as builds
Testknowledge (name: test)Apenas para referência, não é executado durante as builds
Executar o appknowledge (name: dev-server)Apenas para referência, não é executado durante as builds
Observações adicionaisknowledgeEntradas livres para o Devin

​
Exemplo

Configuração clássica:
  • Instale as dependências: nvm use 20 && npm install
  • Mantenha as dependências atualizadas: npm install
  • Lint: npm run lint
  • Teste: npm test
  • Execute o app: npm run dev
Blueprint equivalente: 
initialize: |
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  source ~/.bashrc
  nvm install 20

maintenance: |
  npm install

knowledge:
  - name: lint
    contents: npm run lint
  - name: test
    contents: npm test
  - name: dev-server
    contents: npm run dev

​
Solução de problemas

Verifique os logs da build para identificar o erro específico. Causas comuns:
  • Um comando que funcionava no terminal de configuração clássico não funciona no contexto da build (por exemplo, prompts interativos que exigem flags -y)
  • Segredos ausentes (verifique se os segredos estão configurados na aba Secrets dentro do editor de blueprint)
  • Compare os comandos do blueprint com os comandos originais para identificar diferenças
Verifique se a seção maintenance inclui os mesmos comandos de instalação de dependências da etapa clássica Maintain Dependencies. Comandos como npm install ou pip install -r requirements.txt devem ficar em maintenance, não em initialize.
Verifique se a seção knowledge contém itens chamados lint e test com os comandos corretos. Devin procura esses nomes ao verificar o próprio trabalho.
Se a configuração clássica modificava ~/.bashrc, ~/.profile ou outra configuração do shell, mova isso para initialize:
initialize: |
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
  echo 'export NODE_ENV=development' >> ~/.bashrc
Blueprints fazem o clone do git automaticamente durante as builds. Se os repositórios não estiverem sendo clonados, verifique se eles foram adicionados na página Configurações > Ambiente > Blueprints e se o Devin tem acesso por meio da sua integração com Git.