Propostas de mesclagem
Peça a revisão das alterações de uma ramificação antes que elas cheguem a outra.
Visão geral
Uma proposta de mesclagem registra uma solicitação para mesclar as alterações de uma ramificação em outra e permite que alguém da equipe revise o diff antes disso. Qualquer pessoa com acesso de edição ao agente pode abrir uma proposta, mesmo para uma ramificação em que não possa fazer a mesclagem. A mesclagem da proposta ainda exige acesso de gravação à ramificação de destino. Assim, uma proposta permite que uma alteração chegue a uma ramificação protegida sem conceder direitos de mesclagem nela a todos os colaboradores.
As propostas de mesclagem adicionam uma etapa de revisão opcional à mesclagem direta de ramificações . Faça a mesclagem diretamente quando tiver acesso de gravação à ramificação de destino e não precisar de uma segunda opinião. Abra uma proposta quando quiser que alguém a revise primeiro ou quando a ramificação de destino estiver protegida e você não tiver acesso de gravação a ela.
Disponibilidade
As propostas de mesclagem estão em alfa. Quando várias ramificações de um agente estão em andamento ao mesmo tempo, torna-se difícil acompanhar quais estão prontas e são seguras para mesclar. As propostas de mesclagem dão à equipe um lugar para revisar e discutir as alterações de uma ramificação, comparar as taxas de aprovação de testes entre ramificações e analisar as conversas mais recentes da ramificação.
A versão alfa é um primeiro passo rumo a um workflow no estilo CI/CD para agentes, semelhante a pull requests no GitHub. As adições planejadas para as próximas semanas incluem:
- Testes obrigatórios que devem ser aprovados antes de uma proposta poder ser mesclada.
- Solicitação de aprovações de revisores específicos.
- Configuração de responsáveis por diferentes partes de um agente.
Ciclo de vida da proposta
Cada proposta tem um destes status:
Enquanto uma proposta estiver aberta, os revisores podem emitir um destes veredictos. O veredicto mais recente de um revisor substitui qualquer anterior do mesmo revisor:
Abrir uma proposta
Abra uma proposta na ramificação cujas alterações você quer revisar:
Pela lista de ramificações
Pela aba Proposals
Na aba Branches do agente, abra o menu de opções na ramificação de origem e selecione **Open merge proposal **.
Dê à proposta um título, uma descrição opcional e escolha uma ramificação de destino entre as outras ramificações não arquivadas do agente. Abrir uma proposta não altera nenhuma das ramificações; apenas registra a solicitação.
Um par de ramificação de origem e destino pode ter no máximo uma proposta aberta por vez. Feche a existente antes de abrir outra entre as mesmas duas ramificações.
Revisar uma proposta
A página de uma proposta tem estas abas:
Visão geral
Alterações
Execuções de teste
Conversas
A descrição, o histórico de revisões e um formulário para deixar uma revisão.
Qualquer pessoa com acesso de edição ao agente, exceto o próprio autor da proposta, pode deixar uma revisão com um comentário opcional. Os comentários oferecem suporte a markdown.
Mesclar uma proposta
Mesclar uma proposta realiza a mesma mesclagem de ramificação da mesclagem direta, incluindo a resolução de conflitos e a opção de arquivar a ramificação de origem depois. Antes de poder ser mesclada, uma proposta precisa atender a estes requisitos:
- O usuário que faz a mesclagem tem acesso de gravação às ramificações de origem e destino. Em uma ramificação protegida, isso significa ser administrador do espaço de trabalho.
- O veredicto mais recente de nenhum revisor é “alterações solicitadas”. Um revisor que solicitou alterações precisa aprovar antes que a proposta possa ser mesclada.
- A proposta tem pelo menos uma aprovação de alguém que não seja seu autor. Administradores do espaço de trabalho podem mesclar sem essa aprovação.
Mesclar uma proposta fecha automaticamente qualquer outra proposta aberta para a mesma ramificação de origem, pois as alterações dela agora seguiram adiante.
Fechar uma proposta
Uma proposta pode ser fechada sem mesclagem a qualquer momento enquanto estiver aberta. O autor e os revisores podem editar o título e a descrição até ela ser fechada.
- Quando o autor fecha sua própria proposta, ela é registrada como retirada.
- Quando qualquer outra pessoa a fecha, ela é registrada como rejeitada.
- Arquivar a ramificação de origem fecha automaticamente qualquer proposta aberta dela ou para ela, registrada como branch_archived.
Propostas de mesclagem e ElevenAgents Architect
O Architect pode abrir propostas de mesclagem para você. Depois de fazer e testar uma alteração em uma ramificação, ele lê os commits e a prévia da mesclagem da ramificação e abre uma proposta com as seções Resumo, Testes e Como revisar. Ele também pode sugerir revisores para você escolher. Como o Architect atua como você, a proposta indica você como autor.
O Architect não pode revisar, aprovar, mesclar nem fechar uma proposta. Essas etapas são sempre realizadas por pessoas. Consulte Propostas e validação para ver o fluxo completo.