Modos de pesquisa: por palavra-chave, semântico, híbrido
Nesta página
Três abordagens para encontrar informação
O campo retrieval_mode aceita três valores, e esta escolha não é cosmética: determina o que o motor compara. Um modo analisa palavras, outro o significado e o terceiro faz ambos. Dependendo dos seus documentos e da forma como os seus utilizadores formulam as perguntas, a diferença de relevância entre dois modos pode ser dramática na mesma coleção.
Modo por palavra-chave: correspondência literal
O modo por palavra-chave comporta-se como um motor de pesquisa clássico. Compara as palavras da sua consulta com o texto indexado e apresenta passagens que contêm efetivamente essas palavras.
{
"query": "VAT rate 20%",
"source": { "collection_ids": ["col_fiscal"] },
"retrieval_mode": { "type": "keyword" }
}
A sua força reside na literalidade. Para uma referência de produto como “XR-2847”, um número de fatura, um artigo legal ou um acrónimo da indústria, não comete erros: ou a cadeia de caracteres está lá, ou não está. Não calcula nenhum embedding, o que o torna rápido. A sua fraqueza é exatamente o inverso desta qualidade: não compreende nada. Se o seu documento falar em “imposto sobre o valor acrescentado” quando o utilizador escrever “IVA”, a correspondência não ocorre e obtém zero resultados de um documento que continha efetivamente a resposta. Tudo depende então da coincidência de vocabulário entre o escritor e o leitor, o que é uma aposta arriscada assim que os seus utilizadores não são os autores dos documentos.
Modo semântico: compreensão do significado
O modo semântico transforma a consulta e os fragmentos (chunks) em vetores, comparando depois significados em vez de caracteres. Apresenta assim passagens relevantes mesmo quando não há palavras partilhadas.
{
"query": "how to reduce sales taxes",
"source": { "collection_ids": ["col_fiscal"] },
"retrieval_mode": { "type": "semantic" }
}
Esta consulta não contém nem “IVA” nem “isenção”, e no entanto apresentará passagens que tratam do IVA, do imposto sobre o valor acrescentado, de deduções fiscais ou de isenções. É exatamente o que deseja para um assistente virado para o público: os seus utilizadores pesquisam com as suas palavras, não com o léxico do seu departamento jurídico. O modo lida com sinónimos sem hesitar — “reembolso”, “nota de crédito” e “crédito” agrupam-se naturalmente no espaço vetorial. Em contrapartida, perde precisão onde esta é absoluta: um código de produto “XR-2847” parece semanticamente semelhante a “XR-2874”, e o motor pode devolver o errado. Cada consulta requer também um cálculo de embedding, pelo que existe um custo computacional que não existe no modo por palavra-chave.
Modo híbrido: ambos os sinais em simultâneo
O modo híbrido é o modo predefinido e o que a xAI recomenda, porque recusa o compromisso. Tome uma consulta jurídica típica, que mistura uma referência exata e um conceito difuso.
{
"query": "article L.121-3 director liability",
"source": { "collection_ids": ["col_juridique"] },
"retrieval_mode": { "type": "hybrid" }
}
O processamento ocorre em três etapas. O motor executa primeiro uma pesquisa por palavra-chave para capturar correspondências exatas, aqui a cadeia “L.121-3”. Executa em paralelo uma pesquisa semântica que procura passagens conceptualmente ligadas à responsabilidade dos administradores, mesmo quando não usam essas palavras exatas. Finalmente, funde as duas listas e reordena-as para maximizar a relevância global.
O resultado capta tanto os artigos que citam explicitamente o L.121-3 como os comentários que tratam da responsabilidade dos administradores sem mencionar o artigo. A cobertura (recall) melhora significativamente: perde menos documentos relevantes, independentemente do registo da pergunta. É por isso que o modo híbrido funciona tão bem para uma consulta técnica como para uma frase conversacional, e por que constitui a escolha predefinida razoável.
Duas situações justificam, no entanto, afastar-se desta definição. Se procura uma assinatura de função específica numa base de código, o ruído semântico joga contra si e keyword será mais afiado. Por outro lado, para uma exploração ampla — “o que é que escrevemos sobre a fidelização de clientes?” — sem um termo pivô para corresponder, semantic lança uma rede mais larga e ajuda-o a descobrir documentos que não estava à procura.
Comparação de modos
| Critério | keyword | semantic | hybrid |
|---|---|---|---|
| Termos exatos | Excelente | Razoável | Bom |
| Sinónimos | Fraco | Excelente | Bom |
| Linguagem natural | Fraco | Excelente | Excelente |
| Códigos/referências | Excelente | Fraco | Bom |
| Recomendação | Casos específicos | Exploração | Predefinido |
Uma forma simples de decidir: pegue em dez perguntas reais dos seus utilizadores, execute-as nos três modos na mesma coleção e compare os cinco primeiros resultados. Em quinze minutos, saberá se o seu corpus tende mais para o vocabulário exato ou para o significado.
Pontos-chave
- O modo por palavra-chave procura correspondências exatas — ideal para termos técnicos e referências
- O modo semântico compreende o significado — ideal para perguntas em linguagem natural
- O modo híbrido combina ambos — esta é a escolha predefinida recomendada
- Utilize
keywordpara pesquisas de códigos, identificadores ou valores exatos - Utilize
hybridem todos os outros casos