Apidog

Plataforma Colaborativa All-in-one para Desenvolvimento de API

Design de API

Documentação de API

Depuração de API

Mock de API

Testes Automatizados de API

Como Usar o Modo Agente do VS Code para Iniciantes

@apidog

@apidog

Updated on abril 11, 2025

Você ouviu falar do Modo Agente do VS Code?

Se você está usando o Visual Studio Code (VS Code), este recurso está prestes a se tornar seu novo melhor amigo. Imagine ter um assistente de IA que não apenas sugere código, mas realmente faz o trabalho pesado—editando arquivos, executando comandos e corrigindo erros—tudo enquanto você toma seu café e acena com aprovação.

Esse é o Modo Agente em poucas palavras, e hoje, eu vou te guiar sobre como usá-lo, passo a passo, com um clima divertido e amigável para iniciantes. Vamos mergulhar no mundo do Modo Agente do VS Code e ver como isso pode turbinar seu jogo de codificação!

💡
Ao implementar testes para aplicações baseadas em API, desenvolvedores e testadores estão se voltando cada vez mais para ferramentas especializadas como o Apidog, uma alternativa abrangente ao Postman que simplifica o ciclo de vida de desenvolvimento de API. 
botão
Imagem da interface do Apidog

O que é o Modo Agente do VS Code? Uma Introdução Rápida

Então, o que é essa coisa do Modo Agente do VS Code? Imagine o GitHub Copilot—o assistente de IA do VS Code—passando de “sugeridor útil” para “codificador autônomo.” No Modo Agente, o Copilot não apenas fica ali esperando você digitar; ele assume o controle. Você lhe dá uma tarefa de alto nível—como “Crie um aplicativo de lista de tarefas”—e ele descobre os arquivos a serem ajustados, escreve o código, executa comandos e até corrige erros, tudo por conta própria. É como programar em par com um robô que nunca dorme!

modo agente do copilot

A partir de 10 de abril de 2025, o Modo Agente está sendo ativamente desenvolvido e implementado, recheado de recursos como suporte ao Protocolo de Contexto de Modelo (MCP), o que significa que pode acessar ferramentas e dados externos. Quer você seja um novato ou um profissional, isso é um divisor de águas. Pronto para experimentar? Vamos configurá-lo!

Por que você vai adorar usar o Modo Agente do VS Code

Antes de começarmos, vamos conversar sobre por que o Modo Agente do VS Code é incrível:

  • Codificação Sem Mãos: Diga o que você quer, e ele faz o trabalho—perfeito para tarefas de várias etapas.
  • Correções Inteligentes: Ele captura erros (como erros de sintaxe ou testes falhos) e retorna para corrigi-los.
  • Poder das Ferramentas: Ele usa ferramentas integradas, servidores MCP e extensões para ir além de edições básicas.
  • Você Está no Controle: Você aprova cada mudança, então sem desastres de IA fora de controle.

Pense nisso como seu assistente pessoal de codificação que está sempre um passo à frente. Agora, vamos colocá-lo em funcionamento!

Como Configurar o Modo Agente do VS Code: Passo a Passo

Começar a usar o Modo Agente do VS Code é muito fácil. Veja como ativar e liberar a mágica:

Passo 1: Atualizar o VS Code

Primeiro de tudo—certifique-se de que você está em uma versão recente do VS Code que suporte o Modo Agente. Vá para code.visualstudio.com, baixe a versão Estável ou use o Insiders para recursos de ponta.

download do vs code

Passo 2: Habilitar o Modo Agente

O Modo Agente pode não estar ativado por padrão, dependendo da sua versão e do status de implementação. Veja como potencialmente ativá-lo:

Abra o VS Code.

Pressione Ctrl + , (ou Cmd + , no Mac) para abrir as Configurações.

Busque por chat.agent.enabled e certifique-se de que está marcado.

habilitar o modo agente

Se você não vê isso, recarregue o VS Code após a atualização—pode aparecer se disponível na sua versão. Verifique atualizações via Ajuda > Verificar Atualizações.

verificar novas atualizações

