Provenant: Yapay Zekâ Kodlama Ajanları İçin Wiki Tabanlı Akıllı Bilgi Geri Çağırma Sistemi

Yapay zekâ destekli kodlama ajanları (AI coding agents) popülerleşse de, büyük kod tabanlarında (codebase) doğru bilgiye ulaşmak hâlâ ciddi bir teknik zorluktur. Geleneksel yöntemler ham kaynak kodları üzerinde basit metin aramaları yaparken, Provenant bu süreci tamamen değiştiren açık kaynaklı bir Python kütüphanesidir. Kod tabanınızın wiki tarzında son derece sıkıştırılmış bir temsilini oluşturarak, yapay zekâ modellerinin aradıklarını saniyeler içinde bulmasını sağlar. Bu durum geliştiricilerin hem zamandan hem de API maliyetlerinden tasarruf etmesini sağlar.

Provenant Nedir ve Geliştiricilere Ne Sunar?

Provenant, yapay zekâ ajanları için tasarlanmış wiki tabanlı bir bilgi geri çağırma (retrieval) katmanıdır. Geleneksel araçlar ham kodları doğrudan sorgulayıp bağlamı gürültülü hale getirirken, Provenant öncelikle tree-sitter kütüphanesini kullanarak tüm kaynak kodları dil bağımsız olarak yapısal olarak ayrıştırır ve soyut sözdizim ağaçları oluşturur. Ardından, bir LLM kullanarak her modül ve dosya için insan tarafından okunabilir wiki belgeleri üretir.

Arama işlemleri ham kod yerine bu sıkıştırılmış wiki dizini (SQLite/FTS5 ve LanceDB) üzerinden yapılır. Bu yaklaşımın geliştiricilere sağladığı faydalar şunlardır:

65 kata kadar token tasarrufu: Devasa ham kodlar yerine yalnızca ilgili özet wiki sayfaları modele aktarılır.
Yüksek Doğruluk Oranı: SWE-bench Verified kıyaslamasında Coverage@5 değerinde +24 yüzdelik puan artışı elde edilmiştir.
Dil Boşluğunu Kapatma: Yapay zekanın doğal dildeki soruları ile kodun teknik sözdizimi arasındaki kavramsal farkı (vocabulary gap) ortadan kaldırır.

Pratik Kullanım Örnekleri

Provenant'ı kurmak ve projenizi indekslemek oldukça basittir:

# Provenant paketini pip ile yükleyin
pip install provenant

# Projenizin dizinini belirterek wiki indeksini oluşturun
provenant index --path /projenizin/yolu

Provenant, yerel bir Model Context Protocol (MCP) sunucusu olarak çalışır. Claude Desktop veya Cursor gibi MCP istemcilerinin config.json dosyasına şu şekilde entegre edilebilir:

{
  "mcpServers": {
    "provenant": {
      "command": "python",
      "args": ["-m", "provenant.mcp"]
    }
  }
}

Entegrasyon sonrasında AI kodlama ajanınız şu araçları otomatik olarak kullanabilir hâle gelir:

provenant_ask: BM25 ve HyDE yöntemlerini birleştirerek hibrit arama yapar ve güven skoru yüksek yanıtlar sunar.
provenant_search: Üretilen wiki sayfalarında anlamsal (semantic) arama gerçekleştirir.
provenant_context: Ajanın çözmek istediği problem için en doğru bağlamı getirir.

Benzer Araçlarla Karşılaştırma

Geleneksel arama araçları (ripgrep veya klasik BM25) yalnızca birebir kelime eşleşmelerine odaklanır ve kodun mantıksal amacını kavrayamaz. Diğer ham kod tabanlı RAG kütüphaneleri ise kod satırlarını doğrudan vektör veri tabanına yükleyerek yüksek bilgi gürültüsüne ve aşırı token maliyetlerine yol açar.

Provenant ise kodun özetini çıkararak temiz bir "Wiki" sunar. Ayrıca, ajan tarafından az kullanılan veya kalitesiz bulunan wiki sayfalarını arka planda otomatik olarak yeniden yazan kendi kendini iyileştirme (self-healing) döngüsüne sahiptir. Bu döngü, yapay zekâ modelinden gelen geri bildirimlerle dizinin kalitesini her sorguda dinamik olarak geliştirir.

Orijinal repoya buradan ulaşabilirsiniz.