Pular para o conteúdo principal
O Devin funciona carregando um snapshot de uma máquina virtual no início de cada sessão. Para que seja o mais eficaz possível, esse snapshot deve incluir todos os repositórios nos quais você quer que o Devin trabalhe, bem como quaisquer ferramentas ou dependências de que ele possa precisar para trabalhar na sua base de código. Assim, o Devin pode se concentrar em escrever código em vez de ter que configurar o ambiente toda vez! Neste guia, veremos como integrar o Devin a um dos seus repositórios e configurar o ambiente do Devin (o snapshot da máquina virtual). Você pode encarar isso como configurar o notebook do Devin para o primeiro dia de trabalho.
Configurar corretamente o ambiente do Devin melhorará significativamente o desempenho dele na sua base de código. Imagine se, toda vez que você começasse uma tarefa, seu notebook e parte da sua memória fossem apagados — é isso que acontece com o Devin com uma configuração incorreta ou incompleta!

​
Adicionar um repositório

Primeiro, certifique-se de que o Devin tenha acesso aos seus repositórios. Repositórios podem ser adicionados a qualquer momento configurando o acesso do Devin em: Agora, dentro de uma organização, acesse a Devin’s Machine e clique em Add repository. Selecione os repositórios que você quer adicionar ao ambiente do Devin e clique em Start para começar a configurá-los.
Devin
A máquina do Devin está executando Ubuntu 22.04 (x86_64). Tente pressionar Ctrl+K no terminal para gerar automaticamente um comando de instalação.

​
Configurar o Repositório e o Ambiente de Desenvolvimento

Ao entrar em Repo Setup, você verá três painéis:
  1. Etapas de Configuração do Repositório: Exibe as 8 etapas de configuração em ordem, junto com os comandos resultantes que serão salvos na sua configuração.
  2. Agente de Configuração Devin AI: Devin pode sugerir o que fazer em cada etapa com base no seu repositório específico e iterar sobre a configuração até que ela esteja pronta para ser salva.
  3. Terminal do VSCode: Permite que você execute quaisquer comandos ou navegue pelo sistema de arquivos diretamente no ambiente do VSCode integrado.

​
Sugestões geradas por IA

Ao adicionar um repositório, Devin gera automaticamente sugestões de configuração para cada etapa, com base na análise da sua base de código. Você pode aceitar ou rejeitar cada sugestão individualmente ou iterar sobre elas com o Devin AI Setup Agent.

​
Etapas de Configuração do Repositório

1

Git Pull

O comando que o Devin executa no início de cada sessão para obter as alterações mais recentes do repositório. Na maioria dos casos, você deve manter o comando padrão. Certifique-se de que o Devin tenha acesso a quaisquer submódulos no repositório.
2

Configurar Segredos

Configure quaisquer segredos ou variáveis de ambiente de que o Devin precise para trabalhar com o seu repositório. Consulte Configuração de segredos para mais detalhes.
3

Instalar Dependências

Comandos para instalar as dependências iniciais do seu repositório. Esses comandos são executados uma única vez durante a configuração para preparar o ambiente do Devin.
4

Manter Dependências

Comandos que o Devin executa após o git pull, durante a inicialização da sessão, caso novas dependências tenham sido adicionadas. Normalmente, isso deve ser o mesmo comando que você usa para instalar dependências (por exemplo, npm install, pip install -r requirements.txt, etc.).
5

Configurar Lint

Comandos que o Devin deve usar para executar o lint ou verificar erros de sintaxe. O Devin analisará a saída desses comandos antes de fazer commit das alterações.
6

Configurar Testes

Comandos que o Devin deve usar para executar testes. Assim como com os comandos de lint, o Devin analisará a saída desses comandos antes de fazer commit das alterações.
7

Executar App Localmente

Informe ao Devin como executar seu código localmente. Isso é útil se o Devin precisar executar seu código para testar ou depurar alterações. Você pode usar o navegador do Devin para fazer login nos sites que deseja que o Devin use. Adicione credenciais de login a secrets se a sessão de login expirar.
8

Observações Adicionais

Adicione quaisquer instruções adicionais para o Devin ao trabalhar neste repositório.

​
Concluir ou Salvar Configuração

