> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuração do ambiente do Devin

> Configure o ambiente do Devin para que as sessões comecem com repositórios, ferramentas, dependências, variáveis de ambiente e segredos prontos.

<h2 id="what-is-devins-environment">
  O que é o ambiente do Devin?
</h2>

O ambiente do Devin é o workspace em que o Devin opera: uma máquina virtual baseada em Linux com seus repositórios clonados, ferramentas instaladas, dependências resolvidas, variáveis de ambiente definidas e configurações aplicadas. É o equivalente ao notebook de um desenvolvedor: o sistema operacional, o terminal, a toolchain instalada, os repositórios clonados e as credenciais e configurações de que essas ferramentas precisam.

A configuração do seu ambiente é salva como um **snapshot**: uma imagem congelada e inicializável a partir da qual cada sessão é iniciada. Configure-o uma vez, e toda sessão será iniciada nesse estado conhecido e confiável.

<h2 id="why-environment-configuration-matters">
  Por que a configuração do ambiente é importante
</h2>

O Devin funciona da mesma forma que qualquer desenvolvedor: clona repositórios, instala dependências, executa lint, compila código e roda testes. Para fazer qualquer uma dessas coisas, ele precisa de um ambiente funcional. Sem isso, o Devin não consegue fazer o build do seu projeto, não consegue rodar seus testes e não consegue verificar o próprio trabalho. Seria como contratar um desenvolvedor e não dar a ele um laptop.

A configuração do ambiente dá ao Devin as ferramentas, runtimes, credenciais, variáveis de ambiente e o conhecimento do projeto de que ele precisa para ser produtivo desde a primeira sessão. Ela também torna as sessões mais rápidas: seu snapshot já tem repositórios clonados e dependências instaladas, então o Devin entra direto em trabalho produtivo, em vez de configurar tudo do zero toda vez.

**Esta é, de longe, a ação de maior impacto que você pode tomar para melhorar a eficácia do Devin na sua base de código.** Para um passo a passo em vídeo, veja o [tutorial de configuração do repositório](/pt-BR/tutorial-library/repo-setup).

<h2 id="how-sessions-work">
  Como as sessões funcionam
</h2>

Toda sessão é iniciada a partir de um **snapshot**, uma imagem congelada e inicializável do ambiente.

1. **Snapshot**: Uma imagem pré-criada que contém seus repositórios, ferramentas e dependências. É preparada antecipadamente por meio da configuração.
2. **Sessão**: O Devin inicia uma nova cópia do snapshot. Toda sessão começa no mesmo estado limpo. As alterações feitas na sessão não são persistidas no snapshot.

Quando sua configuração muda, um novo snapshot é criado automaticamente. Cada organização tem um snapshot ativo por plataforma: Linux por padrão, além de [Windows](/pt-BR/onboard-devin/environment/windows-support) ou [macOS](/pt-BR/onboard-devin/environment/macos-support), caso você os configure. Toda sessão em uma plataforma é iniciada a partir do snapshot dessa plataforma.

<h2 id="before-you-start">
  Antes de começar
</h2>

Antes de configurar o ambiente do Devin, verifique se ele pode acessar seus repositórios:

