Execuções e aprovação

Cada vez que um agente responde uma mensagem, ou quando você testa um agente, o BotoZap registra uma execução: o que o agente respondeu, quais ferramentas usou (consultar o funil, abrir um caso, agendar um retorno), quanto consumiu e se algo deu errado. Em IA › Execuções você confere tudo isso e descobre por que o agente fez o que fez.

É também por aqui que você aprova ou rejeita as respostas que esperam decisão: no modo assistido ou quando uma verificação de segurança segura a resposta.

Antes de começar

• Escolha o cliente no seletor do topo. Sem cliente, a tela pede Selecione um Cliente para consultar execuções.
• Você consulta, aprova e rejeita as execuções. Se a conta tiver equipe, qualquer pessoa dela faz o mesmo, seja Operador ou Administrador. Vale também para as mensagens de follow-up que esperam aprovação e para conciliar as de resultado incerto. Veja Follow-ups.

Ver o que o agente fez

1. Abra IA › Execuções. A visão Execuções dos agentes já vem selecionada.
2. Filtre por Agente e por Situação, se quiser. As situações são Em execução, Aguardando horário, Concluída, Aguardando aprovação, Falhou, Resultado incerto, Interrompida por alteração e Rejeitada. Os mesmos nomes aparecem na aba Execuções de cada agente.
3. A tabela mostra o Agente, a Origem (Atendimento automático, Atendimento assistido, Teste ou Operador), a Situação, quantas Ferramentas foram usadas e Quando.
4. Clique numa linha para abrir o detalhe ao lado. Você vê:
   • Resposta: o texto que o agente escreveu (Resposta aguardando aprovação, quando ela espera decisão);
   • o quadro Proteção, com as verificações de segurança dessa resposta (veja abaixo);
   • Ferramentas: cada ação que o agente usou ou planejou, com o nome que aparece no editor do agente, a situação (Concluída, Simulada, Rejeitada, Resultado incerto ou Bloqueada) e um resumo do que o agente pediu e do que voltou;
   • Consumo: Entrada, Saída e Tempo da chamada à IA;
   • o motivo, quando a execução falhou (por exemplo, "O limite mensal de IA interrompeu esta execução.").
5. No rodapé do detalhe, Abrir atendimento leva à conversa e Abrir agente leva à aba Execuções do agente. Se a execução espera decisão, os botões Aprovar e enviar e Rejeitar também ficam ali.

Códigos internos e os dados completos de cada ferramenta ficam recolhidos em Detalhes técnicos. Você só precisa abrir esse bloco se o suporte pedir.

Todas as inferências

A segunda visão, Todas as inferências, lista cada chamada feita à IA pelo cliente, não só as respostas dos agentes. Entram também o roteamento, os follow-ups, a consulta interna dos casos, o aprendizado, a leitura de imagens e áudios, a base de conhecimento e as propostas comerciais.

1. Clique em Todas as inferências.
2. Escolha o Período (Últimas 24 horas, Últimos 7 dias, Últimos 30 dias ou Últimos 90 dias) e, se quiser, filtre por Ponto, Finalidade, Resultado ou Agente.
3. O quadro Está tudo bem? resume as falhas do período. Para cada tipo de falha, ele diz a Causa, O que aconteceu e O que fazer.
4. Clique numa chamada para ver o modelo usado, Por que este modelo foi escolhido e o Custo.

Use essa visão quando o gasto em Uso e orçamento subir sem explicação, ou quando algo da IA parar de funcionar e você não souber onde.

Modo assistido: aprovar antes de enviar

No modo Assistida, o agente prepara a resposta e as ações, mas nada sai sem alguém da equipe aprovar. É o jeito mais seguro de começar com um agente novo: você vê o que ele faria e só libera quando estiver bom.

Para trocar o modo:

1. Abra o agente em IA › Agentes.
2. Clique no botão de situação no topo da página, ao lado do nome do agente.
3. Em Modo de operação, escolha Assistida ("A resposta fica para revisão humana.") ou Automática ("A versão publicada conduz o atendimento conforme as permissões.").

Aprovar ou rejeitar

A decisão é a mesma em qualquer lugar em que você a encontrar, com os mesmos botões:

