Escalations
Um escalonamento é o registro de algo que precisa de uma pessoa. Quando uma execução de correção pausa precisando de você, o Polylane registra o pedido uma vez e avisa uma vez, por mais execuções que batam na mesma parede.
O que faz
Cada escalonamento carrega um tipo, um título que diz o que está errado e o que você precisa fazer, e algumas frases de detalhe. Uma segunda execução de correção bloqueada na mesma remediação se agrupa no escalonamento aberto em vez de notificar de novo: a contagem sobe e a thread mais recente se junta às suas referências. Um escalonamento levantado contra uma issue também entra na linha do tempo de atividade dessa issue.
De onde vêm os escalonamentos
| Tipo | Rótulo | Descrição |
|---|---|---|
needs_human_action | Needs your action | A correção exige algo que só você pode fazer. |
needs_decision | Awaiting your decision | O agente precisa de uma decisão sua antes de continuar. |
failed | Agent stuck | A execução encontrou um erro que não conseguiu contornar. |
Como funciona
- Uma execução de correção pausa em um dos tipos acima e levanta o pedido.
- O Polylane o compara com os escalonamentos abertos, de forma exata quando a origem fornece uma chave e por similaridade de texto nos demais casos, e o agrupa em uma correspondência.
- Um primeiro registro notifica você uma vez; um agrupado fica em silêncio.
- Mark as handled encerra o registro, e a resolução da issue também. Um escalonamento encerrado para de absorver repetições, então uma recorrência notifica de novo; Reopen no mesmo cartão, ou pela API, o coloca de volta se o pedido não foi de fato atendido.
- A correspondência expira 24 horas após a última ocorrência, então um problema que persiste volta a se manifestar.
Você também pode criar escalonamentos pela API para colocar seus próprios pedidos na mesma lista. Listar exige uma chave de API com o escopo analytics:read e escrever exige issues:write; veja a referência da API.
Onde encontrar
Abra Escalations no console para ver os pedidos pendentes. Pesquise na lista ou selecione Handled ou All para encontrar pedidos anteriores. Cada escalonamento tem uma página com a descrição completa, as issues e threads de origem, a linhagem e o histórico de ocorrências. Use Mark as handled quando o pedido estiver concluído ou Reopen se ainda precisar de atenção. O campo _html_url da API aponta diretamente para essa página, inclusive para escalonamentos sem thread.
Um escalonamento também aparece na thread que o levantou. O cartão de resultado abre o pedido, com Open full page para ver o registro completo. Em Threads, o preset Needs you lista as threads cuja execução aguarda uma pessoa.
Relacionado
- Execuções de correção para os resultados de pausa que levantam escalonamentos.
- Threads para o preset Needs you e a página da execução.
- Issues para os registros aos quais os escalonamentos apontam de volta.
- Notificações para as configurações de e-mail por trás do que o Polylane envia a você.
Execuções de correção
Um agente por issue chega ao veredito, rastreia a causa e abre a pull request, em uma única thread que você lê de cima a baixo.
Autofix
Correções escritas por agentes chegam como pull requests no seu repositório. Você revisa e faz o merge; o Polylane lembra você e arruma o que ninguém toca.