Simulações permitem validar Procedimentos Fin, aumentar a confiança na sua automação e identificar problemas antes que afetem seus clientes. Ao modelar conversas completas, as simulações ajudam sua equipe a lidar com cenários complexos ou de alto volume, como cancelamentos e reembolsos, com certeza.

Projetadas para substituir verificações manuais demoradas, as simulações ajudam a identificar problemas ou mudanças graduais no comportamento do Fin conforme a lógica do seu negócio evolui.

Acessando simulações

As simulações estão localizadas no painel de testes de um Procedimento. Para acessá-las:

Abra o Procedimento que deseja testar.
Clique em Test no canto superior direito da tela.
Selecione a aba Simulations no painel à direita.

Simulações ignoram o reconhecimento de intenção. Diferente do Preview ou conversas ao vivo, simulações não verificam suas instruções 'When to use this Procedure', assumem que o Procedimento já foi acionado e o executam diretamente. Isso torna as simulações ideais para testar a lógica de execução isoladamente.
Importante:
- Preview cria uma conversa de teste na sua inbox (excluída dos relatórios) e nunca envia nada para um cliente real. Por padrão, Data Connectors retornam dados de exemplo. Chamadas reais de API só ocorrem se você testar como um usuário específico e selecionar "Access and update real user data when triggered" nas configurações do Preview, caso em que quaisquer ações do seu Procedimento (como reembolsos ou atualizações de registro) são executadas para esse usuário. Use uma conta de usuário de teste.
- Simulations nunca chamam sistemas externos. Fin usa os valores de teste que você define, tornando-as a forma mais segura de validar a lógica antes de ir ao vivo.
Use Preview para verificações rápidas; execute Simulations antes de cada publicação.

Criando uma simulação

Você pode criar uma simulação de duas formas: usando sugestões geradas por AI para um início rápido, ou definindo manualmente o cenário para controle total.

Simulações geradas por AI: Use estas para cobrir rapidamente cenários comuns ou esperados de clientes com base em suas instruções. Fin AI gera testes "prontos" para economizar seu tempo.

Simulações manuais: Use estas quando precisar de controle preciso sobre dados, casos específicos ou ramos particulares na sua lógica.

Simulações geradas por AI

Com base em suas instruções, Fin AI gerará testes iniciais para ajudar você a criar rapidamente simulações "prontas".

Abra a aba Simulations no painel direito do seu Procedimento.
Em Suggested for these instructions, revise a lista de cenários propostos (ex.: "Full cancellation request").
Clique no ícone de Play ao lado de uma sugestão para executá-la instantaneamente.
Uma vez criada ou aceita uma simulação das sugestões, ela aparecerá na sua lista. Você pode então clicar em Run all para executar todas as simulações salvas de uma vez.

Simulações criadas manualmente

Você também pode construir uma simulação do zero para testar casos específicos com base nas instruções do Procedimento.

Na aba Simulations, clique em + New.
Nome da simulação: Dê um título claro para sua simulação.
Simular como: Escolha um usuário ou marca específica para testar a personalização. Você pode selecionar na lista suspensa de usuários reais no seu workspace.
Mensagem inicial do cliente: Insira a primeira mensagem enviada pelo cliente (ex.: "Preciso de ajuda com meu pedido"). Você também pode anexar uma imagem, como uma captura de tela de um erro, para testar como o Fin lida com contexto visual.
Detalhes adicionais: Forneça orientações sobre a situação do cliente ou ações específicas que ele tenha tomado.

Selecione um canal

Simulações permitem selecionar o canal que o Fin usará para esta simulação, para que você possa testar como o Fin se comporta. Use o menu suspenso de canais para alternar entre Messenger e Email antes de executar sua simulação.

Nota: O Fin se comporta de forma diferente dependendo do canal. No Email, o Fin agrega várias informações em uma única resposta em vez de enviar várias mensagens. Orientações e segmentação de Conteúdo também podem ser configuradas por canal — por exemplo, respostas por Email podem usar um tom mais formal ou incluir uma introdução específica.

Defina os dados disponíveis

A seção Customer data available to Fin permite definir os dados que o Fin terá acesso durante o teste. Isso garante que você teste com valores de dados precisos em vez de descrições vagas.

Hora da simulação: Use para definir "quando" o cenário está acontecendo. Definir data e hora específicas permite testar lógica sensível ao tempo, como verificar se o cliente está dentro do prazo de reembolso de 30 dias.
Atributos e Data Connectors: Esta seção é preenchida com os atributos referenciados no seu Procedimento. Atualize esses valores (ex.: defina People.Plan como "Pro") para testar diferentes resultados de ramificação.

