İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

Asistanınızın Aggrega ile yapabilecekleri

Asistanınız Aggrega MCP sunucusuna bağlandığında, bir terminalde çalıştıracağınız aynı aggrega ikili dosyasıyla çalışır: şemaları ve belgeleri okur, dosyalarınızın taslağını hazırlar ve denetler, bir Release derler ve izin verdiğinizde yayımlar. Bu sayfa bunun neleri kapsadığını gruplar halinde anlatır. Tam liste sunucunun kendi yanıtıdır ve güvenilecek olan da odur: describe-capabilities aracını argümansız çağırın ya da asistanınızdan çağırmasını isteyin; sunucunun size sunduğu her aracı, her biri için tek satırlık amacı, hizmet ettiği varlık türlerini ve yazıp yazmadığını listeler. Uyumluluk, bir sürümün araçlarda neleri değiştirebileceğini belirtir.

Şemaları ve belgeleri okuma

Sunucu, bir asistanın YAML yazmadan önce okuduğu başvuru malzemesini sunar: bir varlığın JSON Schema’sı (schema://<kind>), herhangi bir dil başvurusu sayfası (langref://<path>), yazım kılavuzu (authoring://<topic>), bir katalog varlığının yazılmış YAML’ı (catalog://<kind>/<name>) ve herhangi bir komutun yardımı (cli://<command>). Şemalar ikili dosyaya gömülüdür; sayfalar ise sunucunun makinenizin önbelleğinde tuttuğu belge kopyasından gelir. Ne yapar her aileyi listeler.

Bir rol üstlenme ya da bir iş akışını izleme

Yazım istemleri asistanı bir geliştirici, bir mimar ya da bir operasyon yazarı olarak konumlandırır ya da onu tek bir varlık türüne odaklar; böylece önerileri o rolün yazdığı alanın içinde kalır. İş akışı istemleri, birkaç çağrı gerektiren bir hedef için çağrıların sırasını ortaya koyar: yeni bir Aggregate’i ve onun Release’ini oluşturmak, mevcut bir chart’ı, altyapı modülünü ya da Compose dosyasını Aggrega’ya getirmek veya bir derlemenin neden başarısız olduğunu bulmak. İstemciniz bunları sunucunun istemleri olarak listeler.

Bir çalışma alanının neler içerdiğini öğrenme

list-entities ve list-releases çalışma alanınızın ne içerdiğini ve ne kadarını içerdiğini söyler, ardından kayıtları sayfa sayfa teslim eder; describe bir varlığı ya da bir Release’in ulaştığı her şeyi gösterir; config-show geçerli yapılandırmayı ve her ayarın nereden geldiğini bildirir. Sunucu ayrıca önbellekleri, yapılandırılmış kayıt defterlerini ve çözümlediği eklentileri bildirir. Bkz. Bir çalışma alanının neler içerdiğini öğrenme.

Dosyalarınızın taslağını hazırlama ve denetleme

scaffold bir varlık türü için, türün gerektirdiği alanları taşıyan bir başlangıç belgesi taslağı hazırlar ya da belgelerin çalıştırılabilir örneklerinden birini yeni bir dizine yazar. get-schema bir türün JSON Schema’sını döndürür, validate bir taslağı denetler ve içinde hâlâ kalan her yer tutucuyu adlandırır, lint katalog yayımlama uzlaşımlarını denetler ve explain-error bir tanılamayı gerektirdiği düzeltmeye açar. Diğer araçlar düzenleme sırasında ortaya çıkan soruları yanıtlar: bir bileşene hangi Features’ın eklenebileceği ve onun neye bağlanabileceği, yeni bir girdinin dosyada nereye ait olduğu ve bir belgeye uygulanan, dokunmadığı her baytı olduğu gibi koruyan tek bir sınırlı düzenleme. Bkz. Neyin eklenebileceğini ve neyin neye bağlanabileceğini sorma ve Bir belgeye tek bir sınırlı düzenleme uygulama.

Bir Release’i çözümleme ve derleme

pull bir Release’in bağımlılıklarını önbelleğe çözümler ve kilit dosyasını yazar; build ise Release’i yapıtlarına işler: varsayılan olarak bellekte, asistan yazmasını istediğinde ise çalışma alanının kökündeki dist/ içine. Reddedilen bir derleme, neyin düzeltileceğini söyleyen tanılamaları geri verir. Bkz. Bir Release’in neye bağlı olduğunu çözümleme ve Bir Release’in zaten sabitlediği içeriğe karşı derleme.

Başka bir araçtan proje getirme

import, başka bir aracın ürettiği bir tanımı okur ve incelemeniz için çalışma alanına taslak Aggrega dosyaları yazar. Okuduğu biçimler için bkz. Yabancı bir tanımı taslak varlıklara dönüştürme ve aggrega import.

Yayımlama, imzalama ve geri çekme

Dört araç bir varlığı ya da bir yapıtı bir kayıt defterine koyar, orada yayımlananı imzalar ya da imzalı bir işaretleyiciyle geri çeker. Bunların değiştirdikleri, o kayıt defterinden çözümleme yapan herkese ulaşır ve hiçbiri, onu zaten almış birinden geri alınamaz; bu nedenle izin vermeden önce üzerinde düşünülmesi gereken araçlar bunlardır. Bkz. Yayımlama, imzalama ve geri çekme.

Herhangi bir komutu çalıştırma

Sunucuyu kendi makinenizde standart girdi ve çıktı üzerinden başlatan bir istemci için sunucu, yazabileceğiniz her komut için o komutun adını taşıyan bir araç da sunar: cli-build, aggrega build komutunu çalıştırır, cli-validate, aggrega validate komutunu çalıştırır ve bu böyle devam eder. HTTPS üzerinden erişilen bir sunucu bunların hiçbirini sunmaz.

Size sormadan neler yapabileceği

Standart girdi ve çıktı üzerinden bağlanan bir asistan, istemciniz reddedecek şekilde ayarlanmadıkça sunucunun sunduğu her aracı size sormadan çağırabilir. Araçlara adlarıyla izin verdiğiniz ve onları reddettiğiniz yer istemcinizdir. Bir asistanın önce size sormadan yapabilecekleri çalışma alanınızın ötesine uzanan işlemleri adlandırır; Sunucunun duyurduklarını daraltma ise istemcinizin tamamını almadığı durumlarda araç listesini kısaltır.