Sobre o agente de nuvem do GitHub Copilot

Copilot pode pesquisar um repositório, criar um plano de implementação e fazer alterações de código em um branch. Você pode examinar as diferenças, iterar e criar um pull request quando estiver pronto.

Quem pode usar esse recurso?

Copilot cloud agent está disponível para todos os planos Copilot pagos.

O agente está disponível em todos os repositórios armazenados em GitHub, exceto nos repositórios de propriedade de contas de usuário gerenciadas e onde foi explicitamente desativado.
Sign up for Copilot

Neste artigo

Visão geral de Copilot cloud agent

Com Copilot cloud agent, GitHub Copilot pode trabalhar de forma independente em segundo plano para concluir tarefas, assim como um desenvolvedor humano.

Copilot cloud agent Pode:

  • Pesquisar um repositório
  • Criar planos de implementação
  • Corrigir bugs
  • Implementar novos recursos incrementais
  • Aprimorar a cobertura do teste
  • Documentação de atualização
  • Resolver dívidas técnicas
  • Resolver os conflitos de fusão

Quando você delegar tarefas a Copilot cloud agent, você pode:

Copilot cloud agent avaliará a tarefa atribuída com base no prompt que você fornecer.

Enquanto trabalha em uma tarefa de codificação, Copilot cloud agent tem acesso ao seu próprio ambiente de desenvolvimento efêmero, alimentado por GitHub Actions, onde pode explorar seu código, fazer alterações, executar testes automatizados e linters e muito mais.

Observação

Pesquisa profunda, planejamento e iteração na preparação de alterações de código antes de submeter uma pull request só estão disponíveis com Copilot cloud agent no GitHub.com. Cloud agent integrações (como Azure Boards, JIRA, Linear, Slack ou Teams) só dão suporte à criação de uma solicitação de pull diretamente.

Benefícios em relação aos fluxos de trabalho de IA tradicionais

Quando usado efetivamente, Copilot cloud agent oferece benefícios de produtividade em relação aos assistentes de IA tradicionais em IDEs:

  • Com assistentes de IA em IDEs, a codificação ocorre localmente. Os desenvolvedores individuais emparelham sessões síncronas com o assistente de IA. As decisões tomadas durante a sessão não são rastreadas e são perdidas com o tempo, a menos que confirmadas. Embora o assistente ajude a escrever código, o desenvolvedor ainda tem muitas etapas manuais a fazer: criar o branch, escrever mensagens de commit, enviar por push as alterações, abrir o PR, escrever a descrição do PR, obter uma revisão, iterar no ambiente de desenvolvimento integrado (IDE) e repetir. Essas etapas exigem tempo e esforço que podem ser difíceis de justificar para issues simples ou rotineiros.

  • Com Copilot cloud agent, toda codificação e iteração acontece em GitHub. Você pode pedir para Copilot**** um repositório, criar um plano e fazer alterações de código em um branch, tudo antes de abrir uma solicitação de pull. Você pode criar vários custom agents que se especializam em diferentes tipos de tarefas. Copilot automatiza a criação de branches, a gravação de mensagens de confirmação e o envio de push. Os desenvolvedores permitem que os agentes trabalhem em segundo plano e, em seguida, optam por criar uma solicitação de pull quando estiverem prontos. Trabalhar em GitHub adiciona transparência, com cada etapa acontecendo em um commit e sendo visível nos logs, assim como abre oportunidades de colaboração para toda a equipe.

Compartilhamento de contexto entre as sessões Copilot Chat e Copilot cloud agent

Quando você inicia uma sessão Copilot cloud agent de Copilot Chat em GitHub, a sessão mantém o contexto da sua conversa. Você pode continuar conversando enquanto a sessão está em execução e fazer perguntas adicionais sobre o progresso na mesma conversa. Para obter mais informações, consulte Gerenciar sessões de agente.

Copilot cloud agent versus modo de agente

Copilot cloud agent é diferente do recurso "modo de agente" disponível em seu IDE. Copilot cloud agent funciona de forma autônoma em um GitHub Actions ambiente impulsionado para concluir tarefas de desenvolvimento atribuídas por meio de tarefas do GitHub ou prompts do GitHub Copilot Chat. Ele pode pesquisar um repositório, criar um plano, fazer alterações de código em um branch e, opcionalmente, abrir uma solicitação pull. Por outro lado, o modo de agente em seu IDE faz edições autônomas diretamente em seu ambiente de desenvolvimento local. Para obter mais informações sobre o modo de agente, consulte Fazendo perguntas ao GitHub Copilot no seu IDE.

Simplificando o desenvolvimento de software com Copilot cloud agent

Atribuir tarefas em Copilot cloud agent pode aprimorar o fluxo de trabalho de desenvolvimento de software.