Nota: Para garantir que sua simulação funcione corretamente, coloque os dados com base em quando o Fin deve "saber" deles:

Use Attributes: Se o Fin deve já conhecer a informação no início da conversa (ex.: o Plano atual do cliente ou data de cadastro).
Use Additional details: Se a informação deve ser fornecida pelo cliente durante a conversa (ex.: o cliente fornece o "Order ID" em uma resposta posterior). Isso permite testar se o Fin captura e armazena corretamente esses dados em um atributo.

Importante: A hora da simulação afeta apenas a lógica de datas em linguagem natural, não as condições em código Python. Se seu Procedimento avalia uma data usando uma condição em linguagem simples (ex.: uma verificação de data nas instruções), o raciocínio do Fin usa a hora da simulação que você definiu. Mas se a condição de um ramo for código Python que chama datetime.datetime.now() (ou similar), essa chamada sempre retorna a data real do sistema — a configuração da hora da simulação não altera isso. Isso significa que um ramo baseado em código não pode ser testado definindo a hora da simulação; ele sempre avaliará a data real de hoje, independentemente do que você definir.

Para testar uma condição de data baseada em código para datas diferentes, execute simulações separadas nas datas reais do calendário que deseja validar (ex.: 4, 5 e 6 do mês), ou reescreva a condição como uma instrução em linguagem simples em vez de código Python, para que o raciocínio do Fin — que respeita a hora da simulação — conduza o ramo.

Nota: A seção Customer data available to Fin mostra e mantém apenas atributos explicitamente referenciados nas instruções do seu Procedimento ou em um bloco de código. Se você adicionar manualmente um atributo usando o botão + Add attribute mas esse atributo não for referenciado em nenhum lugar do Procedimento, o sistema não o salvará — ele desaparece após salvar porque não afeta a simulação. Para adicionar um valor personalizado que persista, certifique-se de que o atributo seja usado primeiro no próprio Procedimento.

Avalie o comportamento do Fin

Defina os critérios que devem ser verdadeiros para o teste passar. Clique em + Add criteria e selecione:

Resposta do Fin: Especifique o que o Fin deve (ou não deve) dizer durante a conversa.
Data connector: Verifique se um conector foi acionado, não foi acionado ou foi acionado exatamente X vezes.
Resultado da instrução: Verifique se a conversa chegou a uma conclusão específica, como finalização, transferência para um colega, ou outros resultados como mudança para outro Procedimento.

Uma vez configurado, clique em Save.

Nota: Quando você clicar em Salvar, Fin usa AI para revisar seu formulário de simulação. Se as instruções estiverem confusas ou os critérios de sucesso inconsistentes, você verá recomendações para melhorar o teste e obter resultados mais precisos.

Melhores práticas para cobertura de simulação

Para aproveitar ao máximo as simulações, estruture sua suíte de testes com base nestes princípios:

Teste um ramo por simulação. Se seu Procedimento tiver Condições ou subprocedimentos com múltiplos caminhos, crie uma simulação separada para cada ramo. Isso cria uma rede de segurança contra regressões — se uma edição futura quebrar um caminho específico, você perceberá imediatamente.
Cubra tanto os caminhos de sucesso quanto de falha para os Data Connectors. Execute uma simulação onde seu conector retorna dados válidos e outra onde ele não retorna nada ou falha. Isso verifica se sua lógica de fallback (por exemplo, um passo @Condition lidando com uma resposta vazia) funciona corretamente.
Execute todas as simulações antes de publicar alterações. Após editar um Procedimento, clique em Executar tudo para reexecutar sua suíte completa antes de entrar no ar. Qualquer simulação que falhar sinaliza uma regressão introduzida pela sua edição.
Use nomes descritivos para as simulações. Nomeie cada simulação pelo cenário que ela representa (por exemplo, "Reembolso total — dentro de 30 dias" ou "Cancelamento — pedido não encontrado"). Isso facilita identificar qual teste cobre qual caminho ao revisar os resultados.

Executando e revisando resultados

Depois de executar um teste, ele aparece no painel Tests no lado direito com um indicador de status:

Executando: O teste está sendo executado ativamente.
Aprovado: O teste foi executado e atendeu com sucesso a todos os critérios de sucesso definidos.
Falhou: O teste foi executado, mas não atendeu aos critérios de sucesso definidos.
Na fila: O teste foi iniciado, mas está aguardando a simulação anterior terminar antes de executar.

Para investigar um resultado, clique em Ver conversa. Isso abre a transcrição completa da troca entre o cliente simulado e Fin, facilitando ver exatamente como o fluxo ocorreu e por que o teste passou ou falhou.