Dica Pro: Este passo pode se tornar desnecessário à medida que o Modo Agente é lançado de forma mais ampla. Por enquanto, este botão (se presente) te permite entrar cedo!

Passo 3: Fazer Login no GitHub

O Modo Agente do VS Code funciona com o GitHub Copilot, então você precisará de uma assinatura ativa.

No VS Code, clique no ícone Copilot na barra lateral (ou use o atalho relevante, por exemplo, Ctrl + Shift + I / Cmd + Shift + I para o painel do Copilot).

Faça login com suas credenciais do GitHub. Se você não tiver uma assinatura do Copilot, pode ser que precise se inscrever via GitHub.

Passo 4: Abra a Visão de Chat & Selecione o Modo Agente

Agora, vamos para a parte divertida:

Abra a visão de Chat do Copilot (Ctrl + Shift + I / Cmd + Shift + I).

Procure o dropdown de modo na parte inferior da área de entrada de Chat—pode dizer “Pergunte”, “Edite”, ou “Agente”.

modo perguntar

Selecione Agente. Pronto—você está no Modo Agente do VS Code!

habilitar modo agente

Como Usar o Modo Agente do VS Code: Vamos Construir Algo!

Certo, a configuração está feita—é hora de ver o Modo Agente em ação! Vamos construir um simples aplicativo de lista de tarefas em React juntos. Pegue um espaço em branco no VS Code e siga junto.

Passo 1: Dê uma Tarefa

Na visão de Chat (com o Modo Agente selecionado), digite uma tarefa clara e de alto nível. Por exemplo:

>> Crie um aplicativo de lista de tarefas em React simples. Deve ter um campo de entrada para adicionar tarefas e exibir a lista de tarefas.

Pressione Enter. Você não precisa especificar arquivos—o Modo Agente descobre isso!

Passo 2: Assista o Plano se Desenrolar

O Copilot começará a responder, transmitindo seu processo de pensamento. Ele pode dizer:

"Ok, posso ajudar com isso. Aqui está o plano:
  1. Configure uma estrutura básica de projeto React (se necessário).
  2. Crie o componente principal App.js para gerenciar o estado.
  3. Crie um componente TodoForm.js para o campo de entrada.
  4. Crie um componente TodoList.js para exibir as tarefas. Começarei criando os arquivos necessários..."

É como assistir um amigo codificando ao vivo! Ele também proporá comandos de terminal—como npm init react-app se seu projeto for novo.

passos realizados pelo modo agente

Passo 3: Aprove as Ferramentas

O Modo Agente pode precisar usar ferramentas—como rodar npm install ou usar operações de arquivo integradas. Você verá prompts como:

"Executar
npm install react react-dom
#terminal
#filesystem
src/App.js

Clique em “Continuar” para aprovar (ou ajuste o comando primeiro). Você pode conseguir aprovar automaticamente ferramentas para a sessão através de um dropdown—prático, mas use com sabedoria!

aprovar comando

Passo 4: Revisar as Edições

À medida que o Modo Agente trabalha, o código é transmitido para o seu editor, com sobreposições exibindo as mudanças (visões de diferença). Para nosso aplicativo de lista de tarefas, você pode ver:

App.js atualizado com gerenciamento de estado (useState) para as tarefas.

Um novo arquivo src/TodoForm.js com um formulário e elemento de entrada.

Um novo arquivo src/TodoList.js renderizando os itens da lista.

Navegue pelas edições com as setas para cima/baixo na sobreposição ou visualizador de diferenças, então clique em “Aceitar” (ou botão similar) para manter as mudanças ou “Descartar” para rejeitá-las. A visão de Chat geralmente lista os arquivos alterados, facilitando o acompanhamento.

revisar edições

Passo 5: Iterar e Refinar

Não está perfeito? Diga ao Modo Agente o que corrigir ou adicionar a seguir:

>> Agora, adicione a funcionalidade para marcar tarefas como completas quando clicadas e mude a cor da fonte para preto para as tarefas adicionadas à lista de tarefas.

saída final

