Documentação

Deep Search

🔎 Deep Search na API Nama

O Deep Search é um endpoint avançado que foi desenhado para ir além de uma busca simples. Ele permite que a aplicação realize buscas profundas e inteligentes.

De forma simples, é uma funcionalidade que permite ao sistema pesquisar, combinar informações de diversas fontes e, então, gerar uma resposta super contextualizada, tudo em um único fluxo.

Como o Deep Search Funciona

O Deep Search da Nama segue um processo de 4 etapas que se assemelha muito ao conceito de RAG avançado (ou RAG Agente):

#EtapaO Que Acontece
1.Análise da PerguntaO sistema recebe sua consulta e identifica os conceitos principais para determinar a melhor estratégia de busca.
2.Expansão de ContextosO sistema busca ativamente informações relevantes nos datasets da sua aplicação e, se habilitado, na web (Busca Web opcional).
3.Agregação de DadosTodos os pedaços de informação coletados (de múltiplas fontes, como datasets internos e a web) são combinados e processados.
4.Geração InteligenteFinalmente, o modelo de linguagem (LLM) produz a resposta final. Essa resposta é contextualizada porque é baseada em todos os dados que foram coletados e combinados nas etapas anteriores.

🛠️ Por Que é Chamado de "Deep" (Profundo)?

É "profundo" porque não se contenta com uma única consulta e uma única fonte. Em vez disso, ele:

  • Combina Múltiplas Fontes: Pode usar tanto seus dados internos (datasets) quanto a internet (busca web), de forma integrada.
  • Identifica Conceitos-Chave: Em vez de tratar sua pergunta como uma string única, ele a analisa e identifica conceitos, buscando dados específicos para cada um.
  • Retorna em Stream: A API envia dados em tempo real (chunks), e você pode ver o progresso do processamento através de marcadores de status como starting, expanding, retrieving, generating, e done.

Em termos práticos: Se você perguntar algo complexo, o Deep Search da Nama é projetado para atuar como um pesquisador diligente, reunindo o máximo de informações relevantes possível antes de dar a resposta.