Cartão de alterações propostas: o design da aprovação humana

O que é o cartão de alterações propostas?

É o componente do chat que materializa a regra central da PowerVizion: o agente propõe, a pessoa decide. Quando o agente quer editar um flow existente, ele não aplica a mudança. Ele prepara um cartão, "Alterações propostas", com a lista do que mudaria, e espera.

O cartão mostra o nome do flow e a contagem de mudanças, com a frase "o agente preparou estas mudanças e está aguardando sua decisão".

O desenho segue um padrão conhecido de interfaces para agentes: pausar o fluxo, mostrar o que está em jogo e pedir uma decisão clara. O nome "cartão" reflete o formato: um bloco compacto, com cabeçalho, lista e ações, que cabe no fluxo da conversa sem tirar a pessoa dela.

Como o cartão mostra a mudança

Cada alteração é uma linha com um símbolo e um texto curto. O formato lembra o diff de código, familiar a quem revisa mudanças: um sinal de mais para adição, um til para modificação e um sinal de menos para remoção.

Cada linha traz uma descrição e um detalhe em texto menor. A pessoa lê o que vai mudar antes de qualquer botão. A ideia é que decidir seja uma leitura de poucos segundos, não uma investigação.

Cada tipo de mudança tem cor própria, mas o símbolo carrega o significado, de modo que a leitura não depende só da cor. O detalhe em texto menor existe para quem quer conferir: a linha principal diz o que muda, e o detalhe diz como.

• Adições: nós ou conexões novas no flow.
• Modificações: ajustes em nós ou conexões que já existem.
• Remoções: o que sairá do flow.
• Se não há nenhuma mudança, o cartão nem aparece.

As três decisões e por que são três

Aprovar, solicitar ajustes e rejeitar. Um simples sim ou não obrigaria a pessoa a rejeitar uma proposta quase boa e a recomeçar a conversa. Com "solicitar ajustes", ela registra que a proposta não serve como está e descreve o que quer mudar na mensagem seguinte.

Há também um atalho para abrir o flow no canvas, para conferir a mudança no contexto dela. O botão de aprovar tem destaque visual, e os demais são secundários, mas nenhum fica escondido. A rejeição também limpa a edição pendente, de modo que nada fica esperando em segundo plano.

O que acontece depois da decisão

O cartão colapsa para um resumo com a decisão, como "Aprovado", "Ajustes solicitados" ou "Rejeitado", em vez de continuar clicável para sempre. A decisão é gravada na própria mensagem, então sobrevive a recarregar a página.

A central de atividade e as notificações usam o mesmo estado: quando a decisão existe, a mudança deixa de ser contada como pendente. A mesma decisão também pode ser tomada por esses atalhos, sem abrir a conversa.

Esse é o ponto que mais pesa no design: uma pendência que não some depois de decidida vira ruído, e ruído faz as pessoas deixarem de olhar.

Como a PowerVizion aborda a confirmação em outras ações

Nem toda aprovação é um cartão. Para ações de escrita em geral, o agente pede uma confirmação em texto, e o servidor interpreta a resposta com cuidado: "confirmo" e "autorizo" valem, afirmações curtas como "sim" só valem como resposta a uma pergunta de confirmação, qualquer negação vence, e anexos nunca contam como autorização.

O admin escolhe, nos guardrails, em quais ações exigir confirmação: nenhuma, só escrita (o padrão) ou todas.

Em ambos os casos, o princípio é o mesmo: nenhuma ação de escrita é executada sem uma confirmação clara de quem pode decidir. Essa interpretação é feita no servidor, e não depende da tela.

Exemplo ilustrativo: ajustando um flow

A ELISA propõe, para um flow de triagem, adicionar um nó de condição e alterar o texto de uma pergunta. O cartão mostra duas linhas, uma adição e uma modificação. A pessoa vê o detalhe e escolhe solicitar ajustes, pedindo que a condição use outro critério.

A ELISA gera uma nova proposta, e então a pessoa aprova. As duas decisões ficam registradas, e o cartão antigo mostra "Ajustes solicitados". É um exemplo ilustrativo do desenho.

Cada passo dessa conversa é visível no histórico do chat, o que ajuda a entender depois como a decisão foi tomada.

Limites atuais

Hoje, aprovar uma edição de flow pelo cartão incrementa a versão do flow no aplicativo e atualiza a contagem de nós, mas ainda não existe uma rota de servidor que recalcule o grafo real a partir do diff. A aprovação é registrada, e o efeito completo sobre o flow salvo está em evolução.

A confirmação em texto também não é um token de uso único que amarre a decisão a uma ação específica. Esse vínculo mais forte entre aprovação e ação ainda é trabalho futuro, sem data.

Por fim, o cartão cobre edições de flow. Outros tipos de ação seguem a confirmação em texto descrita acima, e padronizar a experiência entre eles é uma decisão de design ainda em aberto. Para quem precisa de rastreabilidade forte hoje, o complemento é a auditoria dos agentes e dos handoffs.

Perguntas frequentes

O que é o cartão de alterações propostas?

É o cartão do chat em que o agente mostra as mudanças que quer fazer em um flow e pede a decisão de uma pessoa: aprovar, solicitar ajustes ou rejeitar.

Por que existe a opção "solicitar ajustes"?

Porque uma proposta pode estar quase certa. A pessoa registra que ela não serve como está e descreve a correção na próxima mensagem, sem recomeçar.

A decisão fica registrada?

Sim. Ela é gravada na própria mensagem do chat, sobrevive a recarregar a página e tira o item da lista de pendências.

O agente aplica a mudança antes da aprovação?

Não. O agente só propõe. A edição é aplicada depois que a pessoa aprova.