# Gerenciando justificativas, níveis de confiança e aprovações para problemas

Configure e gerencie lógica, confiança e aprovações para problemas tratados por Automação.

A lógica e a confiança não precisam de nenhuma configuração extra. Quando o agente de Automação altera um atributo de incidente compatível, ele anexa automaticamente uma justificativa e um nível de confiança. Se essa alteração se aplica diretamente ou aguarda revisão depende do nível de automação do repositório ou de uma solicitação explícita para sugerir em vez de aplicar a alteração.

## Definindo o nível de automação do repositório

> \[!NOTE]
> A configuração de um nível de automação está sendo distribuída gradualmente e pode não estar disponível no repositório ainda.

O nível de automação do repositório define o limite de confiança usado para rotear todas as alterações com suporte. As alterações avaliadas abaixo do limite são mantidas como sugestões; as alterações no ou acima se aplicam automaticamente. O nível padrão é **Cauteloso**, portanto, somente as alterações de alta confiança se aplicam automaticamente até você alterá-lo.

1. Em GitHub, acesse a página principal do repositório.
2. No nome do repositório, clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-gear" aria-label="gear" role="img"><path d="M8 0a8.2 8.2 0 0 1 .701.031C9.444.095 9.99.645 10.16 1.29l.288 1.107c.018.066.079.158.212.224.231.114.454.243.668.386.123.082.233.09.299.071l1.103-.303c.644-.176 1.392.021 1.82.63.27.385.506.792.704 1.218.315.675.111 1.422-.364 1.891l-.814.806c-.049.048-.098.147-.088.294.016.257.016.515 0 .772-.01.147.038.246.088.294l.814.806c.475.469.679 1.216.364 1.891a7.977 7.977 0 0 1-.704 1.217c-.428.61-1.176.807-1.82.63l-1.102-.302c-.067-.019-.177-.011-.3.071a5.909 5.909 0 0 1-.668.386c-.133.066-.194.158-.211.224l-.29 1.106c-.168.646-.715 1.196-1.458 1.26a8.006 8.006 0 0 1-1.402 0c-.743-.064-1.289-.614-1.458-1.26l-.289-1.106c-.018-.066-.079-.158-.212-.224a5.738 5.738 0 0 1-.668-.386c-.123-.082-.233-.09-.299-.071l-1.103.303c-.644.176-1.392-.021-1.82-.63a8.12 8.12 0 0 1-.704-1.218c-.315-.675-.111-1.422.363-1.891l.815-.806c.05-.048.098-.147.088-.294a6.214 6.214 0 0 1 0-.772c.01-.147-.038-.246-.088-.294l-.815-.806C.635 6.045.431 5.298.746 4.623a7.92 7.92 0 0 1 .704-1.217c.428-.61 1.176-.807 1.82-.63l1.102.302c.067.019.177.011.3-.071.214-.143.437-.272.668-.386.133-.066.194-.158.211-.224l.29-1.106C6.009.645 6.556.095 7.299.03 7.53.01 7.764 0 8 0Zm-.571 1.525c-.036.003-.108.036-.137.146l-.289 1.105c-.147.561-.549.967-.998 1.189-.173.086-.34.183-.5.29-.417.278-.97.423-1.529.27l-1.103-.303c-.109-.03-.175.016-.195.045-.22.312-.412.644-.573.99-.014.031-.021.11.059.19l.815.806c.411.406.562.957.53 1.456a4.709 4.709 0 0 0 0 .582c.032.499-.119 1.05-.53 1.456l-.815.806c-.081.08-.073.159-.059.19.162.346.353.677.573.989.02.03.085.076.195.046l1.102-.303c.56-.153 1.113-.008 1.53.27.161.107.328.204.501.29.447.222.85.629.997 1.189l.289 1.105c.029.109.101.143.137.146a6.6 6.6 0 0 0 1.142 0c.036-.003.108-.036.137-.146l.289-1.105c.147-.561.549-.967.998-1.189.173-.086.34-.183.5-.29.417-.278.97-.423 1.529-.27l1.103.303c.109.029.175-.016.195-.045.22-.313.411-.644.573-.99.014-.031.021-.11-.059-.19l-.815-.806c-.411-.406-.562-.957-.53-1.456a4.709 4.709 0 0 0 0-.582c-.032-.499.119-1.05.53-1.456l.815-.806c.081-.08.073-.159.059-.19a6.464 6.464 0 0 0-.573-.989c-.02-.03-.085-.076-.195-.046l-1.102.303c-.56.153-1.113.008-1.53-.27a4.44 4.44 0 0 0-.501-.29c-.447-.222-.85-.629-.997-1.189l-.289-1.105c-.029-.11-.101-.143-.137-.146a6.6 6.6 0 0 0-1.142 0ZM11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0ZM9.5 8a1.5 1.5 0 1 0-3.001.001A1.5 1.5 0 0 0 9.5 8Z"></path></svg> Settings**. Caso não consiga ver a guia "Configurações", selecione o menu suspenso **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="More" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>** , clique em **Configurações**.

   ![Captura de tela de um cabeçalho de repositório que mostra as guias. A guia "Configurações" é realçada por um contorno laranja-escuro.](/assets/images/help/repository/repo-actions-settings.png)
3. Na seção "Planejamento" da barra lateral, clique em **Sugestões do Agente para problemas**.
4. Em "Nível de automação", selecione o nível que se ajusta ao repositório:
   * **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.
5. Clique em **Salvar**.

## Com agente de nuvem Copilot