Limites de uso de simulação

Há um limite para o número de simulações que você pode executar a cada mês. Esse limite é aplicado no nível do workspace e é reiniciado no primeiro dia de cada mês do calendário.

Cada workspace recebe uma cota mensal de execuções de Simulação. A cota é baseada no segmento de volume de conversas do seu workspace, com clientes maiores recebendo cotas maiores.

A cota de simulação é baseada no volume de conversas do seu workspace.

Atribuímos seu workspace a um segmento usando o número de conversas no último mês do calendário.
Seu segmento é reavaliado mensalmente e sua cota refletirá o volume de conversas do mês mais recente.
Se o volume de conversas aumentar ou diminuir, sua cota de Simulação pode mudar no próximo ciclo mensal.

Segmento de Volume de Conversas	Limite de Simulação por mês
Menos de 1K	250
1K–15K	1.000
15K–100K	1.750
100K–1M	5.000
1M+	12.500

Monitorando seu uso

Para ajudar você a gerenciar seus testes, Fin fornece indicadores visuais na aba Simulations:

Aviso de uso

Quando seu workspace atingir 80% do limite mensal, um banner amarelo de aviso aparecerá. Ele mostra seu uso atual (por exemplo, "85/100") e lembra quando o limite será reiniciado.

Limite atingido

Quando você atingir 100% do seu limite mensal, uma mensagem de erro vermelha aparecerá. Você não poderá executar mais simulações até o início do próximo mês.

Nota: Se você atingir seu limite, ainda poderá revisar resultados e transcrições de simulações anteriores clicando em Ver conversa, mas os botões Executar e Executar tudo ficarão desativados.

Perguntas Frequentes

Por que usar Simulações em vez de testes manuais?

Testes manuais são ótimos para verificações rápidas ou revisões de configuração. No entanto, Simulações permitem validar Procedimentos em escala e garantir que Fin funcione de forma confiável em cenários complexos e de alto risco. Executá-las antes de cada lançamento ajuda a detectar comportamentos inesperados cedo.

O que acontece se uma Simulação falhar?

Você pode revisar a conversa simulada completa para entender por que Fin não se comportou como esperado, ajustar seu Procedimento e executar a Simulação novamente sem impacto para os clientes.

Por que minha simulação está marcada como "Falhou" mesmo que Fin tenha resolvido o problema com sucesso?

Isso geralmente acontece quando seus Critérios de Sucesso são muito rígidos. Por exemplo, se você exigir que Fin "Peça um ID de Pedido", mas Fin for inteligente o suficiente para encontrar o ID automaticamente, o teste falhará porque Fin pulou a pergunta. Atualize seus critérios para focar no resultado final (por exemplo, "Procedimento finalizado") em vez de exigir etapas intermediárias específicas.

Simulações são cobradas separadamente dos Procedimentos?

Simulações estão incluídas com Procedimentos e não são cobradas como um item separado. Você não terá cobranças adicionais por executar simulações.

Por que há um limite para execuções de Simulação?

Cada execução de simulação requer recursos para gerar previsões precisas de AI. Fornecemos uma cota mensal para garantir que você possa testar seus Procedures livremente para casos de uso padrão, evitando que o uso extremo gere custos descontrolados.

Quantas simulações posso executar por mês?

Sua cota mensal de execuções de Simulation depende do volume de conversas do seu workspace durante o mês calendário anterior. O limite é aplicado no nível do workspace e é reiniciado no primeiro dia de cada mês:

Segmento de Volume de Conversa	Limite de Simulation por mês
Menos de 1K	250
1K–15K	1.000
15K–100K	1.750
100K–1M	5.000
1M+	12.500

Quando meu limite de simulation será reiniciado?

Sua cota de Simulation é reiniciada no primeiro dia de cada mês calendário, independentemente de quando você entrou ou quantas simulações usou. As execuções não utilizadas não são acumuladas — sua cota começa do zero a cada mês.

Posso aumentar meu limite de simulation?

Os limites de Simulation são definidos automaticamente com base no volume de conversas do seu workspace e reavaliados no início de cada mês calendário. Se o volume de conversas crescer, sua cota aumentará no próximo ciclo mensal — não há opção para comprar execuções adicionais manualmente ou aumentar seu limite fora desse sistema de níveis. Se você atingir seu limite mensal antes da data de reinício, ainda poderá revisar resultados e transcrições de simulações anteriores, mas os botões Run e Run all ficarão desativados até que sua cota seja reiniciada.

Execute simulações para Procedimentos Fin