---
title: Conhecimento
description: Busque e indexe documentos para que seu fluxo responda com base nas informações da sua empresa.
---

# Conhecimento  ·  `knowledge_retrieval` / `knowledge_base`

O Atende Direito tem dois nós complementares para trabalhar com bases de conhecimento. Um **busca** nas bases existentes; o outro **indexa** novos conteúdos durante o fluxo.

---

## Buscar na base de conhecimento  ·  `knowledge_retrieval`

<NoCard kind="knowledge_retrieval" categoria="IA" />

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

Imagina uma biblioteca enorme com todos os documentos da sua empresa. Em vez de você folhear cada um para encontrar a resposta certa, tem um bibliotecário inteligente que entende o que você está perguntando e traz exatamente os trechos mais relevantes. O Buscar na base de conhecimento faz esse papel: busca nos documentos que você indexou e retorna os pedaços mais úteis para responder a dúvida do cliente.

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

- Antes de um nó Modelo de IA (LLM) que vai responder perguntas com base em documentos da empresa
- Para encontrar trechos de contratos, manuais, FAQs, tabelas ou políticas relevantes
- Como alternativa ao nó [Buscar dados externos](/guia/flow-builder/dados/buscar-dados) quando os dados estão indexados como conhecimento

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

<Passos>
  <Passo>Certifique-se de ter documentos indexados em pelo menos uma base de conhecimento.<br/><Captura legenda="Etapa Conhecimento do assistente de criação de agent, onde páginas de uma base de conhecimento podem ser vinculadas" src="/img/agent-conhecimento-config.png" /></Passo>
  <Passo>Arraste o nó **Buscar na base de conhecimento** para o canvas e conecte ao fluxo.</Passo>
  <Passo>Selecione as **Bases de Conhecimento** que o nó deve consultar (pode ser mais de uma).</Passo>
  <Passo>Configure a **Query** — geralmente a mensagem do cliente: <code v-pre>{{userinput.query}}</code>.</Passo>
  <Passo>Ajuste o **Limite de resultados** (quantos trechos retornar) e o **Reranker** se disponível.</Passo>
  <Passo>Salve. Os trechos encontrados ficam em <code v-pre>{{knowledge_retrieval.result}}</code>, prontos para passar a um nó Modelo de IA (LLM).</Passo>
</Passos>

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

| Campo | O que faz |
|-------|-----------|
| **Bases de conhecimento** | Quais bases consultar |
| **Query** | Texto de busca — suporta expressões <code v-pre>{{ }}</code> |
| **Limite de resultados** | Máximo de trechos retornados |
| **Modo de busca** | Semântica (significado), Keyword (palavras exatas) ou Híbrida |
| **Reranker** | Reordena os resultados pelo mais relevante antes de retornar |

### Modos de busca

| Modo | Quando usar |
|------|------------|
| **Semântica** | Perguntas em linguagem natural — o modelo entende o significado |
| **Keyword** | Quando o cliente usa termos técnicos ou códigos exatos |
| **Híbrida** | O melhor dos dois mundos — recomendado para uso geral |

---

## Base de conhecimento  ·  `knowledge_base`

<NoCard kind="knowledge_base" categoria="IA" />

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

Enquanto o Buscar na base de conhecimento *busca*, o Base de conhecimento *adiciona*. Ele recebe um conteúdo durante a execução do fluxo e indexa esse conteúdo na sua base de conhecimento — para que ele possa ser encontrado em buscas futuras.

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

- Indexar documentos enviados pelo cliente durante o atendimento
- Atualizar a base de conhecimento com informações geradas no fluxo
- Salvar respostas aprovadas para uso futuro em RAG

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

<Passos>
  <Passo>Arraste o nó **Base de conhecimento** para o canvas.</Passo>
  <Passo>Selecione a **Base de Destino** onde o conteúdo será indexado.</Passo>
  <Passo>Configure o **Conteúdo** — pode ser texto direto, resultado de um extrator de documento ou qualquer variável do fluxo.</Passo>
  <Passo>Adicione **Metadados** opcionais (categoria, fonte, data) para facilitar filtros futuros.</Passo>
  <Passo>Salve. O conteúdo é indexado de forma assíncrona — pode levar alguns segundos até estar disponível para busca.</Passo>
</Passos>

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

| Campo | O que faz |
|-------|-----------|
| **Base de destino** | Qual base receberá o novo conteúdo |
| **Conteúdo** | Texto ou referência ao conteúdo a indexar |
| **Metadados** | Informações extras para filtros e organização |

---

## Fluxo típico com RAG

```
Mensagem do cliente (Esperar Texto)
  ↓
Buscar na base de conhecimento  (busca os trechos mais relevantes)
  ↓
LLM  (recebe a pergunta + trechos + responde)
  ↓
Enviar Mensagem  (entrega a resposta ao cliente)
```

<Dica>

No prompt do nó LLM, instrua o modelo a usar apenas as informações encontradas na base de conhecimento e a avisar quando não souber a resposta. Isso evita que ele invente respostas.

</Dica>

<Cuidado>

Bases de conhecimento precisam de documentos indexados para funcionar. Se a base estiver vazia, o Buscar na base de conhecimento retorna uma lista vazia e o LLM não terá contexto para responder.

</Cuidado>

---

## Saiba mais

- [Buscar dados externos](/guia/flow-builder/dados/buscar-dados) — consulte APIs externas ou o CRM interno, além da base de conhecimento
- [Modelo de IA (LLM)](/guia/flow-builder/ia/llm) — use os trechos encontrados para gerar a resposta final