Atende Direito · Docs

Tema

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 ​

Para que serve

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.

Quando usar
  • 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 quando os dados estão indexados como conhecimento
Passo a passo
  1. Certifique-se de ter documentos indexados em pelo menos uma base de conhecimento.
    Etapa Base de Conhecimento do assistente de criação de agent, sem nenhum artigo publicado ainda para vincular

    Etapa Base de Conhecimento do assistente de criação de agent, sem nenhum artigo publicado ainda para vincular

  2. Arraste o nó **Buscar na base de conhecimento** para o canvas e conecte ao fluxo.
  3. Selecione as **Bases de Conhecimento** que o nó deve consultar (pode ser mais de uma).
    Painel de configuração do nó Recuperação de conhecimento, com as seções Consulta, Bases de conhecimento e Configuração de recuperação

    Painel de configuração do nó Recuperação de conhecimento, com as seções Consulta, Bases de conhecimento e Configuração de recuperação

  4. Configure a **Query** escolhendo a variável no seletor de variáveis — geralmente a mensagem do cliente (como `flow.user_text`).
  5. Ajuste o **Limite de resultados** (quantos trechos retornar) e o **Reranker** se disponível.
  6. Salve. Os trechos encontrados ficam em {{knowledge_retrieval.result}}, prontos para passar a um nó Modelo de IA (LLM).
Campos
CampoO que faz
Bases de conhecimentoQuais bases consultar
QueryTexto de busca. Escolha a variável no seletor de variáveis
Limite de resultadosMáximo de trechos retornados
Modo de buscaSemântica (significado), Keyword (palavras exatas) ou Híbrida
RerankerReordena os resultados pelo mais relevante antes de retornar

Para quem edita o JSON ou usa a API: o campo query_variable_selector recebe uma referência de variável, no formato que o canvas grava:

json
{ "type": "ref", "path": "flow.user_text" }

O formato antigo em lista ({"type":"literal","value":["flow","user_text"]}) é convertido automaticamente para ref ao publicar. Se um fluxo ainda estiver com o formato antigo, a execução é recusada com erro claro.

Modos de busca ​

ModoQuando usar
SemânticaPerguntas em linguagem natural — o modelo entende o significado
KeywordQuando o cliente usa termos técnicos ou códigos exatos
HíbridaO melhor dos dois mundos — recomendado para uso geral

Base de conhecimento · knowledge_base ​

Para que serve

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.

Quando usar
  • 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
Passo a passo
  1. Arraste o nó **Base de conhecimento** para o canvas.
  2. Selecione a **Base de Destino** onde o conteúdo será indexado.
  3. Configure o **Conteúdo** — pode ser texto direto, resultado de um extrator de documento ou qualquer variável do fluxo.
  4. Adicione **Metadados** opcionais (categoria, fonte, data) para facilitar filtros futuros.
  5. Salve. O conteúdo é indexado de forma assíncrona — pode levar alguns segundos até estar disponível para busca.
Campos
CampoO que faz
Base de destinoQual base receberá o novo conteúdo
ConteúdoTexto ou referência ao conteúdo a indexar
MetadadosInformaçõ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.

Saiba mais ​