> ## 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.

# Agente Local do Devin

> Use a mesma infraestrutura de agente do Devin CLI diretamente no Devin Desktop.

Devin Local é nossa infraestrutura de agente de próxima geração, compartilhada com o [Devin CLI](https://cli.devin.ai).

Ele é executado na sua máquina, com acesso aos seus arquivos, ferramentas e ambiente locais, e foi projetado para eventualmente substituir o Cascade como o principal agente local.

<Note>
  No momento, o Devin Local está em prévia e tem algumas [limitações](#limitations) em comparação com o Cascade. O Devin Local não é compatível com o plugin JetBrains para Devin Desktop.
</Note>

<div id="key-improvements">
  ## Principais melhorias
</div>

Desde o lançamento do Cascade, as capacidades dos modelos evoluíram significativamente. O Devin Local foi desenvolvido do zero para aproveitar esses avanços com eficiência.

<div id="token-efficiency">
  ### Eficiência de tokens
</div>

O agente local do Devin é significativamente mais eficiente em termos de tokens, com maior foco no cache de prompts. A maioria das tarefas usa até 30% menos tokens do que o Cascade para alcançar o mesmo resultado.

<div id="subagents">
  ### Subagentes
</div>

O agente local do Devin pode criar [subagentes](https://cli.devin.ai/docs/subagents) independentes para lidar com subtarefas — em primeiro ou em segundo plano. Os subagentes compartilham ferramentas e o contexto da codebase com o agente principal, mas operam em seu próprio fluxo de conversa.

<div id="sandboxing">
  ### Sandboxing
</div>

O agente local do Devin oferece suporte a sandbox em nível de sistema operacional. Quando ativado, o sandbox aplica:

* **Isolamento do sistema de arquivos** — os caminhos com permissão de leitura e escrita são definidos com base nos seus escopos de permissão
* **Filtragem de rede** — listas de permissões e listas de bloqueio de domínios controlam o que o agente pode acessar

Admins do Enterprise podem impor o comportamento do sandbox em toda a organização por meio das [Configurações da equipe](https://cli.devin.ai/docs/enterprise/team-settings#sandbox-enforcement), incluindo exigir o modo sandbox para todos os usuários e configurar regras de filtragem de domínios em toda a organização.

<div id="quick-review">
  ### Revisão rápida
</div>

[Revisão rápida](/pt-BR/desktop/quick-review) é um subagente dedicado disponível no agente local do Devin para obter feedback rápido sobre alterações.

<div id="switching-your-agent">
  ## Mudando seu agente
</div>

Na maioria dos casos, você pode mudar para o agente `Devin Local` ao iniciar *novas* conversas usando o seletor de agentes no canto inferior direito do Devin Desktop.

<Frame>
  <img src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/devin-local-agent-switcher.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=5206df1ec64b71ae0463d56f7453aff3" width="844" height="252" data-path="desktop/assets/windsurf/devin-local-agent-switcher.png" />
</Frame>

<div id="agent-settings">
  ### Configurações do agente
</div>

Se o Devin Local não aparecer no seletor de agentes, talvez seja necessário ativá-lo nas `Devin Settings`:

1. Abra a Paleta de Comandos com `Cmd+Shift+P` (macOS) ou `Ctrl+Shift+P` (Windows/Linux)
2. Abra `Devin User Settings`
3. Clique na aba "Agents"
4. Ative o agente "Devin Local"
5. Reinicie o Devin Desktop

<Frame>
  <img src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/devin-local-agent-settings.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=b0f42c5d3d679c55c450fd9067c34303" width="1200" height="200" data-path="desktop/assets/windsurf/devin-local-agent-settings.png" />
</Frame>

Você também pode optar por desativar totalmente o Cascade com a configuração `devin.cascade.enabled`.

<div id="differences">
  ## Diferenças
</div>

<div id="permissions-model">
  ### Modelo de permissões
</div>

O Devin Local substitui os [níveis de execução automática](/pt-BR/desktop/terminal#auto-execution-levels) por um sistema de permissões mais granular para controlar quais ações o agente pode executar:

* As regras **Deny** bloqueiam completamente as ações (maior prioridade)
* As regras **Ask** sempre solicitam aprovação
* As regras **Allow** aprovam automaticamente as ações sem solicitar confirmação

As permissões podem ser definidas para leitura de arquivos, gravação de arquivos, execução de comandos, requisições HTTP e ferramentas MCP. Elas podem ser configuradas no nível do projeto, do usuário ou da organização.

<div id="mcp-permissions">
  ### Permissões do MCP
</div>

Ao contrário do Cascade, a configuração padrão do agente local do Devin solicita aprovação antes de usar qualquer ferramenta MCP. Quando o agente quiser invocar uma ferramenta MCP, você pode permitir a ferramenta específica ou todas as ferramentas desse servidor MCP, apenas para a sessão atual ou de forma permanente.

<Frame>
  <img src="https://mintcdn.com/cognitionai/awLyB8V-RSMAHpBB/desktop/assets/windsurf/devin-local-mcp-permissions.png?fit=max&auto=format&n=awLyB8V-RSMAHpBB&q=85&s=c10aa13cbe249f0aa4f67d502c25ebf4" width="1300" height="486" data-path="desktop/assets/windsurf/devin-local-mcp-permissions.png" />
</Frame>

Admins do Enterprise podem permitir, por padrão, servidores MCP ou ferramentas específicos para que integrações confiáveis não peçam aprovação sempre. Consulte [permissões baseadas em ferramentas](/pt-BR/cli/reference/permissions#tool-based-permissions) para saber como configurar essas regras.

<div id="mcp-server-configuration">
  ### Configuração do servidor MCP
</div>

Com o agente local do Devin, os servidores MCP são configurados por meio de [arquivos de configuração](https://cli.devin.ai/docs/extensibility/mcp/configuration) na sua máquina local.

O local do arquivo é determinado pelo escopo:

| Escopo         | Localização                   | Compartilhado com a equipe?          |
| -------------- | ----------------------------- | ------------------------------------ |
| Projeto        | `.devin/config.json`          | Sim (incluído no controle de versão) |
| Override local | `.devin/config.local.json`    | Não (ignorado pelo Git)              |
| Usuário        | `~/.config/devin/config.json` | Não                                  |

<div id="skills">
  ## Skills
</div>

Skills são conjuntos reutilizáveis de instruções (e scripts opcionais), acionados pelo modelo, que ampliam o que o agente local do Devin pode fazer. Como o Devin Local compartilha a mesma infraestrutura de agente do [Devin CLI](https://cli.devin.ai), ele usa o mesmo formato de skills e o mesmo mecanismo de descoberta.

Skills também são a forma recomendada de migrar memórias e fluxos de trabalho do Cascade, que não têm suporte no agente local do Devin (consulte [Limitações](#limitations)) — registre um procedimento repetível uma única vez, e o agente o invocará automaticamente quando relevante.

Consulte a [documentação de skills do Devin CLI](/pt-BR/cli/extensibility/skills/overview) para saber mais sobre como criar, configurar e definir o escopo de skills.

<div id="limitations">
  ## Limitações
</div>

Atualmente, os seguintes recursos não são compatíveis com o agente Devin Local:

* **Memories** — O agente Devin Local não mantém memórias entre sessões. Migre suas memórias críticas para [skills](/pt-BR/desktop/cascade/skills).
* **Workflows** — Workflows não estão disponíveis com o agente Devin Local. Migre seus workflows para [skills](/pt-BR/desktop/cascade/skills).
* **Codemaps** — O agente Devin Local ainda não lê [codemaps](/pt-BR/desktop/codemaps).
* **Code Lenses** - Atualmente, [code lenses](/pt-BR/desktop/command/windsurf-related-features) ainda não acionam o agente Devin Local.
* **Fast Context** - O Devin Local usa subagentes para explorar o código, mas não tem a mesma UI de contexto rápido do Cascade.
* **implantação de app** - O agente Devin Local não oferece suporte à implantação de app.
* **Browser previews** - O agente Devin Local ainda não oferece suporte a [prévias do navegador](/pt-BR/desktop/previews), incluindo a ferramenta de seleção de elementos do DOM.
* **compartilhamento de conversas** - O compartilhamento de conversas ainda não está disponível com o agente Devin Local.

O agente Devin Local oferece suporte a [regras e arquivos AGENTS.md](https://cli.devin.ai/docs/extensibility/rules), além de [skills](https://cli.devin.ai/docs/extensibility/skills/overview), para fornecer contexto persistente e workflows reutilizáveis.

<div id="analytics">
  ### Análises
</div>

O agente Devin Local ainda não reporta todas as análises que o Cascade coleta. Os dados a seguir são coletados para o Cascade, mas **não** para o Devin Local:

* **Uso de ferramentas** — A origem de dados [`cascade_tool_usage`](/pt-BR/desktop/accounts/api-reference/cascade-analytics) (contagem de chamadas por ferramenta, como Code Edit, Run Command, Search Web e MCP Tool) inclui apenas sessões do Cascade. As chamadas de ferramenta feitas pelo agente Devin Local não são reportadas. Para monitorar ou restringir o uso de ferramentas com o agente Devin Local, use [hooks](/pt-BR/cli/extensibility/hooks/overview) e [permissões](/pt-BR/cli/reference/permissions).
* **Linhas sugeridas e aceitas** — A origem de dados [`cascade_lines`](/pt-BR/desktop/accounts/api-reference/cascade-analytics) (linhas diárias de código sugeridas e aceitas) não inclui código escrito pelo agente Devin Local.
* **Modo de escrita/leitura** — O agente Devin Local não reporta um modo do Cascade, portanto o campo `mode` na origem de dados `cascade_runs` não é preenchido para a atividade do Devin Local.

A atividade do Devin Local ainda está incluída na origem de dados [`cascade_runs`](/pt-BR/desktop/accounts/api-reference/cascade-analytics) (uso do modelo, mensagens enviadas e consumo de créditos) e na [origem de dados Cascade](/pt-BR/desktop/accounts/analytics-api#cascade-data) da API Custom Analytics.

O Devin CLI não reporta análises para [implantações híbridas](https://devin.ai/blog/self-hosted-deployment-maintenance-mode).

<div id="enterprise-controls">
  ### Controles do Enterprise
</div>

Os admins do Enterprise podem configurar o agente Devin Local por meio das [Configurações da equipe](https://windsurf.com/team/settings), incluindo [novos controles disponíveis apenas com o agente Devin Local](https://cli.devin.ai/docs/enterprise/team-settings):

* **Imposição do sandbox** - Exija o modo sandbox para todos os usuários e configure regras de filtragem de domínios para toda a organização
* **Permissões granulares** - Controle quais ações o agente pode executar com permissões mais refinadas
* **Imposição de rede** - Controle o acesso à rede com domínios permitidos e bloqueados

Além disso, o controle "Enable Cascade" pode ser usado para desativar completamente o agente legado Cascade e garantir que sua equipe siga os novos controles disponíveis no Devin CLI.

<div id="unsupported-enterprise-controls">
  #### Controles do Enterprise sem suporte
</div>

Os seguintes controles do Enterprise legados não estão disponíveis com o agente Devin Local:

* **Restringir chamadas de ferramenta ao workspace** - por padrão, o agente Devin Local só pode ler/editar arquivos dentro do workspace.
  [Permissões](https://cli.devin.ai/docs/reference/permissions) personalizadas oferecem uma alternativa mais flexível para replicar as mesmas regras.
* **Implantações de app** - implantações de app ainda não são compatíveis com o agente Devin Local.
* **Compartilhamento de conversas** - o compartilhamento de conversas ainda não é compatível com o agente Devin Local.
* **Ativar ou desativar o Cascade para sua equipe** - essa configuração controla apenas o agente Cascade legado e não se aplica ao agente Devin Local nem ao Devin CLI.
* **Chamadas de ferramenta globais desativadas** - se você desativou anteriormente as chamadas de ferramenta por completo, crie uma [política de permissões](https://cli.devin.ai/docs/reference/permissions) equivalente para o Devin CLI.

Os seguintes controles legados ainda serão aplicados como fallback se você ainda não tiver implementado uma configuração de permissões do CLI do Enterprise:

* **Executar comandos do terminal automaticamente** - o agente Devin Local usa seu próprio [modelo de permissões](https://cli.devin.ai/docs/reference/permissions) em vez de níveis de execução automática; recomendamos usar esse modelo, mas o controle antigo ainda será aplicado como fallback.
* **Listas de permissões do terminal** - implemente uma [política de permissões](https://cli.devin.ai/docs/reference/permissions) equivalente para o Devin CLI para permitir comandos específicos do terminal.
* **Listas de bloqueio do terminal** - implemente uma [política de permissões](https://cli.devin.ai/docs/reference/permissions) equivalente para o Devin CLI para bloquear comandos específicos do terminal.

<div id="further-reading">
  ## Leituras adicionais
</div>

* [Guia de início rápido do Devin CLI](https://cli.devin.ai/docs)
* [Comandos essenciais](https://cli.devin.ai/docs/essential-commands)
* [Visão geral da extensibilidade](https://cli.devin.ai/docs/extensibility)
* [Configurações da equipe](https://cli.devin.ai/docs/enterprise/team-settings)