Skip to main content

Uso responsável do preenchimento de texto do GitHub Copilot

Saiba como usar o Copilot text completion de forma responsável, compreendendo suas finalidades, recursos e limitações.

Quem pode usar esse recurso?

Members of an enterprise with a subscription to GitHub Copilot Enterprise

Sobre Copilot text completion

Copilot text completion é um recurso baseado em IA que permite que os usuários escrevam descrições de pull request com mais facilidade, sugerindo texto à medida que você digita.

Quando você faz uma breve pausa enquanto digita um resumo, o Copilot examina a pull request e fornece prosa sugerida, tentando completar seu pensamento.

O único idioma com suporte para o Copilot text completion é o inglês.

O Copilot pull request summaries usa um fluxo de prompt simples aproveitando a API do Copilot utilizando o modelo de linguagem genérico grande, sem modelos treinados adicionais.

Quando você pausa durante a digitação da pull request, uma chamada é gerada para a API Copilot para gerar texto sugerido a ser inserido na descrição na posição atual do cursor. A solicitação de texto completo inclui informações da pull request, incluindo o título da pull request, qualquer texto que já esteja na descrição, os títulos de commit da pull request, diffs brutos parciais e títulos de pull request e títulos de problemas exibidos recentemente em um prompt que solicita que o Copilot gere uma sugestão para as próximas palavras que você provavelmente digitará. A resposta é então exibida como texto esmaecido após o cursor. Você pode aceitar o texto sugerido pressionando a tecla tab ou rejeitar a sugestão simplesmente continuando a digitar ou movendo o foco do cursor para fora do campo de descrição.

Caso de uso para texto de pull request concluído

O objetivo do Copilot text completion é ajudar o autor do pull request a fornecer rapidamente contexto aos revisores humanos da pull request. Ao revisar uma pull request, é importante entender o contexto, como por que as alterações estão sendo solicitadas e como a pull request faz essas alterações. Isso pode ajudar a aumentar a produtividade do desenvolvedor, reduzindo o tempo necessário para abrir uma solicitação de pull.

Melhorar o desempenho de prenchimento de texto de pull request

O recurso destina-se a complementar, em vez de substituir, o trabalho de um humano, adicionando contexto às pull requests. A qualidade das sugestões de preenchimento de texto dependerá da qualidade do título, das mensagens de commit e do texto já adicionado à descrição. Encorajamos você a continuar a adicionar contexto útil e deixar o Copilot sugerir à medida que avança. Continua sendo sua responsabilidade revisar e avaliar a precisão das informações nas pull requests que você cria.

Limitações de textos de pull requests preenchidas

No momento, nossa equipe está ciente de que existem limitações para esse recurso. Muitas delas são esperadas ao utilizar nossa API do Copilot. No entanto, há algumas que são específicas do Copilot text completion que dizem respeito a escopo limitado para pull requests muito grandes e respostas potencialmente imprecisas. Também observamos que os usuários devem esperar que os termos usados em suas pull requests apareçam nas sugestões geradas por IA.

Esse recurso foi sujeito ao RAI Red Teaming e continuaremos a monitorar a eficácia e a segurança do recurso ao longo do tempo. Para obter mais informações, confira Equipe do Microsoft AI Red construindo o futuro para a IA mais segura no blog de segurança da Microsoft.

Escopo limitado

É possível que, para pull requests muito grandes, parte do conteúdo da pull request no qual a API Copilot se baseia para sugerir automaticamente o texto não se encaixe na chamada de API e, portanto, para pull requests muito grandes, algumas das sugestões que você pode esperar podem não ocorrer.

Respostas imprecisas

Quanto mais entradas e contexto o Copilot tiver para trabalhar, melhores serão as sugestões de preenchimento de texto. No entanto, como o recurso é bastante novo, levará tempo para atingir a precisão exata com as sugestões de preenchimento de texto que são geradas. Enquanto isso, pode haver casos em que o preenchimento de texto gerado é menos preciso e exige que o usuário faça modificações antes de salvar e publicar sua pull request com essa descrição. Além disso, há o risco de "alucinação", em que o Copilot gera afirmações imprecisas. Por esses motivos, a revisão é um requisito, e a revisão cuidadosa do resultado é altamente recomendada.

Replicação do conteúdo da solicitação de pull

Como a sugestão de preenchimento de texto é um esboço das alterações feitas em uma pull request, se termos prejudiciais ou ofensivos estiverem dentro do conteúdo da pull request, é possível que a sugestão também inclua esses termos.

Leitura adicional