LlamaIndex lançou legal-kb: busca de documentos com agentes através de quatro ferramentas no Index v2

Em 5 de julho de 2026, LlamaIndex publicou um aplicativo de referência público chamado legal-kb — um template aberto para busca alimentada por agente em um corpus de documentos construído no Index v2.

O que legal-kb consegue fazer

O aplicativo constrói uma base de conhecimento com acesso no estilo de sistema de arquivos: o agente trabalha com documentos não através de uma única consulta RAG, mas através de quatro ferramentas especializadas.

• retrieve — busca semântica híbrida em toda a base de conhecimento
• find — busca de documentos por nome ou metadados
• read — leitura do conteúdo completo de um arquivo específico
• grep — busca de texto exato dentro dos documentos

Este conjunto de ferramentas permite que o agente trabalhe metodicamente. Ao receber uma consulta, ele primeiro executa um retrieve semântico para encontrar documentos relevantes, depois refina através de find usando metadados, lê o texto completo via read e verifica a formulação exata através de grep. Isso difere fundamentalmente do RAG clássico, onde toda a busca ocorre em uma única etapa sem possibilidade de refinamento.

Stack técnico e recursos principais

O aplicativo é construído em quatro componentes:

• TanStack Start — renderização no servidor e roteamento
• AI SDK 6 com ToolLoopAgent — gerenciamento do loop de invocação de ferramentas
• Prisma — ORM para operações de banco de dados
• WorkOS — autenticação e gerenciamento de acesso do usuário

Além das ferramentas de busca, legal-kb implementa dois recursos importantes. O primeiro é o versionamento automático de arquivos: cada documento recebe uma versão após o upload, e o sistema registra qual revisão específica o agente utilizou ao responder. O segundo são citações visuais: a interface mostra ao usuário o fragmento exato do documento de origem de onde a informação veio.

Para o contexto legal ao qual o nome legal-kb se refere claramente, ambos os recursos são criticamente importantes. Uma referência incorreta a uma versão desatualizada de um contrato ou uma citação imprecisa de um documento regulatório pode ter consequências sérias. O versionamento e as citações visuais mitigam diretamente esse risco, tornando o trabalho do agente transparente e verificável.

Por que os desenvolvedores precisam disso

Legal-kb é publicado como um aplicativo de referência: seu código é aberto e serve como um exemplo arquitetônico para equipes que constroem sistemas de IA empresariais baseados em documentos proprietários. Os casos de uso típicos incluem análise de contratos, busca em diretrizes regulatórias e trabalho com políticas e procedimentos internos.

Index v2 está se tornando a base para um número crescente de aplicações agentivas no ecossistema LlamaIndex. Ao publicar legal-kb como um exemplo público, a empresa mostra aos desenvolvedores como combinar corretamente múltiplas ferramentas de busca em um único ciclo de agente — em vez de depender de uma única chamada RAG monolítica. Para equipes que precisam de alta precisão na atribuição de fontes, é um ponto de partida pronto.

O que isso significa

A busca alimentada por agentes com um conjunto de ferramentas especializadas está gradualmente substituindo o RAG de uma única passagem em tarefas onde precisão e rastreabilidade de fontes importam mais que velocidade. Legal-kb é um template prático que desenvolvedores podem usar como base para soluções empresariais com requisitos similares.