<AccordionGroup>
  <Accordion title="Usuários não Enterprise">
    1. **Conecte seu provedor de SCM.** Vá para **Configurações > Conexões** e conecte GitHub, GitLab, Bitbucket ou Azure DevOps. Selecione quais repositórios o Devin poderá acessar durante a configuração. Consulte os [guias de integração](/pt-BR/integrations/overview) para instruções detalhadas.

    É isso. Depois de conectar, você pode prosseguir para a configuração do ambiente.
  </Accordion>

  <Accordion title="Usuários Enterprise">
    1. **Conecte seu provedor de SCM (administrador Enterprise).** Vá para **Configurações > Conexões** e conecte seu provedor de SCM. Consulte [Git Integrations](/pt-BR/enterprise/integrations/git-integrations) para ver as instruções de configuração.
    2. **Conceda a cada org acesso aos seus repositórios (administrador Enterprise).** Vá para **Configurações > Repositórios** e atribua repositórios a cada organização. As orgs não podem ver nem usar repositórios até que você conceda esse acesso explicitamente. Consulte [Repository Permissions](/pt-BR/enterprise/integrations/git-integrations#repository-permissions).
    3. **Configure o ambiente (administrador da org).** Quando uma org tiver acesso aos repositórios, prossiga para a configuração do ambiente abaixo.
  </Accordion>
</AccordionGroup>

<Warning>Se você pular essas etapas, os repositórios não aparecerão quando você tentar adicioná-los ao seu ambiente. O Devin precisa de acesso aos repositórios por meio da sua integração com Git antes de poder clonar e fazer o build.</Warning>

<h2 id="set-it-up-by-asking-devin">
  Configure pedindo ao Devin
</h2>

Esta é a maneira mais simples de configurar o ambiente do Devin e funciona para a maioria dos repositórios.

<iframe width="840" height="473" src="https://www.youtube.com/embed/lAJL8ycNSKQ" title="Configure o ambiente do agente de nuvem do Devin com um único prompt" className="max-w-full" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />

Inicie uma sessão do Devin e peça:

*"Configure seu ambiente para este repo."*

<Steps>
  <Step title="Devin explora seu repositório">
    Devin inspeciona sua base de código e identifica as ferramentas, os runtimes e as dependências necessários.
  </Step>

  <Step title="Revise as sugestões">
    Devin propõe um blueprint em cartões de sugestão na linha do tempo. Revise a configuração proposta e aprove os cartões que quiser usar.
  </Step>

  <Step title="Um build cria o snapshot">
    Devin executa um build com base no blueprint aprovado e gera o snapshot do qual todas as sessões são inicializadas.
  </Step>
</Steps>

Para ver o passo a passo completo, consulte [Deixe o Devin fazer isso](/pt-BR/onboard-devin/environment/blueprints#getting-started).

<h2 id="environment-variables-and-secrets">
  Variáveis de ambiente e segredos
</h2>

As variáveis de ambiente fazem parte do seu blueprint. Defina valores não sensíveis no campo `env` de uma etapa ou grave valores compartilhados em `$ENVRC`; consulte os [templates de ambiente](/pt-BR/onboard-devin/environment/templates) para ver os padrões de `$ENVRC` e direnv. O Devin pode inferir ferramentas e dependências do seu repositório, mas não consegue descobrir suas credenciais.

Armazene valores sensíveis como [Segredos](/pt-BR/product-guides/secrets) criptografados na aba **Segredos** do editor de blueprint e faça referência a eles como `$VARIABLE_NAME`. Os segredos são injetados como variáveis de ambiente durante builds e sessões; consulte o [guia de segredos de blueprint](/pt-BR/onboard-devin/environment/blueprints#secrets) e a [referência de variáveis de ambiente e segredos](/pt-BR/onboard-devin/environment/blueprint-reference#environment-variables-and-secrets).

<h2 id="choose-your-approach">
  Escolha sua abordagem
</h2>

Pedir ao Devin é o padrão. Se quiser criar a configuração por conta própria, use a [configuração declarativa](/pt-BR/onboard-devin/environment/blueprints), o caminho manual recomendado. Blueprints descrevem seu ambiente, e as builds geram snapshots automaticamente.

<Card title="Configuração declarativa" icon="file-code" href="/pt-BR/onboard-devin/environment/blueprints">
  **Caminho manual recomendado.** Revise ou edite o YAML que o Devin gera para controlar o que é instalado, como as dependências são configuradas e o que o Devin deve saber.

  * Com controle de versão
  * Atualização automática
  * Componível entre camadas
  * Reproduzível
</Card>

<h2 id="related-pages">
  Páginas relacionadas
</h2>

<CardGroup cols={2}>
  <Card title="Referência de blueprints" icon="book" href="/pt-BR/onboard-devin/environment/blueprint-reference">
    Especificação completa dos campos de blueprints: seções, suporte a GitHub Actions, variáveis de ambiente e anexos de arquivos.
  </Card>

  <Card title="Biblioteca de templates" icon="copy" href="/pt-BR/onboard-devin/environment/templates">
    Blueprints prontos para copiar e colar para Python, Node.js, Go, Java, Ruby, Rust e padrões avançados.
  </Card>

  <Card title="Gerenciamento de ambientes Enterprise" icon="building" href="/pt-BR/enterprise/environment-management/overview">
    Gerenciamento de ambientes em toda a Enterprise: hierarquia de 3 níveis, segredos e configuração entre orgs.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.