Busca

Encontrar uma informação num acervo de milhões de documentos costumava exigir adivinhação: a palavra exata, o filtro certo, várias tentativas. Na Busca do DATTA você pergunta em português, como perguntaria a um colega — e recebe, na mesma tela, a resposta redigida pela IA e os documentos que a sustentam, lado a lado. Sem alternar entre "o chat de um lado e a busca do outro".

Onde ela vive hoje: a busca do dia a dia está incorporada ao Chat (menu lateral). A entrada "Busca" que existia na seção Descobrir foi removida em 2026-05-31; a página dedicada continua funcionando por URL direta (deeplink) — útil para favoritos e links compartilhados.

Quando usar a Busca

A Busca é para perguntas exploratórias sobre conteúdo (legislação, jurisprudência, processos, normas, documentos). Para criar artefatos — dashboards, pipelines, notebooks — use os copilots especializados.

Como usar

1. Abrir a Busca

Para o dia a dia, use o Chat no menu lateral — ele cobre a busca com IA e documentos. A página dedicada abre por URL direta: https://<seu-dominio>/search-hybrid.html (ou, dentro do shell, https://<seu-dominio>/index.html?view=search-hybrid, com a trilha DATTA › Descobrir › Busca).

2. Digitar a pergunta

O campo aceita qualquer pergunta em português. O placeholder "Como posso ajudar?" indica que você não precisa formatar nada.

Exemplos:

• prescricao intercorrente execucao fiscal
• Qual o prazo para embargos de declaracao?
• Empresas com socio em comum com CNPJ 12.345.678/0001-90
• Decisoes do STJ sobre tutela de urgencia em ambito tributario

Clique Buscar ou tecle Enter.

3. Ler a resposta da IA

Logo abaixo do campo aparece o card Resposta da IA:

• O texto surge gradualmente, em tempo real, enquanto a IA redige.
• Por padrão a resposta é truncada visualmente após algumas linhas, com efeito de "fade".
• Clique Continuar... para expandir a resposta completa na mesma página.
• Clique Abrir no chat completo para continuar a conversa de forma interativa no chat tradicional.

4. Explorar os documentos

Abaixo da resposta aparece a lista Documentos relevantes, paginada de 10 em

1. Cada item mostra:
2. Título do documento (ex.: "STJ — REsp 1.234.567/SP — Prescrição...")
3. Fonte (STJ, CPC, LEF, ...)
4. Score de relevância
5. Ranks de cada algoritmo: BM25, kNN e Graph (quando aplicável)
6. Trecho com os termos da busca destacados em amarelo

5. Abrir um documento

Clique em qualquer card de documento. Um painel lateral desliza pela direita com:

• A trilha Busca › <título do documento>
• O trecho relevante que originou o resultado
• O botão Mostrar documento completo — o texto integral aparece reconstruído a partir dos trechos indexados

Para fechar: tecle ESC, clique no X do painel, ou clique fora dele.

Como a busca funciona por baixo

Sua pergunta dispara dois caminhos em paralelo:

1. Resposta da IA — um modelo de linguagem redige uma síntese em português, com as fontes citadas, e transmite o texto em tempo real.
2. Busca textual híbrida — três estratégias de ranqueamento combinadas:
   • BM25 — casamento literal de texto;
   • kNN semântico — similaridade de significado por vetores, gerados pelo modelo de embedding ativo da plataforma;
   • Graph — as conexões do documento com o resto da base no grafo.

Os três rankings são fusionados por RRF 3-way (Reciprocal Rank Fusion): cada documento recebe um score final invariante à escala. A janela de espera é de poucos segundos — se um dos caminhos demorar, você continua vendo o outro carregar, e a tela nunca fica em branco esperando o mais lento.

Os mesmos recursos estão disponíveis para integração: a plataforma expõe um endpoint de busca híbrida e outro de resposta da IA em streaming — veja a referência de API. Detalhes técnicos da fusão de rankings estão em quill-search-suggest, seção "RRF 3-way real".

Atalhos úteis

Limites e expectativas

• Volume: paginação de 10 em 10 itens. Para resultados mais precisos, refine a pergunta — inclua tribunal, ano, artigo.
• Velocidade: p95 abaixo de 500 ms para a parte BM25 + kNN; a resposta da IA depende do modelo configurado na plataforma (vLLM Qwen3/DeepSeek local ou Gemini como alternativa).
• Atualização: a Busca usa índices vivos do OpenSearch — documentos novos ficam pesquisáveis assim que são ingeridos e catalogados automaticamente, sem reindexação manual.
• Privacidade: toda a busca acontece dentro da sua infraestrutura. Nenhum dado deixa o datacenter — inclusive a pergunta enviada à IA, processada pelo modelo local quando ele está configurado.

Quando algo não funciona

Busca no Chat — cards, página âncora e modo conversa

Desde 2026-05-28, o Chat principal exibe os resultados de busca como cards estruturados ao lado da resposta da IA — a mesma experiência da página de Busca, agora integrada à conversa.

Quando os cards aparecem

O chat detecta automaticamente quando a pergunta pede uma listagem:

