Source: https://docs.aivax.net/pt-br/docs/rag/semantic-search.html

# 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](https://docs.aivax.net/pt-br/docs/rag/reflex.md): 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:

[API endpoint reference](https://inference.aivax.net/apidocs?embed=iframe&embed-endpoint=Semantic%20search)

## 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](https://docs.aivax.net/pt-br/docs/rag/reranking.md) 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:

```text
How do I cancel an annual subscription without a penalty?
```

Em vez de palavras‑chave desconexas:

```text
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](https://docs.aivax.net/pt-br/docs/mcp-utilities/collections-mcp.md).

Para a disponibilidade atual do serviço e limites de conta, veja [Plans and Limits](https://docs.aivax.net/pt-br/docs/limits.md).