Quando estiver satisfeito com a configuração, clique em Finish Setup para salvar a configuração. Isso vai reproduzir todos os comandos das etapas de configuração para preparar o ambiente do Devin. Se você ainda não terminou suas alterações, clique em Finish Later para salvar a configuração. Isso manterá a configuração em andamento e permitirá que você volte a ela depois. No entanto, observe que apenas uma configuração pode estar em andamento por vez, então não recomendamos usar essa opção a menos que seja absolutamente necessário.
Dicas para configurar comandos:
  • Execute primeiro os comandos no terminal do VS Code para aproveitar o cache antes de verificar.
  • Se um comando precisar ser executado em um diretório específico, use cd da seguinte forma: cd <directory> && <command>.
  • Se o seu projeto não tiver um comando de lint, você pode incluir o comando de build para que o Devin verifique erros de compilação.
  • Se o procedimento de lint ou de testes do seu projeto for complexo, você pode pular essas etapas e explicá-las ao Devin na etapa Additional Notes.
  • Consulte a seção de solução de problemas se encontrar problemas ao verificar seus comandos.

​
Configurar repositórios adicionados anteriormente

Você pode editar ou adicionar um novo repositório a qualquer momento em Settings > Devin’s Machine. Para editar um repositório existente, clique em Configure no canto superior direito da página, em Add/Modify/Remove repo, selecione o repositório que você quer editar e clique em submit.
Devin
Como alternativa, você pode selecionar, na lista, o repositório existente que deseja editar e clicar em Modify repo setup para editar as etapas de configuração.
Devin

​
Histórico de versões da máquina

Se, durante a configuração, você acidentalmente fizer uma alteração incompatível, poderá reverter para um snapshot anterior do ambiente. Vá para Settings > Devin’s Machine, mude para a aba Version History e restaure um snapshot anterior que você sabe que estava funcionando corretamente.
Devin

​
Configurando segredos

Segredos como chaves de API, senhas e tokens podem ser adicionados no painel de secrets. Sempre que possível, recomendamos usar um arquivo .env no ambiente do Devin com direnv para gerenciar automaticamente as variáveis de ambiente. Consulte o exemplo de configuração de variáveis de ambiente abaixo para obter mais detalhes.

​
Exemplos

Abaixo estão alguns exemplos de como configurar o ambiente do Devin para diferentes casos de uso. Como o Devin executa todos os comandos usando bash, uma prática comum é editar o arquivo ~/.bashrc para configurar automaticamente o shell do Devin. Você pode executar devin ~/.bashrc no terminal para editar o arquivo no VS Code.

​
Configurando ambientes automaticamente para diferentes repositórios

Após 24 de abril de 2025, as equipes que se inscreverem no Devin devem ver a seção custom_cd já presente no arquivo ~/.bashrc. Você só precisará atualizar essa seção para os seus próprios repositórios.
Suponha que você tenha dois repositórios que exijam versões diferentes do Node e queira que o Devin use automaticamente a versão correta para cada repositório. Usaremos o nvm para instalar e gerenciar as versões do Node. O nvm já deve estar instalado na máquina do Devin. Primeiro, vamos instalar as duas versões do Node executando os seguintes comandos no terminal do VS Code: 
nvm install 18
nvm install 20
Em seguida, abra o arquivo ~/.bashrc executando devin ~/.bashrc no terminal. Adicione o seguinte ao arquivo ~/.bashrc. 
function custom_cd() {
  builtin cd "$@"

  if [[ "$PWD" == "$HOME/repos/node18"* ]]; then
    nvm use 18 >/dev/null 2>&1
  elif [[ "$PWD" == "$HOME/repos/node20"* ]]; then
    nvm use 20 >/dev/null 2>&1
  fi
}

alias cd='custom_cd'
cd $PWD
Isso executará nvm use 18 sempre que Devin estiver no repositório node18 e nvm use 20 sempre que Devin estiver no repositório node20.

​
Configurando variáveis de ambiente

