Asistan, genel bir chatbot değildir. Google Antigravity ve Claude Code aracı çerçeveleri (v4.0.0) üzerine kurulu, yapay zeka destekli reklam mühendisliği için özel bir görev kontrol sistemidir.
Genel görünüm: Yüksek uyumlulukla ilgili sorunları çözme
Bu Asistan'ın çözdüğü temel sorunlar, bilişsel aşırı yüklenme ve teknik zorluklardır.
Google Ads API, mevcut en güçlü ancak aynı zamanda en karmaşık API'lerden biridir. Bu API'de katı sürüm oluşturma, benzersiz bir sorgu dili (GAQL), derinlemesine iç içe yerleştirilmiş protokol arabellek yapıları ve sıkı güvenlik şartları bulunur. Geliştiriciler genellikle zamanlarının önemli bir bölümünü gerçek iş mantığı oluşturmak yerine gRPC hatalarını ayıklayarak, alan uyumluluğunu arayarak ve linter sorunlarını düzelterek API ile mücadele etmekle geçirir.
Asistan, 4.0.0 sürümünde bu sorunu, özel, test destekli beceriler tarafından desteklenen ve yerleşik eğik çizgi komutları içeren bir modüler eklenti mimarisi sunarak çözüyor. Otomatik bir uzman ara yazılımı olarak işlev görür. Sürüm doğrulama, şema keşfi ve kod linting gibi zahmetli görevleri yöneterek geliştiricinin söz dizimi yerine amaç düzeyinde çalışmasına olanak tanır.
Tahminlere değil, resmi şemalara dayanır.
Standart büyük dil modelleri, tamamen genel eğitim verilerine dayandıkları için alan adlarına özgü API'lerle genellikle zorlanır. Bu veriler, yeni API sürümleri yayınlandıkça hızla güncelliğini yitirir.
Google Ads API Geliştirici Asistanı, yerleştirilmiş Google Ads API mimari kurallarını dinamik ve yerel Protobuf şema incelemesiyle birleştirerek bu sorunu çözer:
- Deterministik doğrulama: Asistan, birden fazla gidiş dönüşte yinelemeli LLM tahminine güvenmek yerine, tek bir adımda alan uyumluluğunu, kaynak ilişkilerini, sıfır gösterim kurallarını ve tarih segmentasyonunu doğrulayan yerel 4 adımlı bir doğrulama ardışık düzeni çalıştırır.
- Sürüme göre doğru şema aramaları: Protobuf kaynak tanımlarını, veri türlerini ve enum değerlerini doğrudan etkin API sürümünün resmi API şemalarından inceleyerek tekrarlayan uzak meta veri sorgularını önler.
- Resmi istemci kitaplığı temeli: Kod oluşturma, Python, Java, PHP, .NET ve Ruby'deki resmi Google Ads istemci kitaplıklarına doğrudan dayanır.
Benzerlik: Alan odaklı araştırma ve teşhis laboratuvarı
Asistanı, bir cerrah için yüksek teknolojili bir araştırma laboratuvarı olarak düşünebilirsiniz.
- Cerrah (geliştirici): Hangi işlemin yapılması gerektiğini tam olarak biliyorsunuz (örneğin, "Maksimum Performans kampanyasının performansını analiz etmem gerekiyor").
- Laboratuvar ekipmanları (API): Bunlar, ameliyatı yapmak için gereken güçlü araçlardır ancak karmaşıktır ve tam kalibrasyon gerektirir.
- Laboratuvar asistanı (bu araç): Laboratuvar asistanı, hastaya dokunmadan önce özel beceriler ve yerleşik komutlar kullanarak:
- Kılavuzları inceleyin: En yeni API protokollerini otomatik olarak doğrular ve kaynak yapılarını anında inceler (
inspect_object//inspect-object). - Araçları önceden test edin: Hataları oluşmadan önce yakalamak için canlı API doğrulama (
validate_gaql//validate-gaql) kullanarak sorgularınızda deterministik provalar yürütür. - Ortamı sterilize edin: Kodunuzu, sistem hatalarına neden olmaması için katı linter işlem hatlarını (
rufflinting) kullanarak biçimlendirir ve temizler. - Hayati bulguları izleme: API istisnalarını izler ve çevrimdışı dönüşümler gibi karmaşık işlemler için gelişmiş teşhis iş akışları çalıştırır (
troubleshoot_conversions//troubleshoot-conversions). - Kavramları açıklama: Karmaşık kavramları günlük dilde ve gerçek hayattaki benzetmelerle (
/explain,/step-by-step,/assistant-tutorial) açıklar.
- Kılavuzları inceleyin: En yeni API protokollerini otomatik olarak doğrular ve kaynak yapılarını anında inceler (
Birbirine bağlılık: "Önce güvenlik" köprüsü
Asistan, projenizdeki dört farklı "dünyayı" birbirine bağlayan bir köprü görevi görür. Bu dört dünya, kontrol sözleşmeleri (AGENTS.md / CLAUDE.md) tarafından yönetilir:
- Kullanıcı bağlamı: Üst düzey hedeflerinizi dinler ve bunları teknik bir stratejiye dönüştürür.
- Yerel çalışma alanı: Proje dizininizde "gözler ve eller" bulunur. Mevcut kodu okuyabilir ve daha sonra kullanmak üzere yeni kod yazabilir. Bunu yaparken sıkı bir izolasyon sağlar.
- Google Ads API: Yalnızca okunabilen raporlar oluşturmak ve hesabınızda test sorguları çalıştırmak için canlı API'ye bağlanır. Anında alan doğrulaması için yerel Protobuf şemalarını doğrudan inceler.
- Güvenlik görevlileri: Katı protokollere uymak üzere tasarlanmıştır. Lint işlemi yapılmamış bir komut dosyasını çalıştırmanıza ve programatik doğrulama kontrolünden geçmemiş bir sorguyu göndermenize izin vermez.
Asistan'ın gerçekte yaptığı işlemler
Basit bir ifadeyle, asistan sizin koruyucunuz ve hızlandırıcınızdır.
- Hataları önler: Kodu ve sorguları yürütülmeden önce etkin API şemalarına göre doğrular. Böylece, söz dizimi ve uyumluluk hataları canlı API'ye ulaşmadan durdurulur.
- Haritayı bilir: Google Ads API'nin coğrafyasını, verilerin nerede bulunduğunu ve nasıl verimli bir şekilde sorgulanacağını anlar.
- Sıkıcı işleri otomatikleştirir: Standart istemci kitaplığı kodu yazar, raporları temiz terminal tabloları halinde biçimlendirir ve istemci kitaplığı tesisatını yönetir.
- Karmaşık iş akışlarında sorun giderme: Çevrimdışı dönüşüm yüklemeleriyle ilgili ayrıntılı teşhisler yapar, MM hesabı hiyerarşilerini çözer ve Maksimum Performans listeleme filtreleri ile URL hariç tutmaları gibi karmaşık kampanya yapılarını yapılandırır.
- Canlı ve anlık raporlar yayınlar: Performans verilerini basit İngilizce olarak isteyin. Asistan, GAQL sorgularını doğrudan hesabınızda oluşturur, doğrular ve çalıştırır. Biçimlendirilmiş sonuçları terminalinize aktarır veya CSV olarak dışa aktarır.
- Güncel kalır: Etkin API sürümünün yerel Protobuf şemalarını ve belgelerini inceleyerek kullanımdan kaldırılmış alanlardan ve güncel olmayan kurallardan kaçınmanıza yardımcı olur.
Google Ads API Geliştirici Asistanı, "geliştirici ve API" arasındaki mücadeleyi güvenli, deyimsel ve mimari açıdan sağlam kod üreten bir "geliştirici + yapay zeka" iş birliğine dönüştürür.
Mimari ve performans (4.0.0 sürümü)
4.0.0 sürümü, asistanı bağımsız bir proje kurulumundan modern ve global bir eklenti mimarisine geçirir:
- Daemon ek yükü yok: Beceriler ve teşhis komutları yalnızca çağrıldığında kısa süreli olarak hafif alt işlemler şeklinde çalışır ve boşta kaldığında sistem kaynağı kullanımı sıfıra düşer.
- Aşamalı bağlam açıklaması: Kurallar ve şemalar yalnızca etkin görevinizle alakalı olduğunda isteğe bağlı olarak yüklenir. Bu sayede, jeton tüketimi ve istem gecikmesi önemli ölçüde azalır.
- Daha az disk G/Ç: Eklenti ağacından gereksiz SDK dosyalarının kaldırılması, IDE indeksleyicilerinin, linter'ların ve dosya izleyicilerin on binlerce kullanılmayan dosyayı taramasını engeller.
- Çok platformlu ana makine desteği: Linux, macOS ve Windows'da birleşik yükleme komut dosyalarıyla Google Antigravity ve Claude Code ortamlarında sorunsuz çalışır.
Sonraki adımlar
- Google Ads API Geliştirici Asistanı'nı yükleme ve yapılandırma
- Google Ads API aracı becerileri hakkında bilgi edinin.
- Google Ads API MCP sunucusu hakkında bilgi edinin