Skip to main content
Skip to content

Usando o modo de agente em seu IDE

Dê Copilot uma tarefa e deixe que ela funcione de forma autônoma em seu editor, editando arquivos em seu projeto e executando comandos até que a tarefa seja concluída.

Introdução

No modo de agente, Copilot usa uma tarefa de alto nível, decide quais arquivos alterar, faz as edições e executa comandos conforme necessário, iterando até que a tarefa seja concluída. Você permanece no controle: revisa as alterações e, por padrão, aprova comandos antes que eles sejam executados. Seu administrador ou suas próprias configurações de editor podem permitir que alguns comandos sejam executados automaticamente.

O modo de agente está disponível em Visual Studio Code, Visual Studio, IDEs da JetBrains, Xcode e Eclipse. As etapas diferem por editor, portanto, clique nas guias acima para obter instruções para seu IDE.

Para saber como abrir Copilot Chat e escolher entre os modos disponíveis, consulte Fazendo perguntas ao GitHub Copilot no seu IDE.

Use o modo de agente quando tiver uma tarefa específica em mente e quiser habilitar o Copilot para editar seu código de modo autônomo. No modo de agente, o Copilot determina em quais arquivos fazer alterações, oferece alterações de código e comandos de terminal para concluir a tarefa e itera para corrigir problemas até que a tarefa original seja concluída.

O modo de agente é mais adequado para casos de uso em que:

  • A tarefa é complexa e envolve várias etapas, iterações e tratamento de erro.
  • Você deseja que o Copilot determine as etapas necessárias a serem tomadas para concluir a tarefa.
  • A tarefa requer que o Copilot integre a aplicativos externos, como um servidor MCP.

Usando agentes

  1. Se a visualização de chat não estiver já sendo exibida, selecione Abrir Chat no Copilot Chat menu.
  2. Na parte inferior do modo de exibição de chat, verifique se o Agente está selecionado na lista suspensa de agentes.
  3. Envie um prompt. Em resposta ao prompt, Copilot transmite as edições no editor, atualiza o conjunto de trabalho e executa comandos de terminal, se necessário.
  4. Revise e itere sobre as alterações e/ou execute uma revisão de código.

Você também pode clicar neste link para ir diretamente para o modo de agente em VS Code.

Observação

Se você não vir a opção Agente no seletor de modo, o administrador da empresa ou da organização poderá ter desabilitado o modo de agente para seu IDE.

Para obter mais informações, consulte a visão geral do Chat na Visual Studio Code documentação.

Quando você usa o modo agente, cada prompt que você insere consome GitHub AI Credits.

Orientando um agente enquanto ele trabalha

O modo de agente é interativo. Enquanto Copilot estiver trabalhando, você pode:

  • Envie um prompt de continuação para redirecionar o agente antes que ele termine.
  • Confirme ou rejeite cada comando de terminal que o agente propõe, a menos que ele tenha sido configurado para ser executado automaticamente.
  • Examine as edições transmitidas conforme elas aparecem e desfaça as que você não quiser.

Se uma tarefa for grande ou ambígua, considere a elaboração de um plano de implementação primeiro. Consulte Usando o modo de plano em seu IDE.

Escolhendo um modelo ou um agente personalizado

Antes de enviar uma tarefa, você pode alterar o modelo de IA usado pelo agente ou selecionar um custom agent adaptado a um tipo específico de tarefa.

Estendendo o modo de agente com ferramentas

Grande parte da funcionalidade do modo de agente vem das ferramentas que ele pode chamar. Você pode estender o agente com servidores MCP (Model Context Protocol), que adicionam ferramentas para trabalhar com sistemas externos e com o próprio GitHub.

Para delegar uma subtarefa autocontida a um agente separado com seu próprio contexto, consulte Usando subagents em seu IDE.

Leitura adicional

Use o modo de agente quando você tiver uma tarefa específica em mente e quiser habilitar Copilot a edição autônoma do código. No modo de agente, Copilot determina em quais arquivos fazer alterações, oferece alterações de código e comandos de terminal para concluir a tarefa e itera para corrigir problemas até que a tarefa original seja concluída.

