---
title: Buscar dados externos
description: Consulte APIs externas, sua base de conhecimento ou o CRM interno diretamente do fluxo.
---

# Buscar dados externos  ·  `data_source`

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

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

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 externos funciona assim: você escolhe onde quer buscar a informação, e ele vai lá, busca e traz o resultado para o fluxo.

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

- 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 endereço (endpoint) de uma API externa.

**Quando usar:** seu sistema tem uma API — uma "porta de entrada" que outros sistemas usam para trocar dados — que retorna informações sobre o cliente, pedido, processo, etc.

**Configuração:**

| Campo | O que preencher |
|-------|----------------|
| **URL** | Endereço da API a consultar — suporta expressões <code v-pre>{{ }}</code> |
| **Método** | GET (mais comum para busca) |
| **Headers** | Autenticação e outros cabeçalhos |
| **Params** | Parâmetros de busca (query string) |

---

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

<Dica>

Para usar RAG, você precisa ter documentos indexados na plataforma. Veja como configurar em [Conhecimento — Base de Conhecimento](/guia/flow-builder/ia/conhecimento).

</Dica>

---

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

---

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

<Passos>
  <Passo>Arraste o nó **Buscar dados externos** para o canvas e conecte ao fluxo.</Passo>
  <Passo>Escolha o **Tipo de fonte**: API HTTP, Base de Conhecimento ou CRM Interno.</Passo>
  <Passo>Preencha a configuração específica do tipo escolhido (ver seções acima).</Passo>
  <Passo>Salve. Os resultados ficam disponíveis como <code v-pre>{{nome_do_no.result}}</code> ou <code v-pre>{{nome_do_no.data}}</code>.</Passo>
</Passos>

---

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

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.

<Cuidado>

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.

</Cuidado>

---

## Saiba mais

- [Conhecimento — Base de Conhecimento](/guia/flow-builder/ia/conhecimento) — como indexar documentos para consulta via RAG