• Verbos imperativos: "liste", "mostre", "exiba", "apresente", "me dê", "quais são", "todos os" / "todas as", "relacione".
• Buscas por entidade ou processo (ex.: liste informacoes da Maria, processos do CNPJ 12.345.678/0001-90) sempre ativam cards.

Perguntas conversacionais (ola, explique o art. 924) continuam com resposta inline, sem cards.

Página âncora (padrão)

Ao enviar uma pergunta de listagem, a tela funciona como uma página de resultados:

• Os cards aparecem acima da resposta assim que a plataforma encontra os registros — antes mesmo de o texto da IA terminar de chegar.
• Cada card mostra título, trecho, fonte (Neo4j, OpenSearch, Trino/JDBC) e score.
• Respostas longas da IA ficam compactadas: preview com efeito de fade e o botão Expandir resposta completa. A compactação vale desde o início da transmissão — a bolha não "salta" quando a resposta termina.

Detalhes de um resultado

Clique em qualquer card: um painel abre com a tabela chave-valor de todas as propriedades do registro (nome, CPF, endereço, etc.), com rótulos em português. Quando o resultado é um documento textual, o botão Abrir documento completo leva ao texto integral.

Modo conversa

Clique em Expandir resposta completa para entrar no modo conversa, voltado à leitura e ao diálogo focado com a IA:

• Todas as respostas longas mostram o conteúdo completo.
• Os cards somem para dar foco ao texto.
• Um banner discreto no topo oferece ← Voltar à página de resultados, que restaura os cards e os previews compactados.

Workspace na área de escrita — e as seções do histórico

Ao lado do indicador de contextos há o seletor de workspace. São dois controles distintos, e a diferença importa:

Os dois não se cascateiam: dá para ter um workspace ativo e ainda buscar em contexto fora dele.

O histórico fica seccionado por workspace, com o workspace ativo primeiro. A conversa guarda o workspace em que nasceu e não muda de seção depois — trocar de workspace muda quais seções você vê, não de quem são as conversas. Conversas criadas fora de workspace, e todas as anteriores a esta mudança, ficam em Sem workspace.

Trocar o workspace aqui é o mesmo que trocar pelo menu lateral: vale para a plataforma toda.

Histórico de conversas

O painel de histórico abre por padrão — é de onde se cria uma conversa nova, e escondê-lo escondia o botão. Se você o minimizar, a escolha fica guardada no navegador e vale nas próximas visitas.

Cada conversa tem um menu ⋯ (aparece ao passar o cursor) com duas opções:

• Renomear — abre um campo com o título atual já selecionado. Enter salva, Esc cancela.
• Excluir — pede confirmação: "Deseja excluir esta conversa? Esta ação não pode ser desfeita."

Os diálogos não fecham ao clicar fora, de propósito: excluir é irreversível, e renomear perderia o que você digitou. Esc cancela qualquer um deles.

O título é gerado automaticamente depois que a primeira resposta termina — antes disso, e sempre que a geração falhar, vale o começo da sua pergunta. Ele é escrito uma vez só: se você renomear, a plataforma não sobrescreve.

Nova conversa com uma conversa em andamento também pergunta antes — e o texto diz o que importa: a conversa atual não é perdida, ela continua no histórico.

Painel lateral — painéis e grafo em abas

O Chat abre um painel à direita para o que precisa ser visto ao lado da conversa, e não no lugar dela. O painel tem uma barra de abas: cada conteúdo aberto vira uma aba, e as abas convivem.

O que o painel faz:

• Cada aba fecha sozinha pelo × dela; o × do topo fecha o painel inteiro.
• A largura é ajustável: arraste a borda esquerda do painel. A medida fica guardada no navegador e volta na próxima vez.
• Expandir (o ícone de setas para fora, no topo) faz o painel ocupar a tela toda, escondendo a conversa e o histórico; o mesmo botão recolhe. Esc recolhe a expansão e, no painel já recolhido, fecha o painel.
• O painel pertence à conversa: ele fecha ao trocar de conversa no histórico ou ao iniciar uma nova. Mantê-lo aberto deixaria o grafo de uma conversa ao lado das mensagens de outra.

O grafo era, antes, uma janela que cobria a tela inteira — ler a resposta e explorar as ligações eram duas coisas que não cabiam juntas. Como aba, os dois ficam visíveis ao mesmo tempo; quando o grafo precisa de espaço, o botão de expandir devolve a tela cheia.

No celular o painel cobre a tela, como qualquer gaveta: não há coluna para dividir numa largura dessas.

De onde vêm os resultados

A busca por entidade consulta todas as fontes em paralelo: os bancos de grafo dos contextos cadastrados (resolvidos dinamicamente pela configuração, nunca fixos em código), os índices de documentos de domínio e os agentes de banco de dados conectados. Dados internos da plataforma — telemetria, auditoria, permissões — são excluídos automaticamente.

Seletor de Contextos — escolha o que a busca considera

No topo da tela, o seletor Contextos lista todos os contextos cadastrados na plataforma, cada um com o status de conexão e um interruptor para ligar ou desligar aquele contexto na busca:

