---
title: Extrair parâmetros
description: Use IA para identificar e extrair informações específicas de um texto livre.
---

# Extrair parâmetros  ·  `parameter_extractor`

<NoCard kind="parameter_extractor" categoria="Dados" />

<Secao icon="info">Para que serve</Secao>

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.

<Secao icon="clock">Quando usar</Secao>

- 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

---

<Secao icon="list-checks">Passo a passo</Secao>

<Passos>
  <Passo>Arraste o nó **Extrair parâmetros** para o canvas e conecte ao nó que fornece o texto (ex.: Esperar Texto).<br/><Captura legenda="Paleta de nós aberta no canvas do Flow Builder, com as categorias disponíveis para localizar e arrastar o nó desejado" src="/img/flowbuilder-paleta-aberta.png" /></Passo>
  <Passo>No painel, selecione o **Modelo de IA** que fará a extração.</Passo>
  <Passo>Clique em **+ Adicionar parâmetro** para cada campo que você quer extrair.</Passo>
  <Passo>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)</Passo>
  <Passo>Salve. Cada parâmetro extraído fica disponível como <code v-pre>{{parameter_extractor.nome_do_campo}}</code>.</Passo>
</Passos>

---

<Secao icon="sliders-horizontal">Campos</Secao>

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

## 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` |

---

<Secao icon="circle-check">Exemplo</Secao>

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".

</Dica>

<Cuidado>

Se um parâmetro obrigatório não for encontrado no texto, o nó vai para a saída de erro. Use um nó **Se/Senão (condição)** depois para tratar esse caso e pedir ao cliente que informe os dados faltantes.

</Cuidado>