direnv já vem pré-instalado na máquina do Devin e pode ser usado para gerenciar variáveis de ambiente por repositório. O hook do direnv já está configurado em ~/.bashrc. Para configurar variáveis de ambiente para um repositório, crie um arquivo .envrc na raiz do repositório. Por exemplo: 
export ENV_VAR=1
export ANOTHER_ENV_VAR=2
Por fim, vamos executar direnv allow no terminal para carregar as variáveis de ambiente. Agora o Devin terá as variáveis de ambiente do nosso arquivo .envrc adicionadas ao seu ambiente ao trabalhar em nosso repositório em sessões futuras.
Recomendamos adicionar .envrc ao seu arquivo .gitignore para que o Devin não faça commit desse arquivo acidentalmente no repositório.

​
Adicionando diretórios ao PATH do sistema

Podemos editar ~/.bashrc para adicionar diretórios ao PATH do sistema. Isso facilitará para o Devin executar os executáveis nesses diretórios. Por exemplo, podemos acrescentar o seguinte ao ~/.bashrc, o que adicionará o diretório ~/bin ao PATH do sistema. 
export PATH="$HOME/bin:$PATH"
Agora, Devin poderá executar os arquivos executáveis no diretório ~/bin sem precisar especificar o caminho completo.

​
Fazendo login em sites

Durante a configuração do ambiente, você pode usar a guia Browser para fazer login em qualquer site com o qual queira que o Devin interaja. Esses cookies de sessão serão armazenados no ambiente do Devin e estarão disponíveis para o Devin em sessões futuras. Se você estiver usando um site que encerra sua sessão com frequência, também é recomendável configurar credenciais para o Devin no seu painel de Secrets.

​
Resolução de problemas

​
Por que meus comandos não estão sendo verificados?

Se você encontrar um erro ao verificar um dos comandos, tente inspecionar a saída dele e também tente executar o comando você mesmo em um novo terminal.
  1. Verifique o caminho do executável que você está executando. Recomendamos fortemente usar caminhos absolutos ou adicionar executáveis ao PATH do sistema.
  2. Certifique-se de que você instalou as ferramentas e dependências necessárias para executar o comando. Se ainda não tiver feito isso, use o Setup Agent ou o terminal do VS Code para instalá-las e tente verificar novamente.
  3. Verifique se os comandos estão sendo executados no diretório correto. Se os comandos precisarem ser executados em um diretório específico, você pode usar cd desta forma: cd <directory> && <command>.
  4. Verifique se você está usando as versões corretas das linguagens de programação (por exemplo, versões corretas de Node, Python, etc.).
  5. Talvez você queira modificar seu ~/.bashrc para usar automaticamente o ambiente correto. Consulte nosso guia para ver um exemplo de como usar a versão correta da linguagem para repositórios diferentes.

​
Meus comandos funcionam quando eu os executo manualmente

Verifique se você configurou seu .bashrc para que um novo shell Bash tenha acesso às ferramentas necessárias. Tente executar seus comandos em um novo terminal. Se eles não funcionarem, você provavelmente precisará editar seu .bashrc, por exemplo, executando certos comandos de configuração ou ajustando o PATH do sistema. Confira nosso guia para um exemplo de como usar a versão correta da linguagem para diferentes repositórios. Os comandos expiram (timeout) após 5 minutos. Você pode aquecer o cache executando os comandos no terminal do VS Code antes de verificar. Não recomendamos passar ao Devin comandos que demorem mais de 5 minutos para executar, pois isso o deixará significativamente mais lento.

​
Devin não consegue executar meus comandos de lint/test em sessões

Verifique a saída do terminal do Devin para ver se você consegue identificar algum erro. Você também pode tentar executar os comandos em um novo terminal para verificar se eles funcionam. Se necessário, você pode refazer o processo de configuração do repositório para fazer alterações no ambiente do Devin.

​
A etapa de git pull não está funcionando

Confira se o Devin tem acesso ao repositório e aos submódulos do repositório. Consulte também a documentação da integração com o GitHub caso encontre algum problema de permissão.

​
Tudo pronto!

Parabéns! Você concluiu a configuração do Devin e já pode começar a construir juntos. É hora de iniciar sua primeira sessão. Lembre-se de que o Devin funciona melhor quando você:
  • Diz ao Devin como verificar seu progresso
  • Divide tarefas grandes em partes menores
  • Compartilha requisitos detalhados desde o início
  • Executa várias sessões em paralelo
Se precisar de suporte, não hesite em nos enviar um e-mail para support@cognition.ai.