Agents collect_data

Coletar Dados

Agente conversacional que reúne campos estruturados e lembra fatos via ferramentas ocultas.

O que faz?

Um agente IA especializado em coletar informações do cliente passo a passo, como se estivesse preenchendo um formulário de forma conversacional.

Como funciona?

Você dá uma lista de dados obrigatórios (ex: nome, email, modelo do carro). O IA conversa com o usuário até ter todos os campos completos, fazendo perguntas de acompanhamento se algo faltar.

Por que usar?

É a melhor forma de capturar leads ou receber pedidos sem enviar os usuários para formulários web entediantes. O cliente sente que está falando com um humano enquanto você preenche seu CRM de forma estruturada.

Entradas

nome	tipo
`text`	string

Saídas

nome	tipo
`data`	object
`reply`	string

Ramificações

Ramificações fixas

completed — Concluído
collecting — Coletando

Configuração

mode "conversational" | "streaming" obrigatório padrão: "conversational"

streaming object opcional

model string opcional

prompt string obrigatório

input_field string obrigatório padrão: "text"

memory_key string obrigatório padrão: "messages"

history_turns integer obrigatório padrão: 20

recent_turns integer obrigatório padrão: 20

temperature number obrigatório padrão: 0.4

max_tokens integer opcional

hidden_tools object obrigatório padrão: {}

tools array obrigatório padrão: []

branch_when_completed string obrigatório padrão: "completed"

branch_when_collecting string obrigatório padrão: "collecting"

memory_facts_schema object opcional

memory_summary_config object opcional

Configuração padrão

{
  "mode": "conversational",
  "prompt": "Greet the user and ask for the missing fields one at a time.",
  "input_field": "text",
  "memory_key": "messages",
  "history_turns": 20,
  "recent_turns": 20,
  "temperature": 0.4,
  "max_tokens": 800,
  "hidden_tools": {},
  "tools": [],
  "branch_when_completed": "completed",
  "branch_when_collecting": "collecting"
}

Eventos emitidos

agent.reply
Resposta final do agente com o texto gerado.
collect_data.streaming_update
Atualização de progresso de extração de campos.
collect_data.streaming_skip
Um fragmento de streaming foi pulado por configuração.
collect_data.streaming_pending
Campos pendentes de extração.
collect_data.streaming_failed_definitively
Extração de campos falhou definitivamente.