Todas as coleções

Avaliação de Playbooks no Add-In do Word

Quando você aplica um Playbook a um documento no Add-In do Word, o August avalia seu documento em relação a cada regra e apresenta resultados nos quais você pode agir. Este guia explica o fluxo de trabalho de avaliação, como interpretar os resultados e como trabalhar com as sugestões de edição.

Executando uma Avaliação de Playbook

Ao anexar um Playbook e iniciar uma revisão, o August executa uma avaliação em relação às suas regras definidas:

  1. Anexe seu Playbook na barra lateral do Add-In do Word.

  2. Inicie a avaliação — o August começa a analisar o documento em relação às regras do seu playbook.

  3. Acompanhe o progresso — um indicador de progresso mostra a fase atual da avaliação.

A barra de progresso avança por estas fases enquanto o August trabalha:

  • Preparando — Inicializando a avaliação

  • Lendo o documento — Analisando e compreendendo a estrutura do documento

  • Revisando cláusulas — Verificando cada cláusula em relação às regras do playbook

  • Analisando descobertas — Determinando o status de correspondência e identificando problemas

  • Rascunhando edições — Gerando sugestões de alterações onde aplicável

  • Verificando edições — Validando as alterações propostas

  • Finalizando — Preparando os resultados para revisão

  • Concluído — Avaliação finalizada, resultados prontos

O indicador de progresso é otimista e monotônico — ele mostra o progresso para frente, mas não é um contador de passos literal. Ele estima a conclusão com base nas regras revisadas e edições processadas.

Você pode interromper uma avaliação no meio da execução, se necessário. Clique em Stop para pausar o processo e revisar os resultados parciais. O botão Stop e o indicador de processamento estão sincronizados com o estado da avaliação — quando você para, a interface reflete que nenhum processamento adicional está ocorrendo.

Compreendendo os Resultados da Avaliação

Cada regra do playbook produz um resultado com um status de correspondência:

Status

Significado

Satisfeita

A cláusula corresponde à sua posição preferencial ou a uma alternativa aceitável.

Alternativa (Fallback)

A cláusula corresponde à redação alternativa, mas não à posição preferencial.

Inaceitável

A cláusula contém redação que você sinalizou como inaceitável.

Não Aplicável

A regra não se aplica a esta seção do documento.

Resultados que precisam de atenção aparecem com um indicador Needs attention, ajudando você a focar nas regras que exigem revisão em vez de correspondências satisfeitas.

Trabalhando com Sugestões de Edição

Para regras com status NotAcceptable ou Fallback, o August pode gerar sugestões de edição que aproximam a cláusula da sua posição preferencial.

Visualizando Sugestões de Edição

Cada resultado de regra mostra citações que vinculam a locais específicos do documento. Clique em uma citação como [1] ou [2] para pular diretamente para esse trecho em seu documento.

Quando sugestões de edição estão disponíveis, elas aparecem como uma Suggested edit com uma prévia da alteração proposta. Você pode:

  • Aplicar — Aceitar a edição sugerida

  • Descartar — Remover a sugestão da sua lista

Escolhendo uma Posição Diferente

Por padrão, as sugestões de edição são geradas em relação à sua Starting position — a redação preferencial definida na regra do seu playbook. Para regras com posições alternativas, você pode optar por regenerar as edições a partir de uma posição diferente:

  1. Clique no seletor de posição rotulado como Change playbook position.

  2. Selecione entre as opções disponíveis: Starting position, Fallback 1, Fallback 2 e alternativas adicionais, se houver.

  3. Clique em Suggest edits para regenerar sugestões de edição com base na posição selecionada.

Isso é útil quando você deseja propor uma edição alinhada a uma alternativa em vez de insistir na posição preferencial — por exemplo, em negociações onde a posição preferencial dificilmente será aceita.

Alterar a posição regenera apenas as sugestões de edição pendentes para essa regra. Edições aplicadas e revisões concluídas não são afetadas.

Regenerando Sugestões

Se a regeneração falhar — por exemplo, se o sistema não conseguir encontrar os dados da regra ou não conseguir determinar a redação preferencial — você verá uma mensagem de erro. Tente novamente ou selecione uma posição diferente. Sugestões descartadas são filtradas e não reaparecerão, a menos que você as regenere.

Aplicando Alterações

Depois de revisar as sugestões individuais:

  • Aplicar edições individuais — Aceite ou descarte cada sugestão diretamente na visualização de detalhes da regra.

  • Aplicar todas as alterações — Aceite todas as sugestões de edição pendentes de uma só vez.

Quando você aplica alterações, elas aparecem como alterações controladas no seu documento Word, permitindo que você as revise em contexto antes de finalizar.

Após a aplicação, os indicadores de status são atualizados para refletir as ações concluídas. Clique em Done quando terminar com uma regra, ou em Close evaluation para sair completamente da visualização de avaliação.

Adicionando Notas de Execução

Ao iniciar uma avaliação de playbook, você pode fornecer run notes (notas de execução) — orientações opcionais específicas para aquela execução da avaliação. As notas de execução ajudam a adaptar a revisão ao contexto atual:

  • Considerações especiais para este documento ou negócio em particular

  • Contexto de negociação que afeta quais posições priorizar

  • Preferências específicas do cliente que diferem do playbook padrão

As notas de execução são anexadas à execução da avaliação, não sendo salvas permanentemente no playbook em si. Isso permite que você forneça um contexto específico da execução sem modificar as regras do seu playbook.

Solução de Problemas

A avaliação não retorna resultados

Se a avaliação for concluída, mas não mostrar resultados, o playbook pode não ter regras aplicáveis a este tipo de documento, ou a estrutura do documento pode não corresponder aos padrões esperados. Tente um playbook diferente ou verifique se as regras do seu playbook são específicas o suficiente.

Não foi possível regenerar as edições para a nova posição

A regeneração pode falhar se a posição selecionada não tiver dados de redação suficientes ou se a estrutura da regra não suportar a posição solicitada. Selecione uma posição diferente ou verifique se a regra do seu playbook possui definições de alternativas completas.

Edição descartada inesperadamente

Sugestões descartadas são filtradas da sua lista. Se você descartou uma edição por engano, regenere as sugestões para essa regra para vê-la novamente.

Indicador de processamento travado ou o botão Stop permanece visível

Se o indicador de processamento parecer travado ou o botão Stop permanecer visível após o término de uma avaliação, atualize a barra lateral do Add-In do Word. O estado da avaliação é sincronizado com a IU de processamento, portanto, após parar ou concluir, a interface deve retornar ao estado pronto. Se o problema persistir, feche e reabra o documento para redefinir a sessão de avaliação.

O que ler a seguir

Isso foi útil?