Observação
A justificativa, a confiança e as aprovações para automations estão em prévia pública e sujeitas a alterações.
Você pode criar um automation para fazer a triagem de problemas para você, aplicando rótulos, definindo tipos e campos, atribuindo problemas e fechando-os, sem que uma pessoa inicie cada alteração. A justificativa, a confiança e as aprovações dão visibilidade a esse trabalho automatizado e controle sobre quando ele se aplica.
Essa funcionalidade se aplica apenas às alterações que um automation faz em issues. Ele não se aplica às alterações que as pessoas fazem manualmente e não afeta outras ações que um automation pode realizar, como abrir solicitações de pull ou enviar código por push.
A justificativa, a confiança e as aprovações abrangem as alterações automation feitas nos seguintes atributos de problema: rótulos, campos, tipo de problema, fechamento de problemas e atribuições.
Lógica
Cada ação com suporte registra o motivo por trás dela, se a automation aplicou a alteração automaticamente ou a propôs como uma sugestão. Isso oferece uma trilha de auditoria do que mudou e por quê. Quando uma alteração está aguardando revisão, você vê o motivo na sugestão antes de decidir.
Você também pode ver a justificativa na issue para as alterações que entraram em vigor, se elas foram aplicadas automaticamente ou sugeridas e aprovadas. Uma ação com uma justificativa registrada terá ao lado dela. Selecione o ícone para revelar o raciocínio do automation para essa alteração.
Confiança
Para cada ação com suporte, o automation classifica sua confiança como alta, média ou baixa. Seu repositório tem um nível de automação que define o limite de confiança: as alterações classificadas abaixo dele são mantidas como sugestões, e as alterações nesse limite ou acima dele são aplicadas automaticamente.
- Controle total: cada alteração é mantida para revisão. Nada é aplicado automaticamente.
- Cauteloso (padrão): somente alterações de alta confiança são aplicadas automaticamente. Todo o resto é mantido para sua revisão.
- Equilibrado: as alterações de rotina e bem definidas são aplicadas automaticamente. Qualquer coisa com ambiguidade é mantida para revisão.
- Automação completa: cada alteração é aplicada automaticamente. O agente só retém uma mudança se ela estiver sinalizada como incerta.
Como as ações de menor confiança são as adiadas, você gasta tempo apenas nas alterações com maior probabilidade de precisar de uma segunda revisão.
Aprovações
Se uma alteração se aplica diretamente ou aguarda sua revisão depende de duas coisas:
- O nível de automação do seu repositório. As alterações avaliadas abaixo do limite são sempre mantidas como sugestões, não importa o que você tenha solicitado ao automation fazer.
- Uma solicitação explícita para sugerir. Você também pode solicitar ao automation que sugira uma alteração em vez de aplicá-la, e ele aguarda sua revisão mesmo que sua confiança seja alta.
As sugestões aparecem em um painel no problema. No painel, você pode:
- Aceite ou recuse cada sugestão individualmente.
- Aceite tudo ou recuse tudo para agir em várias sugestões ao mesmo tempo.
Uma pequena equipe que se move rapidamente pode escolher automação completa, enquanto um repositório público ocupado pode escolher Cauteloso ou Controle total para manter mais alterações para revisão em que as apostas são mais altas.
Observação
As aprovações são uma conveniência de fluxo de trabalho, não um controle de segurança. Eles não impõem um limite do lado do servidor, portanto, um agente com permissão para alterar issues pode aplicar alterações diretamente em vez de propô-las, inclusive por meio das APIs REST e GraphQL. Use permissões de repositório e agente, não aprovações, para controlar o que um automation tem permissão para fazer.
Próximas Etapas
Para saber como configurar o nível de automação do repositório e gerenciar sugestões, consulte Gerenciando justificativas, níveis de confiança e aprovações para problemas.