Yazma kılavuzu
Bu kılavuz, mimari bölümlerinin ve dil başvurusunun uygulamalı tamamlayıcısıdır. Mimari, Aggrega’nın neden bu şekilde biçimlendiğini açıklarken ve başvuru her alanın ne anlama geldiğini belirtirken, bu kılavuz oturup nasıl yazılacağını öğretir: hangi varlığa, hangi sırayla başvuracağınızı ve CLI ile bir yapay zekâ asistanının en az zahmetle doğru bir dosya elde etmenize nasıl yardımcı olduğunu.
Kılavuz aynı anda iki okur kitlesi için yazılmıştır: bir düzenleyicide elle yazan bir kişi ve Model Context Protocol sunucusu aracılığıyla bir kişi adına yazan bir yapay zekâ asistanı. Her ikisi de aynı döngüyü izler ve aynı başvuru yüzeylerini okur; bu nedenle aşağıdaki sayfalar ikisine de hizmet eder.
Bu sırayla okuyun
- Aggrega dosyalarını yazma — uçtan uca yazma döngüsü: rolünüzü seçin, yapıyı öğrenin, iskeleyi oluşturun, doldurun, doğrulayın, derleyin. Buradan başlayın.
- Personalar — birlikte çalışan dört yazma rolü (geliştirici, mimar, operasyon, operatör) ve bunların ardındaki zorlama değil yönlendirme yaklaşımı.
- Role göre varlıklar — her varlık türü, genellikle ona sahip olan role eşlenmiştir; böylece her konunun hangi dosyaya ait olduğunu bilirsiniz.
- Kurulum —
aggregaikili dosyasını kurun; komutlar en başta yer alır ve bağlantı bölümü MCP sunucusunu bağlama sayfasına yönlendirir. - Aggrega’yı Visual Studio Code’da kullanın — Visual Studio Code için Aggrega uzantısı: neye ihtiyaç duyduğu, karşılama sayfası, panelleri ve topoloji grafiği, ayrıca tüm ayarlar ve komutlar.
İçe aktarma, elinizde başka bir biçimde zaten bulunan bir projeden yola çıkar ve gözden geçirip derlemeniz için bu dosyaların taslaklarını ondan hazırlar.
Aggrega’yı öğrenin, bu kılavuzu belgelerin tamamından geçen bir yolun içine yerleştirir.
Bir yapay zekâ asistanıyla çalışma
- Aggrega’yı yapay zekâ asistanınızla kurma — komut çalıştırabilen bir asistana yapıştırılacak tek bir istem; böylece asistan Aggrega’yı kurar, Aggrega becerisini ekler ve kendisini sunucuya bağlar.
- MCP sunucusunu bağlama — istemci istemci sunucu girdisi, her istemcinin onu nerede tuttuğu, HTTPS üzerinden erişilen bir sunucu ve bağlantının nasıl denetleneceği.
- Aggrega becerisi — bir asistanın Aggrega için yüklediği talimatlar: bunların kurulması ve güncel tutulması.
- Asistanınızın Aggrega ile yapabilecekleri — bağlı sunucunun bir asistanın neleri okumasına, denetlemesine, derlemesine ve yayımlamasına izin verdiği.
Asistan yüzeylerinin bu kılavuzla ilişkisi
aggrega mcp sunucusu bu kılavuzu, dil başvurusunu ve JSON Schema’ları, bir asistanın YAML yazmadan önce okuduğu kaynaklar olarak sunar; ayrıca varlıkların iskelesini oluşturan ve onları doğrulayan araçlar da sağlar. Asistanın yerleşik yazma istemleri bu sayfaları yeniden anlatmak yerine onlara geri işaret eder; böylece bu kılavuz, yazma yönteminin tek metin kaynağıdır. Döngü için Aggrega dosyalarını yazma, bağlantı için MCP sunucusunu bağlama sayfasına bakın.