Maguyva, AST ayrıştırma ve sembol çıkarımıyla Python'ı destekler; yapay zeka ajanlarının gerçek Python repolarında dekoratörleri, self/cls metotlarını, import'ları ve modüller arası bağımlılıkları takip etmesine yardımcı olur.
Python, pek çok yapay zeka kodlama aracının başta iyi göründüğü ama sonra üretimde tahmin yürütmeye başladığı yerdir. Zor kısımlar tanıdıktır: dekore edilmiş giriş noktaları, servis sınıfları, tip taslakları, her yerdeki küçük yardımcı modüller ve yalnızca self veya cls’i ait oldukları sınıfla yeniden bağladığınızda anlam kazanan metotlar.
Python için gerçek soru “.py dosyalarını okuyabilir mi?” değildir. Soru, ajanın bir uç noktadan bir servise, bir arka plan görevinden bir yardımcıya veya bir sınıf adından davranışı gerçekten uygulayan metotlara geçerken temellendirilmiş kalıp kalamayacağıdır.
Maguyva, Python’ı tam bir yapısal dil olarak ele alır. Yapılandırma .py, .pyw ve .pyi’i kapsar; decorated_definition’yı bir fonksiyon sembolüne geri eşler; ve self / cls metot çağrılarını çevreleyen sınıfa geri niteler. Bu önemlidir çünkü bunlar, Python repolarının bir insana açık, bir LLM’e ise belirsiz gelmeye başladığı tam yerlerdir.
Ayrıca ilişki çıkarımından standart kütüphane gürültüsünün büyük bir kısmını filtreler. Bu, pathlib, typing veya logging gibi modüllerden gelen yaygın çalışma zamanı çağrılarının, gerçekten önemsediğiniz repoya özgü ilişkileri boğma olasılığının daha düşük olduğu anlamına gelir.
En basit yararlı iş akışı şudur:
intelligent_search ile başlayın.find_symbol’e geçin.dependency_search’ü kullanın.Bu desen, bir ajandan önceden bağlam edinmeden “faturalama akışını güncelle” istemekten daha iyidir. Ajanın önce bir harita çıkarmasına, sonra kodu değiştirmesine olanak tanır.
Bu sayfa, zaten belirli bir yaşa ve karmaşıklığa sahip Python repoları içindir: servis kodu, işler, betikler, üretilmiş türler ve çevredeki yapılandırma. Ana karşılaştırmanız çok dilli web monorepo’ları arasındaysa, TypeScript kılavuzunu da okuyun. Yalnızca tam destek matrisine ihtiyacınız varsa uyumluluk’u kullanın.
En uygun kullanım
Ajan iş akışları
Motor ayrıntıları
Yararlı MCP giriş noktaları
"fatura senkronizasyonu etrafındaki yeniden deneme mantığı" gibi kavramsal bir sorguyla başlayın ve repo çok dilliyse `language_filter="python"` ayarlayın.
Sınıf ya da fonksiyon adını bildiğinizde ve düzenlemeden önce tanım artı referanslara ihtiyacınız olduğunda kullanın.
Paylaşılan bir servis ya da yardımcı fonksiyonu yeniden düzenlemeden önce, ona neyin bağımlı olduğunu görmek için gelen yönü kullanın.
İlgili rehberler
Repo, Spring servisleriyle, iç çerçevelerle ve birkaç kurumsal dönemi atlatmış kodla doluysa yararlıdır.
Uzantılar
.java
Repo birden fazla paket genelinde uygulama kodunu, kütüphaneleri, API istemcilerini, testleri ve yapılandırmayı karıştırdığında ilgilidir.
Uzantılar
.cts, .d.ts, .mts, .spec.ts, +3 daha