/init ve AGENTS.md ile bir proje başlatın
/init ile Bob'a konuşmalar ve modlar arasında kalıcı proje bağlamı verin, bu otomatik olarak AGENTS.md dosyaları oluşturur.
/init komutu bir projeyi tarar ve Bob'un her konuşmada kalıcı bağlam olarak kullandığı AGENTS.md adlı yapılandırılmış bir özet dosyası oluşturur. /init komutu, Bob'un her etkileşimin başında her dosyayı yeniden okumasını gerektirmeden, Bob'a bir projenin yapısı, kuralları ve kod tabanı hakkında bilgi verme yönteminizdir.
Büyük dil modelleri durumsuz (stateless) olur. Her yeni konuşma, önceki etkileşimlerin hafızası olmadan başlar. Açık proje bağlamı olmadan, Bob her yeni etkileşimde kod tabanını keşfetmek zorundadır, bu da verimsizdir ve ölçekte pratik olmaz.
Bu eğitimde, Bob'u bir demo uygulamasının kök dizininde başlatırsınız, Bob'un uygulama hakkında edindiği bağlamı keşfedersiniz ve moda özgü bağlam için Bob'un yapısını öğrenirsiniz.
Ön Koşullar
Bu eğitimi tamamlamak için aşağıdakilere ihtiyacınız vardır:
- Henüz yoksa, Galaxium Travels demo kodunu klonlayın. Klonlama komutu ayrıca eğitimlerde kullandığınız kodu içeren
bob-learning-path-branchdalını da kontrol eder.
git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels- Galaxium Travels demo kodu açık olan Bob IDE
- Zorunlu olmasa da, Bob'un arayüzü ve özellikleri hakkında bilgi edinmek için Hızlı başlangıç eğitimi yapmayı düşünün.
/init'i çalıştırın
Proje bağlamını başlatmak için Bob IDE'deki Merhaba, ben Bob'um sohbet arayüzüne gidin. Kenar çubuğunun altındaki Agent moduna geçin.
Sohbet arayüzüne /init komutunu girin. Otomatik onayı devre dışı bıraktıysanız, Bob dosyaları okumak ve AGENTS.md dosyalarını yazmak için izninizi ister.
/init
Bob projedeki ilgili dosyaları okur. Bob daha sonra Galaxium Travels kök dizininde ana AGENTS.md dosyasını oluşturur. Bob ayrıca her mod için bir AGENTS.md içeren bir .bob klasörü oluşturur.
AGENTS.md dosyalarını keşfedin
AGENTS.md dosyaları Bob için işe alım belgeleri gibi işlev görür. AGENTS.md, Bob'un projenin yapısını ve kurallarını anlaması için ihtiyaç duyduğu her şeyi sağlayan özlü, eyleme geçirilebilir bir özettir.
Ana AGENTS.md dosyasını sol taraftaki Bob dosya gezgininin alt kısmında bulabilirsiniz. İçeriğini okumak için dosyayı açın.
AGENTS.md dosyası genellikle aşağıdaki bileşenleri içerir:
- Proje genel bakışı ve amacı
- Dizin yapısı ve anahtar dosya konumları
- Teknoloji yığını ve bağımlılıklar
- Mimari desenler ve kurallar
- Geliştirme iş akışları
Bob, AGENTS.md'yi yeni konuşmalara otomatik olarak uygular ve proje bağlamını öğrenir.
Moda özgü AGENTS.md dosyaları
Galaxium Travels kök dizinindeki ana AGENTS.md'ye ek olarak, /init her yerleşik mod için .bob klasöründe moda özgü bağlam dosyaları oluşturur. Her moda özgü AGENTS.md, ana AGENTS.md'yi o modun amacıyla ilgili bağlamla genişletir. Aşağıdaki tabloda moda özgü AGENTS.md dosyaları listelenmiştir:
| Dosya | Mod |
|---|---|
.bob/rules-code/AGENTS-code.md | Agent modu |
.bob/rules-plan/AGENTS-plan.md | Plan modu |
.bob/rules-ask/AGENTS-ask.md | Ask modu |
Plan modu bağlamı mimari kuralları vurgularken, Code modu bağlamı dosya yapısını ve adlandırma desenlerini vurgular.
AGENTS.md dosyalarını koruyun
Aşağıdaki proje ayarlamalarını yaptıktan sonra /init'i yeniden çalıştırın:
- Yeni modüller veya hizmetler ekleme
- Dizin yapısını değiştirme
- Yeni teknolojiler veya çerçeveler benimseme
- Bob'u kullanacak yeni ekip üyelerini işe alma
Ayrıca, Bob'un otomatik taramasının yakalayamayabileceği bağlamı (iş kuralları, dağıtım kuralları veya ekibe özgü uygulamalar gibi) eklemek için AGENTS.md'yi manuel olarak düzenleyebilirsiniz.
Sonraki adımlar
Bu eğitimde aşağıdakileri öğrendiniz:
- Büyük dil modelleri durumsuz (stateless) olur.
/initkomutunu çalıştırmak, Bob'un her konuşmanın başında okuduğu kalıcı bir bağlam dosyası olanAGENTS.md'yi oluşturarak bu sorunu çözer. - Moda özgü
AGENTS.mddosyaları, Agent, Plan ve Ask modları için hedeflenmiş bağlam sağlar. - Bağlamı güncel tutmak için büyük proje değişikliklerinden sonra
/init'i yeniden çalıştırın.