> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Propostas de merge ## Visão geral Uma proposta de merge registra uma solicitação para mesclar as alterações de uma [ramificação](/docs/pt/eleven-agents/operate/versioning#branches) 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. > **Note** > > As propostas de merge adicionam uma etapa opcional de revisão ao [merge direto de ramificações](/docs/pt/eleven-agents/operate/versioning#merging-branches). 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: | Status | Significado | | -------- | ------------------------------------------------------------------------------------------------------------------------ | | Aberta | Aguardando revisão ou merge. | | Mesclada | As alterações da ramificação de origem foram mescladas à ramificação de destino. | | Fechada | Retirada pelo autor, rejeitada por outra pessoa ou fechada automaticamente porque a ramificação de origem foi arquivada. | 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: | Status da revisão | Significado | | ---------------------- | ------------------------------------------------------ | | Aprovada | O revisor está satisfeito com as alterações. | | Alterações solicitadas | O revisor quer que algo seja resolvido antes do merge. | ## Abrir uma proposta Abra uma proposta a partir da ramificação cujas alterações você quer revisar: #### Pela lista de ramificações Na aba **Branches** do agente, abra o menu de opções da ramificação de origem e selecione \*\*Open merge proposal \*\*. ![Opção Open merge proposal no menu de opções de uma ramificação](/docs/_fern-img/5216047fc93408959d31bba118e0f0e8853129da106a9d75c00d57a2307e33e0.webp) #### Pela aba Proposals Na aba **Branches > Proposals** do agente, selecione a ramificação de origem e clique em \*\*Create proposal \*\*. ![Aba Proposals na página Branches de um agente](/docs/_fern-img/bfdb23ad1edb31c89c2ff2a137fa3028bf3f9fbcf31e236de142e207b5d54cd0.webp) 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. > **Note** > > 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 A descrição, o histórico de revisões e um formulário para deixar uma revisão. ![Aba Overview de uma proposta de merge](/docs/_fern-img/44894b2d2cbb79aeff99813f83d5832ab4a9e6ff44796c772e3681c69120b04c.webp) #### Alterações Um diff entre as configurações das ramificações de origem e destino. ![Aba Changes de uma proposta de merge](/docs/_fern-img/968126763b1bb7e5bf57ad68ee334d5d5bc64b43a7ce3006184a462ce0c3d929.webp) #### Execuções de teste O histórico de testes da ramificação de origem, para que os revisores verifiquem se ela continua passando antes de aprovar. ![Aba Test runs de uma proposta de merge](/docs/_fern-img/a39354598b070cef39720159b84da10414d7b17820c8c71780ed2bd5a66a47fc.webp) #### Conversas Conversas recentes na ramificação de origem. ![Aba Conversations de uma proposta de merge](/docs/_fern-img/c37286e50107428225c57804a8bc8e09fe364b1ad6dc6cf582084dd8c52a6565.webp) 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](/docs/pt/eleven-agents/operate/versioning#merging-branches) que o merge direto, incluindo a [resolução de conflitos](/docs/pt/eleven-agents/operate/versioning#resolving-merge-conflicts) 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](/docs/pt/eleven-agents/operate/versioning), 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](/docs/pt/eleven-agents/operate/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](/docs/pt/eleven-agents/operate/architect/proposals) para conhecer o fluxo completo. ## Próximas etapas #### [Controle de versão](/docs/pt/eleven-agents/operate/versioning) Ramificações, versões e merge direto. #### [ElevenAgents Architect](/docs/pt/eleven-agents/operate/architect) O assistente integrado ao ElevenAgents para iterar em um agente. #### [Triagem](/docs/pt/eleven-agents/operate/triage) Revise problemas de conversas sinalizados para acompanhamento. #### [Experimentos](/docs/pt/eleven-agents/operate/experiments) Execute testes A/B usando ramificações e implantação de tráfego.