Execuções de correção
Uma execução de correção é o agente trabalhando uma issue. Cada issue recebe no máximo uma: uma thread do tipo fix_run que chega ao veredito e, em um problema confirmado, continua trabalhando até a correção na mesma conversa.
O que faz
A thread é onde você lê toda a história: o trabalho conforme acontece, as evidências a um clique de distância na sua linhagem, e o resultado ao final. A execução lê o alerta ou a descoberta, a consulta por trás dela, métricas e logs recentes em torno do disparo, mudanças recentes e o seu código. Antes de agir, ela escreve a cadeia causal na thread: o sinal, o mecanismo, o componente e o caminho de código que o produzem, o gatilho e o raio de impacto, cada elo respaldado por evidências nomeadas ou marcado como desconhecido.
Como funciona
- Uma execução começa quando uma verificação ou um alerta conectado produz uma descoberta, quando um agente em uma thread de chat abre uma issue a partir do problema que você está discutindo, ou quando você escolhe Investigate em uma issue.
- O agente lê as evidências e chega a um de dois vereditos,
confirmedoudismissed. Uma descoberta que corresponde a uma issue existente se junta a ela em vez de iniciar uma segunda execução. - Em um problema confirmado, o mesmo agente rastreia a causa e escreve a cadeia causal.
- Quando uma mudança de código corrige a causa em um repositório conectado, a execução abre a pull request por meio do autofix. Quando nenhuma pull request pode corrigi-la, a execução levanta um escalonamento que nomeia o que uma pessoa precisa fazer.
- Toda etapa entra na linha do tempo de atividade da issue, ao lado de detecções, redetecções e das suas próprias notas.
Resultados
Após cada turno do agente, o Polylane classifica a execução.
| Resultado | Descrição |
|---|---|
resolved | Causa raiz encontrada e o problema está corrigido ou se recuperou. |
diagnosed | Causa raiz encontrada, mas a correção ainda não chegou. |
inconclusive | O agente não conseguiu se decidir sobre uma causa. |
false_positive | A descoberta não apontava para um problema real. |
failed | A execução terminou em um erro. |
Uma execução também pode pausar, o que impede o monitoramento de cutucá-la para reinvestigar até que a issue se resolva.
| Estado de pausa | Descrição |
|---|---|
needs_human_action | A correção exige algo que só você pode fazer. |
needs_decision | O agente precisa de uma decisão sua antes de continuar. |
awaiting_change | O agente está aguardando uma correção ser entregue, por exemplo uma pull request aguardando revisão. Este estado pausa em silêncio. |
failed | A execução encontrou um erro que não conseguiu contornar. |
Os três estados que precisam de uma pessoa são registrados como escalonamentos, mostrados no cartão de resultado na thread e listados no preset Needs you, para que o mesmo pedido nunca notifique você duas vezes.
Onde encontrar
As execuções de correção aparecem em Threads ao lado das threads de chat, e o preset Needs you lista as que aguardam uma pessoa. A Lineage na barra lateral da thread guarda o registro por trás da execução: Issue abre as evidências e a linha do tempo da issue, Escalation abre o que o agente pediu de você com Mark as handled, e Check abre a avaliação que detectou o problema. O menu da issue carrega Investigate, Investigate again, View investigation e View triggering check.
Configurar
Em Settings > Workspace, o cartão Investigations define Investigate automatically from: a menor severidade que inicia uma execução de correção por conta própria. Issues abaixo dela mantêm seu veredito e ficam retidas, e a thread delas oferece Start investigation para que alguém do seu time as assuma. Vereditos nunca são retidos: toda issue confirmada é visivelmente confirmada, e o piso só adia o trabalho que vem depois.
Relacionado
- Issues para o registro que toda execução de correção trabalha.
- Threads para ler, parar e compartilhar a execução.
- Escalations para os pedidos que uma execução pausada levanta.
- Autofix para a pull request que uma execução abre.
Threads
Toda execução de agente é uma thread que você pode acompanhar, interromper, compartilhar e continuar, a partir do console, do Slack, da CLI ou da API.
Escalations
A lista única do que os agentes precisam de você: um registro por pedido, por mais que ele se repita, encerrado quando você o trata.