O recurso de explicação gera um resumo e uma descrição passo a passo da automação do Co-Pilot for Automators (Co-Pilot).

À medida que o desenvolvimento progride, especialmente em compilações de várias fases e de longa duração, as equipes perdem rotineiramente o contexto de seu trabalho. A automação evolui por meio de ciclos iterativos de prompt, compilações parciais, refatorações e alterações incrementais de condições. Nestas condições, o valor do recurso de explicação não é apenas um resumo, mas uma representação estruturada e inspecionável da lógica operacional atual na tela, permitindo que os desenvolvedores se reorientem rapidamente, revisem a correção e decidam o que melhorar em seguida.

Visão geral do recurso Explicar

Ao usar o recurso Explicar, o Co-Pilot analisa a automação conforme a última versão salva e gera uma explicação que normalmente inclui:

  • Uma visão geral de alto nível do que a automação pretende realizar, com base na estrutura atual e na lógica configurada.

  • Um detalhamento passo a passo que identifica onde as operações começam, como a execução progride e como os dados/saídas fluem de uma etapa para outra.

  • Visibilidade de condição e ramificação, destacando portas lógicas (lógica if/else, filtros, regras de elegibilidade, exceções) que podem alterar o comportamento ou os resultados do tempo de execução.

  • Contexto operacional, esclarecendo o que cada etapa está fazendo em termos funcionais (não apenas reafirmando rótulos), o que é especialmente útil quando as etapas foram criadas em várias iterações.

Isso foi projetado para ajudar os desenvolvedores a responder rapidamente: “O que essa automação faz agora?” e “Onde posso intervir para mudar o comportamento com segurança?”

Casos de uso do recurso Explicar

Use o recurso Explicar sempre que precisar restabelecer um entendimento comum ou reduzir o risco de fazer uma alteração no lugar errado. Momentos comuns e de alto valor incluem:

  • Depois de várias rodadas de edições orientadas por solicitações (o desvio de lógica é comum; /explain reposiciona a equipe no comportamento atual).

  • Antes de refatorar ou estender a automação (confirme a intenção atual e identifique o ponto de inserção correto).

  • Ao depurar resultados inesperados (identifique rapidamente as condições e ramificações que podem estar redirecionando a execução).

  • Durante a revisão do código ou a transferência para outro desenvolvedor/equipe (crie uma narrativa consistente da automação para revisão e integração).

  • Após mesclar contribuições de vários colaboradores (valide se a lógica combinada ainda corresponde aos resultados pretendidos).

  • Quando a automação se torna demorada e não é mais óbvio onde a configuração e as validações terminam e quais etapas geram os resultados desejados.

Resumindo: use-o sempre que o custo de não entender o comportamento atual for maior do que o custo de uma análise rápida.

Explique todo o cenário ou os itens selecionados

Você pode explicar a automação como um todo quando precisar recuperar rapidamente o contexto ou validar o comportamento atual, ou explicar uma seção ou linha específica.
  • Para explicar a automação inteira, digite /explain na interface. Certifique-se de que nenhum nó ou linha de automação esteja selecionado.
  • Para explicar uma seção, selecione seus itens ou linhas específicos e digite /explain na interface.

Esse recurso reduz a carga cognitiva e aumenta a confiança de que as modificações estão sendo feitas no local correto.