Analisar com IA

Analisar com IA classifica conteúdo, atribui uma pontuação ou produz texto para os próximos passos da automação. Cada nova análise devolve uma variável estruturada. Lista de opções, sim/não e pontuação também escolhem uma saída diretamente no canvas; texto segue pela saída Continuar.

Disponibilidade: o formato de resultado único foi validado e publicado em Dev. Sua publicação em produção ainda está pendente. Se seu editor mostra Campos de saída, consulte Nós com o formato antigo.

O passo não envia mensagens ao cliente nem executa ferramentas. O modelo recebe o Conteúdo para analisar e as instruções que você configurou, depois da substituição das variáveis. A conversa não é incluída automaticamente: para avaliar um atendimento, insira {{conversation.transcript}} quando essa variável estiver disponível naquele caminho.

Adicionar e configurar o passo

No editor da automação:

1. na aba Ações da paleta, adicione Analisar com IA;
2. em Resultado, escolha o Tipo da saída e preencha o Nome da variável;
3. descreva O que a IA deve avaliar? e configure as opções ou a quantidade de notas, quando necessário;
4. em Contexto, preencha Conteúdo para analisar, usando as variáveis disponíveis;
5. em Modelo, escolha um modelo disponível para esse resultado;
6. conecte cada saída a um único destino no canvas e clique em Salvar.

O nome da variável aceita letras sem acento, números e _, começando por letra ou _. Use um nome estável, como intencao, urgente, nota ou resumo. Não é necessário criar uma segunda variável para indicar a saída escolhida.

Escolher o tipo da saída

O seletor separa os tipos em OPÇÕES PRÉ-DEFINIDAS e RESPOSTA LIVRE. Mesmo em texto livre, o resultado continua estruturado: o texto fica no campo que você nomeou.

Tipo	Valor da variável	Saídas no canvas
Lista de opções	o nome da opção escolhida	uma por opção
Sim/não	verdadeiro ou falso	Sim e Não
Pontuação	uma nota de 1 até a quantidade definida, podendo conter fração	de 2 a 10 saídas numeradas
Texto livre	o texto produzido	Continuar

Lista de opções

Informe pelo menos duas opções com nomes únicos. Use Quando escolher a opção para explicar o significado de cada uma. Por exemplo: Comercial para intenção de contratar, Financeiro para dúvidas de cobrança e Suporte para problemas de uso.

Você pode adicionar, renomear e reordenar opções. Renomear ou mover uma opção preserva sua conexão. Para remover uma opção conectada, resolva primeiro a ligação correspondente no canvas.

Sim/não

Escreva uma regra verificável em O que a IA deve avaliar?, por exemplo: “O cliente pediu atendimento humano?”. O resultado é verdadeiro ou falso e apenas a saída Sim ou Não correspondente avança.

Pontuação

Use o controle Quantidade de notas para escolher de 2 a 10 notas e saídas. Com dez notas, a escala vai de 1 a 10, e o node exibe dez saídas. Explique em uma única instrução o que uma nota baixa ou alta significa; não é preciso escrever uma regra para cada nível.

A variável preserva a nota original. Uma nota 7,3 segue pela saída 7; 7,8 segue pela saída 8. Em um empate como 7,5, segue pela saída 8. Você conecta essas saídas ao mesmo destino ou a destinos diferentes, conforme o fluxo.

Texto livre

Defina o conteúdo esperado, como “Resuma o pedido em uma frase factual”. O texto é salvo na variável e a automação segue por Continuar. Use uma Condição depois da análise se precisar aplicar uma comparação adicional ao texto.

Escrever a avaliação e fornecer contexto

Separe a regra de avaliação do material que será avaliado. Para uma lista de opções, você pode preencher:

• O que a IA deve avaliar?: “Classifique o assunto principal do pedido. Considere o que a pessoa está solicitando agora.”
• Conteúdo para analisar: {{conversation.transcript}}.
• Quando escolher a opção: o critério de cada opção.

Nem todo gatilho fornece uma conversa. Em fluxos de Lista, Agenda ou Audiência, use os grupos oferecidos no seletor, como contato, lista ou payload do gatilho. Se não houver transcrição disponível, obtenha a conversa antes da análise ou forneça outro conteúdo adequado.

Preencha a avaliação e o conteúdo antes de salvar. O node não consulta bases de conhecimento nem envia mensagens; acrescente os passos necessários ao fluxo para essas ações.

