API'si/AI Gateway/Anlamsal Vektör Arama

Anlamsal Vektör Arama

GET/v1/ai/{project_id}/search

Ayarlanabilir eşikler ve üst k limitleriyle vektör ad alanları genelinde yüksek performanslı anlamsal benzerlik sorguları gerçekleştirir.

Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

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
    }
  ]
}

Sorgu

Sorgu Parametreleri

Parametre	Tür	Gerekli	Açıklama
`query`	`string`	evet	Arama ifadesi veya doğal dil sorgusu.
`namespace`	`string`	evet	Sorgulanacak bölüm ad alanını hedefleyin.
`top_k`	`number`	hayır	Döndürülen maksimum belge (varsayılan `5`, maksimum `100`).
`threshold`	`number`	hayır	`0.0` ile `1.0` arası minimum kosinüs benzerliği eşiği (varsayılan `0.7`).

Performans

Dinamik HNSW Ayarlama

Bilgi

Arama uç noktası, PostgreSQL'nin hnsw.ef_search değişkenini istenen top_k ((top_k * 4).max(64)) temel alarak dinamik olarak ayarlar ve indeks sonrası adayları filtrelerken bile yüksek geri çağırmayı garanti eder.

v1.0 · revize edildi 31 Eki 2026
↗ OpenAPI spesifikasyonu↗ GitHub

← ÖNCEKİ

Gömmeler

SONRAKİ →

RAG query & ingest