O Modo Agente retornará, analisará o pedido, proporá mudanças, executará testes (se configurados em tasks.json) e atualizará o código. Ele continuará até acertar—ou você pausar.

Dominando o Modo Agente do VS Code: Dicas e Truques

Agora que você tem o básico, vamos aprimorar suas habilidades no Modo Agente do VS Code!

  • Use Prompts Específicos: Tarefas vagas como “Faça um aplicativo” podem ser menos eficazes. Tente objetivos focados: “Adicione um alternador de modo escuro ao meu aplicativo React usando a API de Contexto.” ou “Refatore este script Python utils.py para usar classes para melhor organização.” Objetivos claros = melhores resultados!
  • Aproveite as Ferramentas com # (ou outra sintaxe): Quer que o Modo Agente use uma capacidade específica? Use a sintaxe designada (por exemplo, #).
  • #terminal para executar comandos.
  • #codebase para pesquisar seu projeto em busca de contexto relevante.
  • #fetch para puxar dados de uma URL. Confira as ferramentas disponíveis (geralmente indicadas por um ícone ou comando) na área de entrada de Chat.
usar ferramentas
  • Pause ou Cancele Quando Necessário: Se o Modo Agente sair do controle (por exemplo, editando o arquivo errado ou ficando preso), pressione “Pausar” para refinar seu prompt ou “Cancelar” para parar a operação atual. Você pode frequentemente ainda aceitar as mudanças úteis feitas até agora.
  • Desfazer como um Profissional: Cometeu um erro ao aceitar mudanças? Use “Desfazer Última Edição” (ou comando similar, geralmente encontrado perto da entrada de chat/barra de título) para reverter. Mudou de ideia? “Refazer Última Edição” pode trazê-la de volta. É como Ctrl+Z/Cmd+Z para IA!
desfazer
  • Ajuste Configurações (se disponíveis): Vá para Configurações (Ctrl + ,) e procure por configurações relevantes do Modo Agente ou do Chat do Copilot. Você pode encontrar opções como:
  • chat.agent.maxRequests: Limitar quantos passos/iterações ele realiza.
  • github.copilot.chat.agent.runTasks: Alternar a execução automática de tarefas de espaço de trabalho (como builds/testes definidos em tasks.json).
ajustar configurações

Modo Agente vs. Modo Edição: Quando Usar o Que?

Confuso sobre Modo Agente vs. Modo Edição no Chat do Copilot? Aqui está a situação:

  • Modo Agente: Melhor para grandes tarefas de várias etapas onde você quer que a IA descubra o plano, gerencie arquivos e potencialmente se auto-corrija (por exemplo, "Construa um recurso," "Refatore este módulo"). É mais autônomo.
  • Modo Edição (ou Chat Inline): Perfeito para mudanças rápidas e específicas dentro do arquivo atual ou seleção (por exemplo, "Corrija esta função," "Renomeie esta variável," "Adicione tratamento de erros aqui"). Você tem mais controle direto sobre o escopo.

Se você não tiver certeza de quais arquivos precisam de mudanças ou como abordar uma tarefa maior, deixe o Modo Agente assumir a liderança. Precisa de modificações precisas em um ponto específico? Edição é geralmente mais rápida.

Conclusão: Seu Programador de IA Chegou

O Modo Agente do VS Code representa um passo significativo em direção ao desenvolvimento assistido por IA. Ao delegar tarefas de codificação complexas e de várias etapas ao GitHub Copilot, você pode se concentrar mais no design de alto nível, na resolução de problemas e na revisão do código gerado. Você viu como configurá-lo, guiá-lo na construção de um aplicativo simples e refinar os resultados. Embora exija instruções claras e revisão cuidadosa, o Modo Agente tem o potencial de acelerar drasticamente os fluxos de trabalho de desenvolvimento e enfrentar desafios de codificação de forma mais eficiente.

Pronto para experimentar seu novo programador de IA? Abra o VS Code, certifique-se de que o Copilot está configurado, mude para o Modo Agente e dê uma tarefa real do seu projeto atual. O que você irá construir ou refatorar primeiro?

botão