O modo de agente está disponível na Visual Studio versão 17.14 e posterior.

Como usar o modo de agente

  1. Na barra de Visual Studio menus, clique em Exibir e, em seguida, clique em GitHub Copilot Chat.
  2. Na parte inferior do painel de chat, selecione Agent na lista suspensa de modo.
  3. Envie um prompt. Em resposta ao prompt, Copilot transmite as edições no editor, atualiza o conjunto de trabalho e, se necessário, sugere comandos do terminal para serem executados.
  4. Revise as alterações. Se os comandos de terminal sugeridos por Copilot forem sugeridos, confirme se Copilot pode ou não executá-los. Em resposta, Copilot itera e executa ações adicionais para concluir a tarefa em seu prompt original.

Quando você usa o modo Copilot agent, cada prompt que você insere consome GitHub AI Credits.

Escolhendo um modelo

Antes de enviar uma tarefa, você pode alterar qual modelo de IA o agente usa. Consulte Alterando o modelo de IA para GitHub Copilot Chat.

Estendendo o modo de agente com ferramentas

Você pode estender o agente com servidores MCP (Model Context Protocol), que adicionam ferramentas para interagir com sistemas externos e com o próprio GitHub.

Leitura adicional

Use o modo de agente quando tiver uma tarefa específica em mente e quiser habilitar o Copilot para editar seu código de modo autônomo. No modo de agente, o Copilot determina em quais arquivos fazer alterações, oferece alterações de código e comandos de terminal para concluir a tarefa e itera para corrigir problemas até que a tarefa original seja concluída.

O modo de agente é mais adequado para casos de uso em que:

  • A tarefa é complexa e envolve várias etapas, iterações e tratamento de erro.
  • Você deseja que o Copilot determine as etapas necessárias a serem tomadas para concluir a tarefa.
  • A tarefa requer que o Copilot integre a aplicativos externos, como um servidor MCP.

Como usar o modo de agente

  1. Para iniciar uma sessão de edição usando o modo de agente, clique Copilot na barra de menus e selecione Abrir GitHub Copilot Chat.
  2. Na parte superior do painel de chat, clique na guia Agent.
  3. Envie um prompt. Em resposta ao prompt, Copilot transmite as edições no editor, atualiza o conjunto de trabalho e, se necessário, sugere comandos do terminal para serem executados.
  4. Revise as alterações. Se os comandos de terminal sugeridos por Copilot forem sugeridos, confirme se Copilot pode ou não executá-los. Em resposta, Copilot itera e executa ações adicionais para concluir a tarefa em seu prompt original.

Quando você usa o modo agente, cada prompt que você insere consome GitHub AI Credits.

Orientando um agente enquanto ele trabalha

O modo de agente é interativo. Enquanto Copilot estiver funcionando, você pode enviar um prompt de acompanhamento para redirecionar o agente e confirmar ou rejeitar cada comando de terminal que ele propõe.

Se uma tarefa for grande ou ambígua, considere a elaboração de um plano de implementação primeiro. Consulte Usando o modo de plano em seu IDE.

Escolhendo um modelo ou um agente personalizado

Antes de enviar uma tarefa, você pode mudar o modelo de IA que o agente usa ou selecionar um custom agent adaptado a um tipo específico de tarefa.

Estendendo o modo de agente com ferramentas

Você pode estender o agente com servidores Model Context Protocol (MCP), que adicionam ferramentas para trabalhar com sistemas externos e com o próprio agente.

Para delegar uma subtarefa autocontida a um agente separado com seu próprio contexto, consulte Usando subagents em seu IDE.

Leitura adicional

Use o modo de agente quando tiver uma tarefa específica em mente e quiser habilitar o Copilot para editar seu código de modo autônomo. No modo de agente, o Copilot determina em quais arquivos fazer alterações, oferece alterações de código e comandos de terminal para concluir a tarefa e itera para corrigir problemas até que a tarefa original seja concluída.