1. Crie um Automação para fazer a triagem de problemas, seguindo [Criando automações com Copilot agente de nuvem](/pt/copilot/how-tos/use-copilot-agents/cloud-agent/create-automations). Use o gatilho **Quando um item é criado** ou execute o Automação em uma programação.
2. Conceda ao Automação as ferramentas para gerenciar problemas relacionadas aos atributos que você deseja que ele altere, como atualizar rótulos, definir o tipo, editar campos, atribuir usuários ou fechar problemas.
3. No prompt, descreva a tarefa de triagem, por exemplo: `Triage this issue by setting a type, labels, and priority, and explain your reasoning for each.` você não precisa mencionar racionalidade, confiança ou sugestões explicitamente. Para reter determinadas alterações para revisão, independentemente do nível de confiança, peça ao agente que sugira essas alterações em vez de aplicá-las.
4. Salve o Automação. Quando ele é executado, suas mudanças carregam uma lógica e um nível de confiança. As alterações abaixo do nível de automação do repositório e as alterações que você pediu ao agente para sugerir aguardam no painel de aprovações sobre o problema.

## Com Fluxos de trabalho agênticos do GitHub

As intenções de problema, os metadados de lógica e confiança anexados às alterações de problema de um fluxo de trabalho são opcionais e habilitados por padrão. Os fluxos de trabalho existentes continuam funcionando sem alterações.

1. Atualize para a versão mais recente da Fluxos de trabalho agênticos do GitHub extensão executando `gh aw upgrade`.
2. Adicione um fluxo de trabalho que triageia problemas ao diretório do `.github/workflows` repositório. Você pode começar com um exemplo de triagem de problemas ou criar o seu próprio. Consulte a [Fluxos de trabalho agênticos do GitHub](https://gh.io/gh-aw) documentação.
3. Forneça ao fluxo de trabalho as saídas dos atributos que você deseja que ele altere listando-os `safe-outputs` no frontmatter do fluxo de trabalho. Por exemplo, `add-labels` para aplicar rótulos, `set-issue-type` definir o tipo de problema, `set-issue-field` editar campos `assign-to-user` ou `assign-to-agent` atribuir problemas e `close-issue` fechá-los. Adicionar essas saídas é suficiente para que o fluxo de trabalho faça as alterações de problema correspondentes com um nível de racionalidade e confiança.
4. Opcionalmente, controle se uma saída segura requer metadados de intenção do problema definindo `issue-intent` nela:

   ```yaml
   safe-outputs:
     add-labels:
       issue-intent: true
   ```

   * Omita `issue-intent` ou deixe-o não definido para que continue opcional: o agente é incentivado a fornecer uma justificativa e um nível de confiança, mas a saída ainda funciona sem isso.
   * Defina `issue-intent: true` para exigir uma justificativa e um nível de confiança para essa saída. O fluxo de trabalho falhará se o agente os omitir.
   * Defina `issue-intent: false` para desativar completamente: a saída nunca inclui metadados de justificativa nem de confiança.
5. No prompt de fluxo de trabalho, descreva a tarefa de triagem. Para reter alterações específicas para revisão, independentemente do nível de confiança, peça ao agente que sugira essas alterações em vez de aplicá-las.
6. Compile o fluxo de trabalho executando `gh aw compile`e confirme o arquivo de fluxo de trabalho e seu arquivo de bloqueio gerado.
7. Quando o fluxo de trabalho é executado, suas alterações vêm acompanhadas de uma justificativa e de um nível de confiança (a menos que você tenha optado por não participar). As alterações que estão abaixo do nível de automação do seu repositório e quaisquer alterações sugeridas pelo agente ficam aguardando no painel de aprovações na issue.

## Com a API REST ou a API GraphQL

Se você criar sua própria integração em vez de usar uma Automação, poderá usar as mesmas APIs REST e GraphQL de gravação de problemas para incluir um nível de racionalidade e confiança com uma alteração ou marcar uma alteração como uma sugestão para mantê-la para revisão. A alteração é encaminhada da mesma forma que uma alteração de um Automação ou de um fluxo de trabalho Fluxos de trabalho agênticos do GitHub: fica sujeita ao nível de automação do seu repositório ou é mantida para revisão caso você a tenha marcado como sugestão.

## Identificando problemas em sugestões pendentes

Para encontrar problemas que tenham sugestões aguardando revisão, pesquise usando o `has:suggestions` qualificador, por exemplo `is:issue is:open has:suggestions`.

## Analisando sugestões no painel de aprovações

Quando uma alteração é realizada para revisão, ela aguarda em um painel de aprovações sobre o assunto em vez de entrar em vigor. Use o painel para inspecionar cada sugestão e decidir o que aplicar.

1. Abra o problema. As alterações sugeridas aparecem no painel de aprovações.
2. Inspecione cada sugestão. Ele exibe a alteração proposta, como um rótulo, tipo, campo, responsável ou fechamento, juntamente com a justificativa e o nível de confiança.
3. Aja de acordo com as sugestões:
   * Selecione **Aceitar** para aplicar uma sugestão ou **Recusar** para descartá-la.
   * Selecione **Aceitar tudo** ou **Recusar tudo** para agir em cada sugestão pendente ao mesmo tempo.

As alterações aceitas entrarão em vigor sobre o problema imediatamente. As sugestões recusadas são descartadas sem alterar o problema.

Pronto para colocar isso em prática? Veja [Criando automações com Copilot agente de nuvem](/pt/copilot/how-tos/use-copilot-agents/cloud-agent/create-automations) para criar um Automação que faça a triagem de problemas para você.