• na conversa, onde a resposta aparece como Resposta da IA aguardando aprovação;
• em IA › Execuções, no detalhe da execução (filtre a Situação por Aguardando aprovação para ver todas);
• na aba Execuções do agente.

O alerta Resposta do agente retida para revisão, em IA › Casos e no sino, tem o botão Aprovar ou rejeitar a resposta, que abre essa execução em IA › Execuções.

1. Leia a resposta. Em IA › Execuções e na aba do agente, confira também as Ferramentas: as ações marcadas como Simulada são o plano que só acontece se você aprovar.
2. Clique em Aprovar e enviar ou em Rejeitar.
3. Confirme em Confirmar envio ou em Confirmar rejeição. Quando há ações planejadas, a pergunta diz quantas serão executadas junto com o envio. Rejeitar descarta a resposta e o plano, e nada é enviado.

Na conversa, o link Ver ações e proteção da execução abre a mesma execução em IA › Execuções, com as ações planejadas e o quadro Proteção.

Nas execuções do Operador, os botões são Aprovar ações e Rejeitar: a aprovação libera só ações internas e não envia mensagem à conversa.

Ao aprovar, o BotoZap confere de novo a versão do agente, a chave de IA e se o atendimento ainda está disponível. Se alguém da equipe assumiu a conversa nesse meio-tempo, por exemplo, o envio não acontece.

Verificações de segurança

Antes de uma resposta sair, o BotoZap passa por verificações automáticas. O quadro Proteção mostra o que foi conferido. Ele aparece no detalhe de cada execução em IA › Execuções e na aba Execuções do agente:

• Detector de manipulação: procura mensagens do contato tentando fazer o agente ignorar as regras, trocar de papel ou revelar instruções internas.
• Avaliação antes do envio: lê a resposta e barra, por exemplo, preço ou condição sem fonte, promessa não autorizada ou uma resposta fora do escopo do agente.
• Ajustes de estilo: correções de texto aplicadas antes do envio, se estiverem ligadas em Estilo das respostas.
• Sinal de urgência: marca mensagens que parecem relatar urgência ou risco.

Cada verificação mostra o resultado: aprovado, sinalizado, bloqueado, barrado, retido para revisão ou indisponível (retido).

Mesmo no modo Automática, uma resposta pode ficar Aguardando aprovação quando uma verificação a segura. O título do quadro fica Proteção · resposta retida e explica o motivo. Por exemplo: possível manipulação, avaliação que barrou a resposta mesmo depois de uma reescrita, ou detector que não conseguiu concluir. Nesses casos, você também recebe um alerta em Casos e alertas, e a decisão é a mesma: aprovar, rejeitar ou responder você mesmo pelo atendimento.

O que acontece depois

• A resposta aprovada é enviada, e a execução passa para Concluída.
• A resposta rejeitada fica como Rejeitada, e nada é enviado ao contato.
• Se a entrega não puder ser confirmada, a execução fica Resultado incerto. O BotoZap não repete o envio sozinho, para não duplicar mensagem. Veja como conferir em Prestação de contas.

Problemas comuns

No lugar dos botões aparece "Não foi possível confirmar sua permissão para aprovar ou rejeitar. Atualize a página." O BotoZap não conseguiu confirmar agora que você faz parte da conta. Atualize a página; se continuar, entre de novo.

Aprovei, mas a mensagem não saiu. A aprovação confere tudo de novo. Se o atendimento mudou (alguém assumiu a conversa, o contato deixou de estar liberado em Acesso da IA) ou a janela de 24 horas fechou, o envio é recusado. Abra o atendimento e responda por lá.

Muitas respostas ficam retidas no modo automático. Abra o quadro Proteção das execuções retidas e veja o motivo que se repete. "Preço/condição sem fonte" costuma indicar que falta a informação na base de Conhecimento. "Fora do escopo" pede um ajuste nas instruções do agente.

A execução falhou com "O limite mensal de IA interrompeu esta execução." O orçamento do mês acabou. Ajuste em Uso e orçamento.

A execução aparece como "Interrompida por alteração". Algo mudou no atendimento enquanto o agente ainda trabalhava, e o BotoZap parou a execução para o agente não agir com informação velha. Abra o atendimento para ver a situação atual.