O modo de agente é mais adequado para casos de uso em que:

  • A tarefa é complexa e envolve várias etapas, iterações e tratamento de erro.
  • Você deseja que o Copilot determine as etapas necessárias a serem tomadas para concluir a tarefa.
  • A tarefa requer que o Copilot integre a aplicativos externos, como um servidor MCP.

Como usar o modo de agente

  1. Se ainda não estiver exibido, abra a Copilot Chat janela clicando no Editor na barra de menus e, em seguida, clique GitHub Copilot em Abrir Chat.
  2. Na parte inferior do painel de chat, selecione Agente na lista suspensa de agentes.
  3. Opcionalmente, adicione arquivos relevantes ao modo de exibição de conjunto de trabalho para indicar em Copilot quais arquivos você deseja trabalhar.
  4. Envie um prompt. Em resposta ao prompt, Copilot transmite as edições no editor, atualiza o conjunto de trabalho e, se necessário, sugere comandos do terminal para serem executados.
  5. Revise as alterações. Se os comandos de terminal sugeridos por Copilot forem sugeridos, confirme se Copilot pode ou não executá-los. Em resposta, Copilot itera e executa ações adicionais para concluir a tarefa em seu prompt original.

Quando você usa o modo agente, cada prompt que você insere consome GitHub AI Credits.

Orientando um agente enquanto ele trabalha

O modo de agente é interativo. Enquanto Copilot estiver funcionando, você pode enviar um prompt de acompanhamento para redirecionar o agente e confirmar ou rejeitar cada comando de terminal que ele propõe.

Se uma tarefa for grande ou ambígua, considere a elaboração de um plano de implementação primeiro. Consulte Usando o modo de plano em seu IDE.

Escolhendo um modelo

Antes de enviar uma tarefa, você pode alterar qual modelo de IA o agente usa. Consulte Alterando o modelo de IA para GitHub Copilot Chat.

Para delegar uma subtarefa autocontida a um agente distinto com seu próprio contexto, consulte Usando subagents em seu IDE.

Leitura adicional

Use o modo de agente quando tiver uma tarefa específica em mente e quiser habilitar o Copilot para editar seu código de modo autônomo. No modo de agente, o Copilot determina em quais arquivos fazer alterações, oferece alterações de código e comandos de terminal para concluir a tarefa e itera para corrigir problemas até que a tarefa original seja concluída.

O modo de agente é mais adequado para casos de uso em que:

  • A tarefa é complexa e envolve várias etapas, iterações e tratamento de erro.
  • Você deseja que o Copilot determine as etapas necessárias a serem tomadas para concluir a tarefa.
  • A tarefa requer que o Copilot integre a aplicativos externos, como um servidor MCP.

Como usar o modo de agente

  1. Abra o Copilot Chat painel clicando no Copilot ícone () na barra de status na parte inferior do Eclipse e, em seguida, clicando em Abrir Chat.
  2. Na parte inferior do painel de chat, selecione Agente na lista suspensa de agentes.
  3. Envie um prompt. Em resposta ao prompt, Copilot transmite as edições no editor, atualiza o conjunto de trabalho e, se necessário, sugere comandos do terminal para serem executados.
  4. Revise as alterações. Se os comandos de terminal sugeridos por Copilot forem sugeridos, confirme se Copilot pode ou não executá-los. Em resposta, Copilot itera e executa ações adicionais para concluir a tarefa em seu prompt original.

Quando você usa o modo agente, cada prompt que você insere consome GitHub AI Credits.

Orientando um agente enquanto ele trabalha

O modo de agente é interativo. Enquanto Copilot estiver funcionando, você pode enviar um prompt de acompanhamento para redirecionar o agente e confirmar ou rejeitar cada comando de terminal que ele propõe.

Se uma tarefa for grande ou ambígua, considere a elaboração de um plano de implementação primeiro. Consulte Usando o modo de plano em seu IDE.

Escolhendo um modelo

Antes de enviar uma tarefa, você pode alterar qual modelo de IA o agente usa. Consulte Alterando o modelo de IA para GitHub Copilot Chat.

Para delegar uma subtarefa autocontida a um agente separado com seu próprio contexto, consulte Usando subagents em seu IDE.

Leitura adicional