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

# Visão geral do Cascade

> Cascade é o assistente de IA autônoma do Devin Desktop, com modos Code/Chat, chamadas de ferramentas, entrada por voz, checkpoints, percepção em tempo real e integração com linter.

O Cascade do Devin Desktop oferece um novo nível de colaboração entre humanos e IA.

Para abrir o Cascade, pressione `Cmd/Ctrl+L` ou clique no ícone do Cascade no canto superior direito da janela do Devin Desktop. Qualquer texto selecionado no editor ou no terminal será incluído automaticamente.

<div id="quick-links-to-features">
  ### Links rápidos para recursos
</div>

<CardGroup cols={2}>
  <Card title="Pesquisa na web" icon="globe-pointer" href="/pt-BR/desktop/cascade/web-search">
    Pesquise na web para obter informações que podem ser usadas nas sugestões do Cascade.
  </Card>

  <Card title="Memórias e Regras" icon="cloud-word" href="/pt-BR/desktop/cascade/memories">
    Memórias e regras ajudam a personalizar o comportamento.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="MCP" icon="hammer" href="/pt-BR/desktop/cascade/mcp">
    Os servidores MCP ampliam os recursos do agente.
  </Card>

  <Card title="Terminal" icon="terminal" href="/pt-BR/desktop/terminal">
    Uma experiência de Terminal aprimorada.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Fluxos de trabalho" icon="list" href="/pt-BR/desktop/cascade/workflows">
    Automatize tarefas repetitivas.
  </Card>

  <Card title="Implantações de apps" icon="rocket" href="/pt-BR/desktop/cascade/app-deploys">
    Implante aplicativos com um clique.
  </Card>
</CardGroup>

<div id="model-selection">
  # Seleção de modelo
</div>

Selecione o modelo desejado no menu de seleção abaixo do campo de entrada da conversa do Cascade. Clique abaixo para ver a lista completa dos modelos disponíveis e sua disponibilidade em diferentes planos e faixas de preço.

<Card title="Modelos" icon="gear-code" href="/pt-BR/desktop/models" horizontal={true}>
  Disponibilidade de modelos no Devin Desktop.
</Card>

<div id="cascade-code-cascade-chat">
  # Cascade Code / Cascade Chat
</div>

O Cascade tem dois modos principais: **Code** e **Chat**.

O modo Code permite que o Cascade crie e faça alterações na sua base de código, enquanto o modo Chat é otimizado para perguntas sobre a sua base de código ou princípios gerais de programação.

No modo Chat, o Cascade pode propor novos trechos de código para você, que pode aceitá-los e inseri-los.

<div id="plans-and-todo-lists">
  # Planos e listas de tarefas
</div>

O Cascade tem recursos nativos de planejamento que ajudam a melhorar o desempenho em tarefas mais longas.

Em segundo plano, um agente de planejamento especializado refina continuamente o plano de longo prazo, enquanto o modelo que você selecionou se concentra em executar ações de curto prazo com base nesse plano.

O Cascade criará uma lista de tarefas na conversa para acompanhar o progresso em tarefas complexas. Para fazer alterações no plano, basta pedir ao Cascade para atualizar a lista de tarefas.

O Cascade também pode atualizar o plano automaticamente à medida que capta novas informações, como uma [Memória](/pt-BR/desktop/cascade/memories), ao longo de uma conversa.

<div id="queued-messages">
  # Mensagens na fila
</div>

Enquanto você espera o Cascade concluir a tarefa atual, pode colocar novas mensagens na fila para serem executadas em sequência assim que a tarefa for concluída.

Para adicionar uma mensagem à fila, basta digitá-la enquanto o Cascade estiver trabalhando e pressionar `Enter`.

* **Enviar imediatamente**: Pressione `Enter` novamente em um campo de texto vazio para enviá-la na hora.
* **Excluir**: Remova qualquer mensagem da fila antes de ela ser enviada

<div id="tool-calling">
  # Chamadas de ferramentas
</div>

O Cascade tem uma variedade de ferramentas à sua disposição, como Search, Analyze, [pesquisa na web](/pt-BR/desktop/cascade/web-search), [MCP](/pt-BR/desktop/cascade/mcp) e o [terminal](/pt-BR/desktop/terminal).

Ele consegue detectar quais pacotes e ferramentas você está usando, quais precisam ser instalados e até instalá-los para você. Basta perguntar ao Cascade como executar seu projeto e pressionar Accept.

<Note>O Cascade pode fazer até 20 chamadas de ferramentas por prompt. Se a execução parar, basta pressionar o botão `continue` e o Cascade retomará de onde parou. No entanto, cada `continue` contará como um novo crédito de prompt devido aos custos das chamadas de ferramentas.</Note>

Você pode configurar a opção `Auto-Continue` para que o Cascade continue automaticamente a resposta se atingir um limite. Isso consumirá um ou mais créditos de prompt, de acordo com o modelo que você estiver usando.

<Frame>
  <video autoPlay muted loop playsInline src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/auto-continue.mp4?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=c18ea30e4a046e686ec73bd968fd5708" data-path="desktop/assets/windsurf/cascade/auto-continue.mp4" />
</Frame>

<div id="voice-input">
  # Entrada por voz
</div>

Use a Entrada por voz para interagir com o Cascade usando sua voz. Atualmente, ela pode transcrever sua fala em texto.

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/voice-mode.mp4?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=99e3fdda91ed54226237e7d4714d55e4" data-path="desktop/assets/windsurf/cascade/voice-mode.mp4" />