Por exemplo, você pode atribuir Copilot cloud agent a problemas simples em sua lista de pendências selecionando "Copilot" como o atribuídor. Isso permite que você gaste menos tempo nessas questões e mais tempo em trabalhos mais complexos ou interessantes, ou trabalho que exija um alto grau de pensamento criativo. Copilot cloud agent pode trabalhar em problemas "desejáveis" que melhoram a qualidade de sua base de código ou produto, mas muitas vezes permanecem na lista de pendências enquanto você se concentra em tarefas mais urgentes.

Ter Copilot cloud agent como um recurso de codificação adicional também permite que você inicie tarefas que talvez você não tenha iniciado de outra forma devido à falta de recursos. Por exemplo, você pode criar tarefas para refatorar o código ou adicionar mais logs e, em seguida, atribuí-las imediatamente a Copilot.

Você também pode usar Copilot cloud agent para pesquisar um repositório e criar um plano antes que qualquer código seja escrito, ajudando você a entender como uma base de código funciona ou concordar com uma abordagem antes de se comprometer com as alterações. Consulte Pesquisar, planejar e iterar alterações de código com Copilot cloud agent.

Copilot cloud agent pode iniciar uma tarefa, que você pega e continua trabalhando nela. Ao atribuir o trabalho inicial a Copilot, você libera tempo que teria gasto fazendo tarefas repetitivas, como configurar a estrutura para um novo projeto.

Você pode criar uma especialização custom agents para tarefas diferentes. Por exemplo, você pode criar um custom agent especializado para desenvolvimento de front-end que se concentra em componentes e estilo do React, um agente de documentação que se destaca em escrever e atualizar a documentação técnica ou um agente de teste especializado na geração de testes de unidade abrangentes. Cada custom agent pode ser adaptado com prompts e ferramentas específicas adequadas para a sua tarefa.

Medindo os resultados da solicitação de pull para Copilot cloud agent

Os administradores corporativos e os proprietários da organização podem usar Copilot métricas de uso para analisar os resultados de pull requests criadas por Copilot cloud agent.

As Copilot APIs de métricas de uso incluem métricas de ciclo de vida de pull request, como:

  • O número total de solicitações de pull criadas e mescladas
  • O número de pull requests criados por Copilot cloud agent que foram mesclados
  • Tempo médio para mesclar as pull requests já mescladas, incluindo aquelas criadas por Copilot cloud agent

Essas métricas podem ajudá-lo a controlar a adoção de Copilot cloud agent e monitorar as alterações na taxa de transferência de pull requests, bem como no tempo para mesclar, ao longo do tempo. Consulte Métricas de uso do GitHub Copilot.

Integrando Copilot cloud agent com ferramentas de terceiros

Você também pode invocar Copilot cloud agent de ferramentas externas, permitindo atribuir tarefas a Copilot, fornecer contexto e abrir solicitações de pull sem sair do fluxo de trabalho. Confira Sobre integrações de Copilot

Disponibilizando Copilot cloud agent

Antes de atribuir tarefas a Copilot cloud agent, ele deve ser habilitado. Copilot cloud agent está disponível para todos os planos Copilot pagos.

Se você for um GitHub Copilot Business ou GitHub Copilot Enterprise assinante, um administrador deverá habilitar a política relevante antes de poder usar o agente.

Os proprietários do repositório podem optar por recusar alguns ou todos os repositórios do Copilot cloud agent.

Consulte Gerenciando o acesso ao agente de nuvem GitHub Copilot.

Modelos de IA para Copilot cloud agent

Dependendo de como você iniciar sua Copilot cloud agent tarefa, você poderá selecionar o modelo usado por Copilot cloud agent. Você pode achar que diferentes modelos têm um desempenho melhor ou fornecem respostas mais úteis, dependendo do tipo de tarefas que você fornece Copilot.

Consulte Alterando o modelo de IA para GitHub Copilot agente de nuvem.

Aprimorando o conhecimento de Copilot cloud agent sobre um repositório

Quanto mais Copilot cloud agent sabe sobre o código em seu repositório, as ferramentas que você usa e seus padrões e práticas de codificação, mais eficaz ele se tornará. Há duas maneiras de aprimorar Copilot cloud agento conhecimento de um repositório.

  • Instruções personalizadas

    Estas são instruções curtas em linguagem natural que você escreve e armazena como um ou mais arquivos em um repositório. Se você for o proprietário de uma organização no GitHub, também poderá definir instruções personalizadas nas configurações para a sua organização. Consulte Sobre a personalização das respostas do GitHub Copilot.

  • Copilot Memory (prévia pública)

    Se você tiver um Copilot Pro, Copilot Pro+ou Copilot Max plano, poderá habilitar Copilot Memory. Isso permite Copilot armazenar detalhes úteis que ele determinou por conta própria sobre um repositório. Copilot cloud agent em seguida, pode usar essas informações quando estiver operando nesse repositório. Consulte Sobre a Memória do GitHub Copilot.

