Buscar Dados · data_source

Referência do nó

Kind:data_sourceCategoria:Dados

Para que serve

Pensa num pesquisador que, antes de responder qualquer pergunta, vai até a fonte certa de informação: às vezes consulta a enciclopédia, às vezes o arquivo da empresa, às vezes o banco de dados de clientes. O nó Buscar Dados funciona assim: você escolhe onde quer buscar a informação, e ele vai lá, busca e traz o resultado para o fluxo.

Quando usar

• Consultar dados de clientes, contratos ou processos antes de enviar uma mensagem
• Buscar na base de conhecimento da empresa para responder dúvidas (RAG)
• Recuperar informações do CRM interno do Atende Direito
• Combinar dados de múltiplas fontes antes de um nó de IA

---

Fontes disponíveis

O nó Data Source suporta três tipos de fonte. Escolha a que faz sentido para o seu caso:

---

API HTTP

Consulta qualquer endpoint REST externo.

Quando usar: seu sistema tem uma API que retorna dados sobre o cliente, pedido, processo, etc.

Configuração:

Campo	O que preencher
URL	Endpoint da API — suporta expressões {{ }}
Método	GET (mais comum para busca)
Headers	Autenticação e outros cabeçalhos
Params	Parâmetros de busca (query string)

CAPTURAR: painel do data_source com tipo API HTTP selecionado e URL configurada com variável do contato

---

Base de Conhecimento (RAG)

Busca semântica nos documentos que você indexou na plataforma.

Quando usar: você quer que o fluxo encontre a resposta mais relevante em PDFs, documentos ou artigos cadastrados na sua base de conhecimento.

Configuração:

Campo	O que preencher
Base de Conhecimento	Qual base usar (pode selecionar mais de uma)
Query	A pergunta ou texto para buscar — geralmente a mensagem do cliente
Limite de resultados	Quantos trechos relevantes retornar (padrão: 3)

CAPTURAR: painel do data_source com tipo Knowledge Base selecionado, uma base escolhida e o campo query preenchido com <span v-pre>{{userinput.query}}</span>

Dica

Para usar RAG, você precisa ter documentos indexados na plataforma. Veja como configurar em Conhecimento — Base de Conhecimento.

---

CRM Interno

Consulta diretamente o CRM do Atende Direito — contatos, conversas, tags, listas.

Quando usar: você precisa verificar dados do contato atual (tags, campos personalizados, histórico) sem chamar uma API externa.

Configuração:

Campo	O que preencher
Entidade	O que buscar: Contato, Conversa, Negócio, etc.
Filtros	Condições para encontrar o registro certo
Campos retornados	Quais informações você quer na saída

CAPTURAR: painel do data_source com tipo CRM selecionado, entidade Contato e filtro por contact.id

---

Passo a passo

1. ·
   Arraste o nó **Buscar Dados** para o canvas e conecte ao fluxo.
2. ·
   Escolha o **Tipo de fonte**: API HTTP, Base de Conhecimento ou CRM Interno.
3. ·
   Preencha a configuração específica do tipo escolhido (ver seções acima).
   

   

   CAPTURAR: seletor de tipo de fonte do nó data_source com as três opções visíveis

4. ·
   Salve. Os resultados ficam disponíveis como {{nome_do_no.result}} ou {{nome_do_no.data}}.

---

Exemplo

Um cliente pergunta sobre os honorários para um processo de divórcio. O fluxo usa o Data Source com a Base de Conhecimento para buscar a resposta nos documentos de tabela de honorários cadastrados, e passa o resultado para um nó LLM que redige a resposta final.

CAPTURAR: fluxo com esperar_texto → data_source (RAG) → llm → enviar_mensagem, mostrando o conteúdo passando de um nó para o outro

Atenção

O nó data_source_empty é um nó interno usado pela plataforma e não aparece para o usuário. Se você precisar de um fluxo que começa sem dados, use o nó Start normalmente.