Maguyva Nasıl Çalışır

Bir GitHub reposu bağlayın, Maguyva onu ajanınızın ihtiyaç duyduğu anda kullanabileceği birkaç aranabilir görünüme dönüştürsün. Bütün dosyaları bağlama boca etmek yerine, model sembollere, yapıya, dokümanlara, bağımlılıklara ve sıralanmış kod parçalarına temellendirilmiş erişim kazanır.

Projeleriniz büyüdükçe AI ajanları şunlarla mücadele eder:

• Bağlam Penceresi Sınırlamaları - Çok fazla bilgi AI modellerini bunaltır
• İlgisiz Veri - AI ajanları gereksiz bilgiler için token harcar
• Zayıf Performans - Düşen doğruluk ve yavaşlayan işleme süreleri
• Manuel Yönetim - Geliştiriciler bağlamı manuel düzenlemek için saatler harcar
• Daha Yüksek Maliyetler - Bağlam yönetimi olmadan token maliyetleri her sorguda artar

Bir repo bağladığınızda Maguyva; kod, dokümanlar, manifestolar, semboller ve bağımlılık meta verileri üzerinde bulut işleme hatları çalıştırır. Amaç, her ajanın reponuzu sıfırdan yeniden keşfetmesi yerine kalıcı kod belleğini bir kez oluşturmaktır.

Bu hatlar birkaç uzman veri katmanı üretir: tam metin arama, anlamsal getirme, sembol ve referans aramaları, yapısal görünümler ve bağımlılık grafı analizi. Farklı sorular farklı katmanlara yönlendirilir.

Maguyva, 5 bilgi getirme yeteneği sunar: semantic, AST, symbol, dependency ve text. intelligent_search içinde dört arama yöntemi vardır: anlamsal, metin, yapısal ve graf. Varsayılan auto/balanced, tanım aradığı yüksek güvenle belirlenen sorguları yapısal aramaya, referans veya etki sorgularını grafa, tam eşleşme sorgularını ise metin aramasına yönlendirir. Diğer sorgular anlamsal anlamı ve dizinlenmiş metni kullanır. Dört arama yönteminin tümünü istemek için mode=hybrid veya quality=thorough ile auto kullanın; açıkça belirtilen mod, quality ayarından önce gelir. language_filter, grafı auto/hybrid kapsamından çıkarır ve açıkça belirtilen graf moduyla birlikte kullanıldığında reddedilir. Birden çok yöntemden gelen sonuçlar birleştirilir ve sorguyla ilgilerine göre sıralanır.

Özel repo görünümleri, desteklenen dil ve metin tabanlı teknoloji için genel referans verileriyle yan yana durur. Ajanınız tüm sisteme MCP araçları üzerinden erişir; bunlara planlama ve doğrulama sırasında ağırlıklı olarak dayanabilir ya da düzenleme sırasında nokta kontrolü olarak kullanabilirsiniz.

GitHub bağlandıktan sonra Maguyva reponuzu bulutta tarar ve bir ajanın gerçekten akıl yürütmek için ihtiyaç duyduğu parçaları çıkarır:

• Kod Yapısı Analizi ░╔═╗░ ▓║◉║▓ ░╚═╝░ - Dosyaları sembollere, referanslara ve mimari sınırlara ayrıştırır
• Bağımlılık Çözümlemesi ╲▄█▄╱ ─◆●◆─ ╱▀█▀╲ - Dosyaların, modüllerin ve sembollerin birbirine nasıl bağlı olduğunu haritalar
• Dokümantasyon Entegrasyonu - Repo dokümanlarını ve ilgili referans materyalini kodun yanına çeker

Tek bir genel dizin yerine Maguyva, farklı soruları hızla ve farklı kanıtlarla yanıtlayan birkaç getirme yüzeyi oluşturur:

• Alaka Puanlaması ▄█▄ ║⊙⊙║ ╚═█═╝ - Arama moduna ve kalite önayarına göre erişim kanıtını seçer, ardından eşleşmeleri sorguyla ilgilerine göre sıralar
• Gürültü Azaltma - Yinelenen eşleşmeleri azaltır ve tek bir dosyanın sonuç penceresini doldurmaması için dosya başına parça sayısını sınırlar
• Bağlam Önceliklendirme - Varsayılan olarak sonuçları sınırlı ve ilgili tutar. Önem ağırlıklandırması, mimariyi incelemek için boost_by_importance=true ile isteğe bağlı olarak etkinleştirilir; varsayılan sıralama politikası değildir