Escolher o modelo

Para Lista de opções, Sim/não e Pontuação, o seletor pode oferecer os grupos Modelos de decisão e LLMs. Você escolhe qual modelo fará a análise. Para Texto livre, aparecem somente LLMs.

A lista depende dos modelos públicos ativos, do plano e da disponibilidade para sua organização. Um modelo interno, indisponível ou incompatível não pode ser usado na nova análise. Ela exige uma escolha explícita: não há substituição silenciosa por um modelo padrão ou por outra família.

Trocar o modelo mantendo o tipo preserva variável, saídas e conexões. Ao trocar de um resultado pré-definido com modelo de decisão para Texto livre, escolha um LLM; o modelo de decisão é removido da seleção.

Modelos de decisão podem consumir menos créditos, mas isso não garante uma classificação melhor. Compare exemplos do seu fluxo. A disponibilidade de Score em um modelo como JEV não comprova sua precisão; a avaliação inicial de qualidade não validou o uso genérico de Score para os casos testados. Defina critérios claros e confira casos representativos antes de ativar.

Conectar e usar o resultado

As conexões são feitas somente no canvas. Cada saída precisa ter um destino válido; várias saídas podem chegar ao mesmo próximo passo. Em cada execução, somente o caminho escolhido avança. Não é necessário adicionar um node de Condição apenas para separar as opções, sim/não ou notas dessa análise.

O editor impede mudanças de tipo ou quantidade que removam saídas ainda conectadas. Resolva as conexões primeiro. Renomear a variável exige atualizar as referências nos próximos passos que a utilizam.

Depois do sucesso, o resultado fica disponível como {{id_do_node.nome_da_variavel}}. Por exemplo, a variável nota do node n5 é {{n5.nota}}. Ela só pode ser usada nos passos posteriores que passam pela análise; não existe em um ramo paralelo, no próprio node ou acima dele.

Em Atividade, o resultado fica separado de Detalhes da análise, onde aparecem o caminho escolhido e as informações do modelo e do consumo disponíveis. Esses detalhes não criam variáveis adicionais no fluxo.

Salvar, testar e acompanhar falhas

Salvar publica uma nova versão do grafo. A publicação recusa resultado incompleto, nome de variável inválido, opções vazias ou repetidas, quantidade de notas fora de 2–10, modelo inelegível e saídas sem destino ou com destinos ambíguos. Versões anteriores não são reescritas.

O modo Testar simula ações de envio e escrita, mas Analisar com IA executa de verdade e consome créditos. Consulte Execuções e testes. Confira a variável e a saída escolhida, incluindo casos ambíguos, limites da escala e conteúdo insuficiente.

Se o modelo devolver uma resposta estruturada inválida, o node pode tentar novamente até duas vezes, totalizando três tentativas. Cada tentativa possui seu próprio registro em Atividade e sua própria cobrança quando faturada. Erros de rede, autenticação ou provedor não recebem essa repetição automática. Uma falha não escolhe uma saída nem avança por uma conexão alternativa. Falha de cobrança também interrompe o passo.

Créditos

Com chave própria do OpenRouter, a chamada usa essa chave e o SquadOS cobra 1 crédito fixo por tentativa. O custo do provedor é cobrado na conta dessa chave. A economia do modelo não reduz a taxa fixa da plataforma.

Sem chave própria, o SquadOS usa a chave da plataforma e converte o custo em créditos. Se o provedor não informar o custo real, a cobrança pode usar a estimativa pelos tokens e preços cadastrados. Uma tentativa processada pode ter custo mesmo quando o resultado é inválido. Em automações com reentrada Sempre, novos eventos podem executar e cobrar a análise novamente.

Nós com o formato antigo

Nós existentes mantêm Campos de saída, seus resultados, suas conexões e o comportamento anterior. Eles podem ter vários campos, incluindo Número; esse tipo não é convertido automaticamente em Pontuação. Uma configuração antiga sem modelo explícito continua usando o padrão global ativo da plataforma.

Para atualizar uma edição, use Converter para resultado único e escolha a variável que deseja manter. A conversão altera somente o rascunho. Atualize referências aos campos descartados e resolva conexões incompatíveis antes de converter; depois escolha o modelo, complete a avaliação e conecte as novas saídas. Para um campo Número, escolha explicitamente o novo tipo.