Copilot cloud agent custos de uso

Copilot cloud agent usa GitHub Actions minutos e AI credits. Os AI credits consumidos dependem do modelo usado e do número de tokens processados durante a sessão.

Dentro de seus minutos incluídos GitHub Actions e AI credits, você pode usar Copilot cloud agent sem incorrer em custos adicionais. Consulte Cobrança baseada em uso para organizações e empresas.

Copilot A revisão de código também consome GitHub Actions minutos em repositórios privados. Consulte Cobrança do GitHub Actions.

Personalizar Copilot cloud agent

Você pode personalizar Copilot cloud agent de várias maneiras:

  • Instruções personalizadas: as instruções personalizadas permitem que você forneça Copilot contexto adicional em seu projeto e como criar, testar e validar suas alterações. Consulte Adicionando instruções personalizadas do repositório para GitHub Copilot.
  • Servidores MCP (Protocolo de Contexto de Modelo): os servidores MCP permitem que você dê Copilot acesso a diferentes fontes de dados e ferramentas. As configurações de MCP do repositório em GitHub se aplicam a ambos Copilot cloud agent e Copilot code review. O servidor MCP GitHub e o servidor MCP do Playwright são habilitados por padrão para as duas funcionalidades. Consulte Configurar servidores MCP para seu repositório.
  • Custom agents: Custom agents permite que você crie diferentes versões especializadas de Copilot para tarefas diferentes. Por exemplo, você pode personalizar Copilot para ser um engenheiro de front-end especialista seguindo as diretrizes da sua equipe. Consulte Sobre agentes personalizados.
  • Ganchos: os ganchos permitem executar comandos de shell personalizados em pontos-chave durante a execução do agente, permitindo que você adicione validação, registro em log, verificação de segurança ou automação de fluxo de trabalho. Consulte Sobre ganchos para GitHub Copilot.
  • Habilidades: as habilidades permitem que você aprimore a capacidade de Copilot executar tarefas especializadas com instruções, scripts e recursos. Consulte Sobre as habilidades do agente.

Limitações de Copilot cloud agent

Copilot cloud agent tem certas limitações em seu fluxo de trabalho de desenvolvimento de software e compatibilidade com outros recursos.

Limitações no Copilot cloud agent fluxo de trabalho de desenvolvimento de software

  • Copilot só pode fazer alterações no repositório especificado quando você inicia uma tarefa. Copilot não é possível fazer alterações em vários repositórios em uma única execução.
  • Por padrão, Copilot só é possível acessar o contexto no repositório especificado quando você inicia uma tarefa. O servidor Copilot MCP é configurado por padrão para permitir que Copilot acesse o contexto (por exemplo, problemas e solicitações de pull históricas) no repositório em que está operando. No entanto, você pode configurar um acesso mais amplo por meio de configurações de MCP do repositório. Consulte Configurar servidores MCP para seu repositório.
  • Copilot só pode funcionar em uma ramificação de cada vez e pode abrir exatamente uma solicitação de pull para resolver cada tarefa atribuída.
  • Cada Copilot cloud agent sessão tem um tempo máximo de execução de 59 minutos. Esse é um limite rígido que não pode ser estendido ou ignorado. Se uma tarefa exceder esse limite, a sessão expirará e será interrompida. Para tarefas complexas que podem exigir mais tempo, considere dividir o trabalho em tarefas menores e mais focadas. Você pode configurar um tempo limite mais curto usando a configuração timeout-minutes no arquivo copilot-setup-steps.yml. Consulte Configurar o ambiente de desenvolvimento.

Limitações na compatibilidade de Copilot cloud agent com outros recursos

  • Copilot não é capaz de cumprir determinadas regras que podem ser configuradas para seu repositório. Se você tiver configurado um conjunto de regras ou uma regra de proteção de branch que não seja compatível com Copilot cloud agent, o acesso ao agente será bloqueado. Por exemplo, uma regra que só permite autores de commit específicos pode impedir Copilot cloud agent de criar ou atualizar solicitações pull. Se a regra estiver configurada usando conjuntos de regras, você poderá adicionar Copilot como um ator de bypass para habilitar o acesso. Consulte Criar conjuntos de regras para um repositório.
  • Copilot cloud agent funciona apenas com repositórios hospedados em GitHub. Se o repositório estiver armazenado usando uma plataforma de hospedagem de código diferente, Copilot não será possível trabalhar nele.

Atividade prática

Experimente expandir a sua equipe com Copilot cloud agent o exercício De habilidades para experiência prática com Copilot cloud agent.

Leitura adicional