API/AI Gateway/Pesquisa semântica de vetores

Pesquisa semântica de vetores

GET/v1/ai/{project_id}/search

Executa consultas de similaridade semântica de alto desempenho em namespaces vetoriais com limites ajustáveis e limites top-k.

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

search.tstypescript

const { data: matches } = await aura.ai.semanticSearch(
  'What are the encryption requirements?',
  'legal-docs',
  { threshold: 0.8, top_k: 5 }
)

for (const match of matches ?? []) {
  console.log(`[${match.similarity.toFixed(2)}] ${match.content}`)
}

200.jsonjson

{
  "data": [
    {
      "id": "c3d4e5f6-7890-4abc-def1-234567890abc",
      "content": "All data at rest must be encrypted using AES-256-GCM or native Vault Transit KEKs...",
      "metadata": { "section": "compliance" },
      "similarity": 0.895
    }
  ]
}

Consulta

Parâmetros de consulta

Parâmetro	Tipo	Obrigatório	Descrição
`query`	`string`	sim	Frase de pesquisa ou consulta em linguagem natural.
`namespace`	`string`	sim	Namespace da partição de destino para consulta.
`top_k`	`number`	não	Máximo de documentos retornados (padrão `5`, max `100`).
`threshold`	`number`	não	Limite mínimo de similaridade de cosseno de `0.0` a `1.0` (padrão `0.7`).

Desempenho

Ajuste dinâmico HNSW

Informações

O endpoint de pesquisa define dinamicamente a variável hnsw.ef_search de PostgreSQL com base no top_k solicitado ((top_k * 4).max(64)), garantindo alto recall mesmo ao filtrar candidatos pós-índice.

v1.0 · revisado 31 de out. de 2026
↗ Especificação OpenAPI↗ GitHub

← ANTERIOR

Incorporações

PRÓXIMO →

RAG query & ingest