Postgres'te Yerel Yapay Zeka: NL2SQL, RAG ve Aracılar

Doğrulayıcı, CTE'leri/WITH yan tümcelerini, alt sorguları, UNION ifadelerini, beyaz listeye alınmamış işlevleri (saymak, toplam, ortalama, dk., maksimum, daha düşük, üst, birleşmek, tarih_trunc, şimdi) ve herhangi bir sistem kataloğu erişimi. Satır tavanı sunucu tarafında yapılandırılabilir ve sorgu başına kısıtlanabilir; hiçbir zaman kiracı sınırının ötesine genişletilmez.

Pgvector'u "kurmak" için ekstra adım gerekmez: uzantı, standart kiracı görüntüsüne eklenir. Besleme hattının kendisi, doğrudan Aurabase'e tasarlanmış uygulama düzeyinde bir yetenektir.

Depolama ad alanına göre yapılandırılmıştır: alınan her belge (POST /v1/ai/ /rag/ingest) parçalanır, gömülür ve eşleşen vektör boyutu sütununa eşlenir. Sorgu uç noktası (POST /v1/ai/ /rag/query) geri alma ve oluşturmayı birleştirir; özel bir uç nokta (GET /v1/ai/ /arama) bir LLM çağrısını tetiklemeden vektör benzerlik aramasını kendi başına ortaya çıkarır. Gömme modellerini değiştirmek veri kümenizi asla bozmaz: bir ad alanı yeniden indekslenebilir (POST /v1/ai/ /rag/ /reindex) belgeleri yeniden yüklemeden yeni bir model altında.

Teknik nüans nadiren başka bir yerde belgelenmiştir: 2.000 boyutun ötesinde, HNSW pgvector'ın standardını indeksleyemez vector yazın. 3072 boyutlar için Aurabase otomatik olarak şu avantajlardan yararlanır: yarımvec(3072) (hassasiyet azaltılmış, indekslenebilir) sorguları sessizce tam tablo taramalarına dönüştürmek yerine. Varsayılan olarak alma işlemi 5 pasaj döndürür (top_k) 0,3 benzerlik eşiğinin üzerinde — her iki parametre de sorgu başına geçersiz kılınabilir.

Yalnızca SELECT kısıtlamalarının ötesinde, doğrulayıcı ayrıca CTE'leri/WITH'i, alt sorguları, UNION/INTERSECT/EXCEPT ifadelerini, tablo değerli işlevleri (created_series, pg_sleep…), pencere işlevleri, dolar alıntısı ve kilitleme cümleleri (GÜNCELLEME İÇİN). Kapsamlı bir güvenlik yürüyüşü, DISTINCT ON, OFFSET, FETCH ve toplu ifadeler dahil olmak üzere tüm soyut sözdizimi ağacını geçerek hiçbir yasak işlevin denetlenmeyen bir AST düğümünden geçmemesini sağlar.

Uygulamada, aracıya sunulan araç, NL2SQL uç noktasına standart bir HTTP çağrısını sarar; SDK, isteği özel çerçeve eklentilerine ihtiyaç duymadan yürütür:

// Custom tool called by your agent's function calling loop
export async function nl2sqlTool(question: string) {
  const { data, error } = await aura.ai.nl2sql(question, undefined, { limit: 20 })
  if (error) throw error
  return { sql: data.sql, tables: data.tables }
}