• Anlamsal Getirme ┌─◈─┐ ║███║ ╚═══╝ - Tam kelimeler farklı olsa bile kavramsal olarak benzer kodu ve dokümanları bulur
• Sembol ve Yapısal Görünümler - Tam sembol arama, referanslar ve AST şeklindeki soruları destekler
• Bağımlılık Grafı Analizi ▓█▓ ╔═●═╗ ╚═╤═╝ - Kod tabanı genelinde çağıranları, importları ve etki yarıçapını takip eder

Maguyva, bulutta barındırılan bir MCP sunucusu olarak sunulur. Ajanınız, modelin mimarinizi sıfırdan hatırlamasına güvenmek yerine ihtiyaç duyduğu mercek için araçları çağırır. Yukarıdaki dört yüzey, somut araçlar üzerindeki gruplandırılmış görünümlerdir: Anlamsal Arama semantic_search ve intelligent_search'ü kapsar; Sembol Arama find_symbol ve get_task_context'ü kapsar; Yapısal Arama structural_search ve text_pattern_search'ü kapsar; Bağımlılık Grafı dependency_search ve analyze_dependencies'i kapsar — destekleyici araçlar olarak get_file, repository_context ve ask_maguyva'nın yanı sıra. Tüm 11 araç için tam MCP API referansı bölümüne bakın.

• Daha Fazla veya Daha Az Araç Kullanın - Planlama sırasında Maguyva'ya ağırlıklı olarak dayanın ya da yalnızca riskli bir değişikliğin mantıklı olup olmadığını kontrol etmek için kullanın
• Daha İyi Plan Doğrulaması - Düzenlemeden önce fikirlerinizi gerçek semboller, referanslar ve dokümanlarla çapraz kontrol edin
• Daha Net Etki Yarıçapı - Bağımlılık ve graf araçları, bir sembol değişirse nelerin bozulabileceğini gösterir
• İleriye Dönük Uyumlu - MCP standardını destekleyen her istemciyle çalışır

• Taşıma Güvenliği - Hizmete bağlantılar HTTPS/TLS kullanır
• Yönetilen Depolama - Dizinlenmiş veriler, bekleme durumunda depolama düzeyinde şifrelemeyle yönetilen altyapıda saklanır
• Ad Alanı İzolasyonu - Repo verileri, işleme hattı ve veritabanı sorgu yolları boyunca çalışma alanı ve ad alanına göre sınırlandırılır
• Erişim Kontrolleri - Repo erişimi organizasyon ve ad alanı sınırlarıyla kısıtlanır

Performans, kod tabanı boyutuna ve sorgu karmaşıklığına göre değişir. Maguyva, bütün dosyaları boca etmek yerine en ilgili bağlamı sunmaya odaklanır. Desteklenen diller ve istemciler için uyumluluk bölümüne bakın.

Kod tabanı bağlamınızı akıllıca filtreleyip düzenleyerek Maguyva, AI ajanlarının daha verimli çalışmasına yardımcı olur:

• Daha İyi Planlama Doğruluğu - Ajanlar, kodlamaya başlamadan önce bir yaklaşımı gerçek repoya karşı doğrulayabilir
• Daha Güvenli Refactor'lar - Etki yarıçapı ve bağımlılık kontrolleri önlenebilir bozulmaları azaltır
• Daha Az Token İsrafı - Bütün dosyalar yerine yalnızca ilgili parçalar döndürülür
• Daha Hızlı Repo Anlayışı - Model, her çalıştırmada proje yapısını yeniden keşfetmek yerine hızla temellendirilmiş yanıtlar alır

• Repo Senkronizasyonu - Kod değiştikçe GitHub senkronizasyon işlerinden yenilenir
• Artımlı İşleme - Verimlilik için yalnızca değişen dosyaları işler
• Dal Bilinçli Bağlam - Her git dalı için ayrı dizinler tutar; böylece ajanlar her dal için doğru bağlamı görür

Denemeye hazır mısınız?

1. Ücretsiz başlayın - Kredi kartı gerekmez
2. Reponuzu bağlayın - Maguyva portalında bir GitHub reposu bağlayın
3. Ajanınızı Maguyva'ya yönlendirin - Planlarken, kontrol ederken veya düzenlerken MCP araçlarını kullanın (kurulum rehberi)

Ücretsiz başlayın →

GitHub repolarınızı Maguyva portalından bağlayın. Kod değiştikçe GitHub eşitleme işleri dizinleri yeniler. Portal, API kullanımını da gösterir.