Analisar com IA

Analisar com IA é o passo que lê o conteúdo da conversa e devolve dados estruturados — não um texto solto. É o que permite a uma automação decidir com base no que foi dito: se o cliente demonstrou intenção de compra, qual objeção apareceu, qual assunto o atendimento tratou.

Modelo

Qual modelo faz a análise. No padrão, ele acompanha o modelo escolhido nas preferências da organização — assim, trocar o modelo padrão vale para todas as automações de uma vez.

Instrução

O que a IA deve fazer com o conteúdo. Aceita variáveis, e a mais usada aqui é conversation.transcript, que traz o histórico inteiro da conversa em texto.

Uma instrução que funciona bem costuma ter três coisas: o que ler, o que decidir e o que devolver. Por exemplo:

Leia a conversa e diga se o cliente demonstrou intenção de compra
e qual objeção apareceu.

Conversa: {{conversation.transcript}}

Campos de saída

Esta é a parte que faz o passo valer a pena. Cada campo declarado aqui vira uma variável que os passos seguintes conseguem usar:

Cada campo tem três partes:

• Nome — é por ele que os passos seguintes leem o valor. Use letras sem acento, números e _, sem espaços.
• Tipo — Texto, Número, Sim ou não ou Uma das opções (nesse último, você lista as opções separadas por vírgula; precisa de pelo menos duas).
• Descrição — o que este campo deve conter. É ela que orienta a IA, então vale escrever com cuidado: “sim, se o cliente demonstrou intenção de compra; não, caso contrário” produz resultado melhor do que “intenção”.

O passo precisa de pelo menos um campo para salvar. Um passo de IA sem campo de saída gastaria créditos e não devolveria nada aproveitável.

Usando o resultado

Os campos ficam disponíveis nos passos abaixo deste, num grupo próprio do seletor de variáveis. O caminho é o identificador do passo mais o nome do campo — por exemplo, n5.intencao_de_compra.

O par mais comum é este:

1. Analisar com IA classifica a conversa;
2. uma Condição separa o fluxo pelo resultado;
3. cada ramo faz o que precisa — aplicar uma tag, gravar o valor no contato, avisar alguém.

A variável só vale abaixo do passo que a criou, e só nos caminhos que passam por ele. Um passo de outro ramo não enxerga essa saída — e o SquadOS recusa salvar um fluxo que tente isso, em vez de deixar a variável sair em branco na frente do cliente.

Créditos

Este é o único passo que consome créditos, e ele consome a cada execução.

• Se a sua organização usa chave própria (BYOK), o passo custa 1 crédito fixo e a chamada sai na sua chave.
• Sem chave própria, a chamada sai pela chave da plataforma e o custo em dólares é convertido em créditos.

O custo de cada execução aparece na coluna Custo da aba Atividade. Mais sobre créditos em Planos e cobrança.

Reentrada “Sempre” mais um passo de IA merece atenção. Cada evento vira uma execução, e cada execução paga a análise. É a combinação que mais surpreende na fatura.

No modo de teste, a IA roda de verdade

O botão Testar simula os envios, mas não simula a IA: o passo executa e cobra normalmente. É proposital — o valor de testar está justamente em ver o que o modelo devolveu.