Extrair parâmetros · parameter_extractor

Referência do nó

Kindparameter_extractorCategoriaDados

Para que serve

Pensa num recepcionista que ouve o cliente dizer "quero marcar uma consulta pra semana que vem, de manhã, com o Dr. João" e já anota: data: próxima semana, período: manhã, médico: Dr. João. O Extrair parâmetros faz exatamente isso com texto do seu fluxo: ele usa uma IA para ler o que o cliente escreveu e identificar campos específicos que você definiu — devolvendo tudo como variáveis organizadas.

Quando usar

• Extrair intenção, produto, data, valor ou qualquer dado de uma mensagem em linguagem natural
• Transformar uma resposta de texto livre em campos estruturados para usar numa API
• Identificar múltiplos parâmetros de uma única mensagem do cliente
• Pré-processar a entrada antes de chamar um sistema externo que exige dados estruturados

---

Passo a passo

1. ·
   Arraste o nó **Extrair parâmetros** para o canvas e conecte ao nó que fornece o texto (ex.: Esperar Texto).
   

   

   Paleta de nós aberta no canvas do Flow Builder, com as categorias disponíveis para localizar e arrastar o nó desejado

2. ·
   No painel, selecione o **Modelo de IA** que fará a extração.
   

   

   Painel de configuração do nó Extrair parâmetros, com as seções Modelo, Entrada, Parâmetros a extrair e Instrução

3. ·
   Clique em **+ Adicionar parâmetro** para cada campo que você quer extrair.
4. ·
   Para cada parâmetro, configure: - **Nome** (ex.: `data_consulta`) - **Tipo** (texto, número, data, booleano, enumeração) - **Descrição** (instrução para a IA — ex.: "Data mencionada pelo cliente, no formato YYYY-MM-DD") - **Obrigatório** (se ativado, a extração falha quando o campo não é encontrado)
5. ·
   Salve. Cada parâmetro extraído fica disponível como {{parameter_extractor.nome_do_campo}}.

---

Campos

Campo	O que faz
Texto de entrada	O texto que a IA vai analisar (geralmente a mensagem do cliente)
Modelo	Qual modelo de IA realiza a extração
Instrução adicional	Contexto extra para ajudar a IA a entender o domínio
Parâmetros	Lista de campos a extrair, cada um com nome, tipo e descrição

O Texto de entrada é sempre uma referência de variável (ex.: flow.user_text), escolhida no seletor do painel. Uma lista literal (["flow","user_text"]) não é aceita e faz o nó falhar com erro claro.

Saídas do nó

Cada parâmetro vira uma saída com o próprio nome ({{parameter_extractor.data_consulta}}). Parâmetro não encontrado fica com o valor vazio do tipo (texto "", número 0, booleano false, lista []). Além deles, o nó sempre devolve:

Saída	O que é
__is_success	1 se a extração deu certo; 0 se faltou um parâmetro obrigatório, o valor não bate com o tipo/opções, a resposta da IA veio inválida ou o texto de entrada estava vazio
__reason	Motivo quando __is_success é 0 (vazio quando deu certo)
__usage	Tokens e custo da chamada à IA

Nesses casos o fluxo segue normalmente: use __is_success numa condição para tratar a falha. Erros de infraestrutura (modelo sem credencial, resposta vazia da IA) continuam indo para a saída de erro.

Tipos de parâmetro suportados

Tipo	Exemplo de uso
Texto	Nome, cidade, produto mencionado
Número	Valor, quantidade, código
Data	Data de agendamento, prazo
Booleano	O cliente confirmou? Quer parcelamento?
Enumeração	Tipo de serviço: consulta, retorno, urgencia

---

Exemplo

O cliente digita: "Oi, quero marcar pra sexta de manhã, com a Dra. Ana, sobre divórcio"

Parâmetros configurados:

• dia_semana (texto): "Dia da semana mencionado"
• periodo (enumeração: manhã/tarde/noite): "Período do dia preferido"
• advogada (texto): "Nome do profissional solicitado"
• assunto (texto): "Assunto ou área jurídica mencionada"

Resultado:

dia_semana  → "sexta"
periodo     → "manhã"
advogada    → "Dra. Ana"
assunto     → "divórcio"

Dica

Quanto mais clara e específica for a descrição de cada parâmetro, melhor a IA extrai. Em vez de "data", escreva "Data mencionada pelo cliente para o agendamento, no formato DD/MM/AAAA".

Atenção

Se um parâmetro obrigatório não for encontrado no texto, o nó não vai para a saída de erro: ele devolve __is_success = 0 e o motivo em __reason. Use um nó Se/Senão (condição) depois, testando __is_success, para pedir ao cliente que informe os dados faltantes.