Extrator de Parâmetros · parameter_extractor

Referência do nó

Kind:parameter_extractorCategoria:Dados

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 Extrator de 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ó **Extrator de Parâmetros** para o canvas e conecte ao nó que fornece o texto (ex.: Esperar Texto).
   

   

   CAPTURAR: nó parameter_extractor no canvas conectado a um nó de esperar texto

2. ·
   No painel, selecione o **Modelo de IA** que fará a extraçã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)

   

   CAPTURAR: painel do parameter_extractor com três parâmetros configurados: nome do cliente, data e tipo de serviço

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 LLM 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

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"

CAPTURAR: resultado do parameter_extractor mostrando os campos extraídos com seus valores ao lado do texto original do cliente

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ó vai para a saída de erro. Use um nó IF/ELSE depois para tratar esse caso e pedir ao cliente que informe os dados faltantes.