Propostas de merge
Peça a revisão das alterações de uma ramificação antes que elas cheguem a outra ramificação.
Visão geral
Uma proposta de merge registra uma solicitação para mesclar as alterações de uma ramificação em outra e permite que um colega revise o diff antes disso acontecer. Qualquer pessoa com acesso de edição ao agente pode abrir uma proposta, mesmo para uma ramificação na qual não possa fazer merge. Fazer o merge da proposta ainda exige acesso de gravação à ramificação de destino, então uma proposta permite que uma alteração chegue a uma ramificação protegida sem conceder a todos os colaboradores permissões de merge nela.
As propostas de merge adicionam uma etapa opcional de revisão ao merge direto de ramificações. Faça o merge diretamente quando você tiver acesso de gravação à ramificação de destino e não precisar de uma segunda opinião. Abra uma proposta quando quiser que ela seja revisada 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 merge estão em alfa. Quando várias ramificações de um agente estão em andamento ao mesmo tempo, fica difícil acompanhar quais estão prontas e seguras para mesclar. As propostas de merge oferecem à equipe um lugar para revisar e discutir as alterações de uma ramificação, comparar taxas de aprovação em testes entre ramificações e consultar as conversas mais recentes da ramificação.
A versão alfa é o primeiro passo para um workflow de estilo CI/CD para agentes, semelhante aos pull requests no GitHub. As adições planejadas para as próximas semanas incluem:
- Testes obrigatórios que precisam passar antes que uma proposta possa 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 está aberta, os revisores deixam um destes pareceres. O parecer mais recente de um revisor substitui qualquer parecer anterior desse mesmo revisor:
Abrir uma proposta
Abra uma proposta a partir da 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 da 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ções 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 aceitam markdown.
Fazer merge de uma proposta
Fazer o merge de uma proposta realiza o mesmo merge de ramificação que o merge direto, 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 o merge 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 parecer 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 fazer merge sem essa aprovação.
Fazer o merge de uma proposta fecha automaticamente qualquer outra proposta aberta para a mesma ramificação de origem, pois suas alterações agora foram transferidas.
Fechar uma proposta
Uma proposta pode ser fechada sem fazer merge a qualquer momento enquanto estiver aberta. O autor e os revisores podem editar seu título e descrição até que ela seja 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 de ou para ela, registrada como branch_archived.
Propostas de merge e o ElevenAgents Architect
O Architect pode abrir propostas de merge para você. Depois de fazer e testar uma alteração em uma ramificação, ele lê os commits e a prévia de merge 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 age como você, a proposta lista você como autor.
O Architect não pode revisar, aprovar, fazer merge nem fechar uma proposta. Essas etapas são sempre realizadas por pessoas. Consulte Propostas e validação para conhecer o fluxo completo.