Como funciona

Por dentro da Nixa.

Um RAG sobre a documentação oficial da NICE CXone: indexação, busca híbrida, rerank e resposta com a fonte. Tudo aberto, do crawler ao prompt.

01

Como funciona

Dois momentos: a indexação acontece uma vez (ou sempre que você quiser atualizar a base) e a conversa roda a cada pergunta.

Fase 01 — preparação

Indexação

Roda uma vez, ou ao atualizar docs.

  1. Crawler

    Visita ~90 URLs NICE/CXone (help center, developer portal, GitHub). Extrai conteúdo + breadcrumb de cada página.
  2. Chunking

    Quebra texto em pedaços de ~900 caracteres com 200 de overlap. Cada chunk leva o caminho da seção embutido.
  3. Embeddings

    Converte cada chunk em vetor numérico via Gemini, OpenAI ou Ollama (local). Esse vetor representa o significado.
  4. Armazenamento

    Salva chunks + vetores + metadata em JSON local (data/vectorstore.json). Zero infra, persistência em disco.

Fase 02 — em tempo real

Conversa

A cada pergunta que você envia.

  1. Pergunta

    Você escreve em português (ou inglês). A query original é preservada.
  2. Expansão PT → EN

    Dicionário técnico adiciona termos em inglês equivalentes (ex: "sentimento" → "sentiment positive negative neutral") pra melhorar recall em docs.
  3. Busca híbrida + rerank

    Cosine semântico + similaridade léxica, top-5 chunks. Rerank ajusta com sinais: autoridade da fonte, page_type, recência, match no breadcrumb.
  4. Gate de domínio

    Se nenhum chunk passa do threshold (0.22) E a pergunta não tem termos NICE, devolve "fora de escopo" sem chamar o LLM.
  5. LLM responde

    Os chunks viram contexto XML estruturado por tipo. O LLM (Gemini, OpenAI, Ollama) gera a resposta citando fonte inline.
Nixa

Open source

Bora construir junto?

A Nixa é um projeto aberto — issue, ideia, correção de doc ou PR, tudo é bem-vindo. Se você trabalha com NICE CXone e sentiu falta de alguma fonte no índice, abra uma issue contando qual.