• Contexto desligado sai da busca por completo: o grafo, os documentos e os índices daquele contexto não são consultados em nenhuma rota — nem na busca direcionada, nem na varredura entre contextos, nem na página de resultados em cards.
• Se a pergunta apontar para um contexto desligado, a busca segue apenas nos contextos ativos — não retorna erro. O assistente também é instruído a não responder de memória sobre o conteúdo do contexto desligado: em vez de recitar a informação, ele avisa que o contexto está desativado e como reativá-lo.
• Quando há contexto desligado, o rótulo do seletor mostra a contagem (ex.: Contextos (3/5 ativos)).
• Clique no nome do contexto para abrir a configuração dele (como antes); o interruptor age só na busca.

A seleção é por usuário e salva na plataforma (não no navegador): entrando em outra máquina, os mesmos contextos permanecem ligados/desligados. Contexto recém-criado nasce ativo. Usuário não autenticado não vê os interruptores — a busca considera tudo.

Contextos na área de escrita — e o alargamento automático

O indicador Contextos fica ao lado do campo de pergunta, e não no topo da tela: trocar o escopo tem efeito na próxima pergunta, então o filtro mora junto do ponto de ação. Clicar abre a lista, cada contexto tem uma caixa, e a mudança vale na hora — não há botão de confirmar. A seleção é a mesma do seletor do topo: uma preferência por usuário, guardada no servidor.

Contexto não é workspace. O workspace agrupa contextos, organiza o histórico de conversas e filtra quais painéis aparecem; o contexto é o escopo de busca da IA. Os dois são independentes: dá para ter um workspace ativo e ainda buscar em contexto fora dele.

O modo Pesquisa / Investigação deixou de existir. Antes era o analista quem avisava, por um botão, que a pergunta merecia varrer todas as bases — o que exigia saber disso antes de perguntar. Agora quem decide é a busca:

• a pergunta é atendida no contexto que a plataforma identifica;
• se ali não houver resultado, a busca amplia sozinha para os demais contextos aos quais você tem acesso;
• ampliar não amplia permissão: contexto que você desligou, ou que o workspace não alcança, continua fora;
• quando a resposta vem de outro contexto, ela diz de onde veio — a troca de escopo nunca é silenciosa.

Chat do workspace — busca escopada aos contextos do workspace

Ao abrir o Chat pelo menu de um workspace (ícone de chat dentro do grupo do workspace no menu lateral), a plataforma direciona para uma tela própria de chat escopada: toda a busca considera somente os contextos daquele workspace, e não os dados gerais da tela inicial.

• O indicador Contextos, na área de escrita, mostra quantos contextos do workspace estão na busca — ex.: Contextos 3/4 quando um deles está desligado.
• O escopo é resolvido no servidor pelo id do workspace, com a identidade do usuário logado: workspace restrito por membros só resolve para quem o enxerga. Se o workspace não puder ser resolvido (excluído, sem acesso ou serviço de configuração indisponível), a busca não degrada para "sem escopo" — a tela exibe uma mensagem clara pedindo para tentar novamente.
• O seletor Contextos continua valendo dentro do workspace: contexto desligado pelo usuário permanece fora da busca mesmo pertencendo ao workspace.
• A página de resultados em cards (documentos abaixo da resposta) segue o mesmo escopo.
• O Chat geral (breadcrumb DATTA › Chat, ou o botão de página inicial) segue sem escopo: varre todos os contextos ativos, como antes. O chat do workspace tem breadcrumb DATTA › Workspace › Chat.
• Workspace sem contextos cadastrados não tem dado a escopar: o chat abre sem a marcação ao lado do modo e busca como o Chat geral.

O chat aprende com você

O chat usa o seu próprio histórico — nunca o de outros usuários — para melhorar as respostas:

• Memória por usuário: além de pares pergunta/resposta anteriores, trechos de conversas antigas semanticamente próximos da pergunta atual entram como contexto da resposta. A conversa em andamento não é duplicada, e o histórico de outro usuário nunca aparece.
• Avalie a resposta: cada resposta do assistente traz as ações útil / não útil (polegar para cima/para baixo — aparecem ao passar o mouse sobre a mensagem; sempre visíveis no celular). A avaliação alimenta o aprendizado da busca, e "não útil" pesa mais que qualquer sinal automático. Só o dono da conversa pode avaliá-la; falha ao registrar mostra aviso e permite tentar de novo.
• Cliques personalizam o ranking: documentos que você abriu nos resultados ganham prioridade nas suas próximas respostas — sinal pessoal, com identificador protegido por hash, que também vale na página de cards.
• Correções viram expansão de busca: quando você reformula uma pergunta e o novo texto funciona (ou você marca "útil"), a plataforma aprende a associação — primeiro para você, depois para todos.

Onde ler mais

• Páginas relacionadas: prompt personalizado do usuário · modelo de raciocínio do chat
• Arquitetura da fusão de rankings: quill-search-suggest; o comportamento do chat (modo listagem, página âncora e modo conversa) está detalhado na documentação de arquitetura do chat.