Sobre o
A geração de mensagens do commit no Copilot é um recurso da plataforma de IA que permite criar um resumo (título) e uma description da mensagem do commit com base nas alterações das quais você optou por fazer commit usando o GitHub Desktop.
Quando os usuários selecionam linhas de código específicas, o Copilot examina as alterações de código e fornece um resumo (título) e uma descrição sugeridos das alterações feitas em PROSE. Você pode examinar, editar ou regenerar as sugestões antes de finalizar e efetuar push dos commits manualmente para um branch.
O único idioma com suporte para mensagens do commit geradas pelo Copilot no GitHub Desktop é o inglês.
A geração de mensagens do commit no Copilot usa um prompt flow simples aproveitando a API do Copilot, utilizando o modelo de linguagem genérico grande e sem modelos treinados adicionais.
Quando você clica no botão do Copilot, é gerada uma chamada para a API do Copilot para gerar texto sugerido a ser inserido nas caixas de resumo e descrição. A solicitação do texto completo inclui informações das alterações selecionadas nos diferentes arquivos do repositório em um prompt que solicita que o Copilot gere uma sugestão para uma mensagem do commit que descreve com precisão essas alterações. Em seguida, a resposta é usada para preencher as caixas de resumo e descrição. Depois, você pode examinar a mensagem sugerida, editá-la se necessário e, em seguida, fazer um commit com ela.
Casos de uso do
O tem como objetivo simplificar o fluxo de trabalho do autor para que ele possa economizar tempo e manter históricos de commit claros ao resumir suas alterações. Para muitos usuários, isso é útil para economizar tempo ao fazer commit de alterações grandes. Os autores podem examinar, editar ou regenerar as sugestões antes de finalizar e efetuar push dos commits manualmente para um branch. Eles também podem selecionar linhas de código ou arquivos específicos para melhor compreensão do contexto a fim de aumentar a precisão. O recurso é integrado diretamente ao fluxo de trabalho de commit para uma experiência mais suave.
Aprimorando o
Para aprimorar a experiência e resolver algumas das limitações do , há várias medidas que você pode adotar. Para obter mais informações sobre as limitações, confira Limitações do .
Usar o como uma ferramenta, não como um substituto
O recurso destina-se a complementar, em não a substituir, o trabalho de uma pessoa na elaboração de mensagens de commit. A qualidade das sugestões de mensagem do commit dependerá da qualidade das alterações de código e do contexto nos arquivos alterados. Incentivamos você a selecionar linhas de código ou arquivos específicos para melhor compreensão do contexto e para aumentar a precisão. Continua sendo sua responsabilidade revisar e avaliar a precisão das informações nos commits que cria.
Enviar comentários
Se encontrar problemas ou limitações com o , você poderá fornecer comentários criando um issue no repositório de software livre do GitHub Desktop. Isso ajuda os desenvolvedores a aprimorar a ferramenta e resolver questões ou limitações.
Limitações do
Dependendo de fatores como sistema operacional e dados de entrada, você pode obter diferentes níveis de precisão usando usa o . As informações a seguir ajudam a entender as limitações do sistema e os principais conceitos sobre desempenho, pois se aplicam ao .
Escopo limitado
O opera dentro de limites definidos e pode ter dificuldades com alterações de código complexas, janelas de comparação curtas ou linguagens de programação desenvolvidas recentemente. A qualidade das sugestões fornecidas pode ser influenciada pela disponibilidade e pela diversidade dos dados de treinamento. Por exemplo, consultas sobre linguagens bem documentadas, como o Python, podem gerar respostas mais precisas em comparação com perguntas sobre linguagens menos populares.
Respostas imprecisas
Quanto mais entradas e contexto o Copilot puder usar para aprender, melhores serão as saídas. No entanto, como o recurso é bastante novo, levará tempo para atingir a precisão exata com os resumos que são gerados. Enquanto isso, pode haver casos em que o resumo gerado é menos preciso e exige que o usuário faça modificações antes de salvar e publicar sua solicitação de pull 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 por nossa equipe.
Regenerando resumos
Mensagens de commit são criadas apenas quando os usuários as solicitam manualmente. Quando os usuários enviam atualizações ou alterações para repositórios, o resumo e a descrição do commit não são atualizados automaticamente. Os usuários podem solicitar que o Copilot gere uma nova mensagem, se necessário. É altamente recomendável a revisão manual da mensagem atualizada do Copilot. A mensagem atualizada traz os mesmos riscos de imprecisão que a original.
Replicação do conteúdo da solicitação de pull
Como uma mensagem do commit é um resumo das alterações feitas em um repositório, é possível que o resumo contenha termos prejudiciais ou ofensivos caso haja algum desses termos no conteúdo das alterações.
Possíveis vieses e erros
Os dados de treinamento do são provenientes de fontes online existentes. É importante notar que essas fontes podem incluir vieses e erros das pessoas que contribuíram para os dados de treinamento. O pode inadvertidamente perpetuar esses vieses e erros.