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

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

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 Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

   

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. 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 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:

   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 compilee 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 para criar um Automação que faça a triagem de problemas para você.