<div id="named-checkpoints-and-reverts">
  # Checkpoints nomeados e reversões
</div>

Você pode reverter as alterações feitas pelo Cascade. Basta passar o mouse sobre o prompt original e clicar na seta de reversão à direita, ou reverter diretamente pelo sumário. Isso fará com que todas as alterações no código voltem ao estado em que sua base de código estava na etapa desejada.

<Warning>No momento, as reversões são irreversíveis, então tenha cuidado!</Warning>

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/cascade-revert.mp4?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=2c8998de7ae41d52f7e201968b7d0fa2" data-path="desktop/assets/windsurf/cascade/cascade-revert.mp4" />

Você também pode criar, na conversa, um snapshot/checkpoint nomeado do estado atual do seu projeto, para o qual pode navegar facilmente e reverter a qualquer momento.

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/namedcheckpoints.mp4?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=f781fe8b456ecf92dc7da510409f21ca" data-path="desktop/assets/windsurf/cascade/namedcheckpoints.mp4" />

<div id="real-time-awareness">
  # Percepção em tempo real
</div>

Um recurso exclusivo do Devin Desktop e do Cascade é acompanhar suas ações em tempo real, eliminando a necessidade de fornecer contexto sobre o que você fez anteriormente.

Basta instruir o Cascade a "Continuar".

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf-continue.mp4?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=3d31ba9067a3d44e8316e6f5adf1d875" data-path="desktop/assets/windsurf-continue.mp4" />

<div id="send-problems-to-cascade">
  # Enviar problemas para o Cascade
</div>

Se houver problemas no seu código que apareçam no painel Problems, na parte inferior do editor, basta clicar no botão `Send to Cascade` para enviá-los ao painel Cascade como uma menção com @.

<Frame>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/send-problems-to-cascade.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=2a4a9fa9028fb4283ebf7a8e2978ff12" width="316" height="122" data-path="desktop/assets/windsurf/cascade/send-problems-to-cascade.png" />
</Frame>

<div id="explain-and-fix">
  # Explicar e corrigir
</div>

Se você encontrar algum erro no editor, basta destacá-lo e clicar em `Explain and Fix` para que o Cascade o corrija.

<Frame>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/windsurf-explain-fix.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=320ae91d95495409e321f49e98639ffe" width="886" height="140" data-path="desktop/assets/windsurf/windsurf-explain-fix.png" />
</Frame>

<div id="ignoring-files">
  # Ignorando arquivos
</div>

Se quiser que o Cascade ignore arquivos, adicione-os ao `.codeiumignore` na raiz do seu workspace. Isso impede que o Cascade visualize, edite ou crie arquivos nos caminhos especificados. Você pode definir os caminhos dos arquivos em um formato semelhante ao do `.gitignore`.

<div id="global-codeiumignore">
  ## .codeiumignore global
</div>

Para clientes Enterprise que gerenciam vários repositórios, é possível aplicar regras de ignorar em todos os repositórios colocando um arquivo `.codeiumignore` global na pasta `~/.codeium/`. Essa configuração global será aplicada a todos os workspaces do Devin Desktop no seu sistema e funciona em conjunto com quaisquer arquivos `.codeiumignore` específicos de cada repositório.

<div id="linter-integration">
  # Integração com linter
</div>

O Cascade pode corrigir automaticamente erros de lint no código gerado. Isso fica ativado por padrão, mas pode ser desativado clicando em `Auto-fix` na chamada da ferramenta e, em seguida, em `disable`. Essa edição não consumirá créditos.

<Frame>
  <img src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/auto-fix-lint.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=d173740b98731de1d1570e55a47decf5" width="584" height="196" data-path="desktop/assets/windsurf/cascade/auto-fix-lint.png" />
</Frame>

Quando o Cascade faz uma edição com o objetivo principal de corrigir erros de lint que ele gerou e detectou automaticamente,
essa edição pode não ser cobrada em créditos. Isso reconhece o fato de que
corrigir erros de lint aumenta o número de chamadas de ferramenta que o Cascade faz.

<div id="sharing-your-conversation">
  # Compartilhar sua conversa
</div>

<Note>Atualmente, esse recurso está disponível apenas para clientes Teams e Enterprise.</Note>

Você pode compartilhar suas trajetórias no Cascade com sua equipe clicando no botão `...` de opções adicionais, no canto superior direito do painel do Cascade, e depois em `Share Conversation`.

<div id="mention-previous-conversations">
  # @-menção de conversas anteriores
</div>

Você também pode referenciar conversas anteriores em outras conversas usando uma `@-menção`.

Ao fazer isso, o Cascade recuperará as informações mais relevantes e úteis, como resumos da conversa e checkpoints, além de partes específicas da conversa que você consultar. Em geral, ele não recupera a conversa inteira para não sobrecarregar a janela de contexto.

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/at-mention-convos.mp4?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=bad3d0cd293fdaad8a6f9f4c84589f84" data-path="desktop/assets/windsurf/cascade/at-mention-convos.mp4" />

<div id="simultaneous-cascades">
  # Cascades simultâneas
</div>

Os usuários podem ter várias Cascades em execução ao mesmo tempo. Você pode alternar entre elas usando o menu suspenso no canto superior esquerdo do painel do Cascade.

<Warning>Se duas Cascades editarem o mesmo arquivo ao mesmo tempo, pode haver uma condição de corrida e, às vezes, a segunda edição pode falhar.</Warning>

Se você espera que duas Cascades editem arquivos semelhantes, considere usar [worktrees](./worktrees) para mantê-las isoladas.
