Busca Semântica

A API de busca semântica pesquisa uma ou mais coleções e retorna os documentos indexados mais relevantes para os termos de busca fornecidos.

Se sua aplicação já possui as strings dos documentos candidatos, considere Reflex: uma busca RAG sem coleção que classifica os documentos fornecidos sem indexação ou armazenamento. Use a busca semântica gerenciada quando a AIVAX precisar armazenar e pesquisar um corpus persistente ou quando o corpus for grande demais para ser enviado como candidatos em cada requisição.

Após criar uma coleção, pesquise-a com termos completos que reflitam a pergunta que o usuário faria. A resposta pode incluir os documentos correspondentes e seus dados de coleção associados para uso em sua aplicação ou fluxo do AI Gateway.

Para o contrato de requisição, resposta, autenticação e erro suportados, use a Referência da API:

Reordenação #

Um reordenador pode ajustar a ordem dos candidatos retornados pela busca semântica. Ele não pesquisa documentos adicionais nem recupera texto que a fase de recuperação não selecionou. Consulte Rerankers para orientações de seleção.

Múltiplos Termos #

Múltiplos termos cobrem caminhos de recuperação alternativos em vez de exigir que cada termo corresponda ao mesmo documento. Use-os para sinônimos, formulações alternativas ou várias maneiras aceitáveis de encontrar uma resposta.

Se a intenção do usuário for uma ideia composta, envie essa ideia como um termo completo. Por exemplo, prefira:

How do I cancel an annual subscription without a penalty?

Em vez de palavras‑chave desconexas:

cancellation
annual subscription
penalty

Qualidade da Busca #

Uma consulta completa geralmente tem desempenho melhor do que uma lista de palavras‑chave desconexas porque preserva a relação entre os conceitos.

Se a busca retornar resultados ruins:

1. Confirme que os documentos estão indexados.
2. Consulte a coleção diretamente antes de testar através de um AI Gateway.
3. Compare perguntas completas com formulações alternativas.
4. Verifique se o documento relevante é muito curto, muito longo ou não está autocontido.
5. Verifique se o idioma da consulta corresponde ao idioma do documento.
6. Se o gateway reescrever perguntas antes da busca, teste com o caminho de consulta simples para isolar problemas de reescrita.

Collections MCP #

Para expor as coleções da AIVAX como ferramentas para um cliente MCP externo, veja Collections MCP.

Para a disponibilidade atual do serviço e limites de conta, veja Plans and Limits.