Bob Shell'in her konuşmada yüklediği kalıcı bir bağlam dosyası olan AGENTS.md'yi oluşturmak için /init komutunu çalıştır ve bu bağlamı nasıl güncel tutacağını öğren.

/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, her etkileşimin başında her dosyayı yeniden okumadan Bob'a bir projenin yapısı, kuralları ve kod tabanı hakkında bilgi verme yöntemidir.

Büyük dil modelleri durumsuz (stateless) çalışır. Her yeni konuşma, önceki etkileşimlerin hiçbir anısı olmadan başlar. Açık proje bağlamı olmadan Bob, her yeni etkileşimde kod tabanını yeniden keşfetmek zorundadır; bu verimsizdir ve büyük ölçekte pratik olmaz.

Bu eğitimde, Bob Shell'i demo uygulamanın kök dizininde başlatacak, Bob'un uygulama hakkında edindiği bağlamı keşfedecek ve Bob Shell'in AGENTS.md dosyalarını nasıl yüklediğini öğreneceksin.

Ön koşullar

Bu eğitimi tamamlamak için aşağıdakilere ihtiyacın var:

Bob Shell

Bob Shell v2.x veya üzerini kur ve oturum aç.

Git

Örnek repoyu klonlamak için Git kur.

Henüz sahip değilsen, Galaxium Travels demo kodunu klonla. Klonlama komutu, eğitimlerde kullandığın kodu içeren bob-learning-path-branch dalını da getirir.

git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels

Zorunlu olmamakla birlikte, Bob Shell'in arayüzüne ve özelliklerine alışmak için Etkileşimli oturum başlatma bölümünü okumanı öneririz.

Projeye Bob Shell'i başlat

Galaxium Travels kök dizinine geç:

cd galaxium-travels

Etkileşimli bir oturum başlat:

bob chat --mode agent

--mode agent bayrağı, oturumu Bob'un dosyaları okumak ve AGENTS.md yazmak için ihtiyaç duyduğu araçlara sahip Agent modunda başlatır.

Bob Shell klasöre güvenip güvenmediğini sorarsa, Bob'un projede çalışabilmesi için güven ver. Daha fazla bilgi için bkz. Güvenilen klasörler.

/init ile AGENTS.md oluşturma

İstemde /init komutunu gir:

/init

Bob, projedeki ilgili dosyaları okur.

Bob, dosyaları okumak veya AGENTS.md yazmak gibi bir araç kullanmak istediğinde onay iletişim kutusu belirir. Her istek için Approve'ı seç.

Bob, Galaxium Travels kök dizininde ana AGENTS.md dosyasını oluşturur. Ayrıca .bob/rules-agent/AGENTS.md, .bob/rules-ask/AGENTS.md ve .bob/rules-plan/AGENTS.md konumlarında moda özgü bağlam dosyaları da oluşturur.

AGENTS.md dosyalarını keşfet

AGENTS.md dosyası Bob için bir oryantasyon belgesidir. Bob'un projenin yapısını ve kurallarını anlaması için ihtiyaç duyduğu her şeyi sağlayan özlü ve uygulanabilir bir özettir.

Bob'dan dosyayı göstermesini iste:

Show me the contents of @AGENTS.md

@ sembolü projenizdeki bir dosyayı referans alır, böylece Bob yanıt vermeden önce onu okur. Ayrıca başka bir terminal açarak dosyayı doğrudan görüntüleyebilirsin:

cat AGENTS.md

AGENTS.md dosyası genellikle aşağıdaki bileşenleri içerir:

Projeye 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ı

/init komutunun oluşturduğu tüm dosyaları görmek için Galaxium Travels dizininde git status çalıştır:

git status

Bob Shell'in AGENTS.md dosyalarını yüklemesi

Bob Shell, her görevin başında AGENTS.md gibi bağlam dosyalarını otomatik olarak yükler.

Global bağlam: ~/.bob/AGENTS.md tüm projeler için geçerlidir.

Proje bağlamı: Proje kökündeki ve üst dizinlerdeki AGENTS.md proje için geçerlidir.

Yerel bağlam: Alt dizinlerdeki AGENTS.md, bileşene özgü talimatlar için o alt dizine uygulanır.

Bob'a tek bir mod için talimat vermek için .bob/rules-plan/ gibi .bob/rules-<mod>/ dizinlerine moda özgü kurallar ekle.

AGENTS.md dosyalarını güncel tut

Aşağıdaki değişikliklerden sonra /init komutunu yeniden çalıştır:

Yeni modüller veya servisler ekleme

Dizin yapısını değiştirme

Yeni teknoloji veya framework benimseme

Bob kullanan yeni ekip üyelerini dahil etme

AGENTS.md dosyasını, Bob'un otomatik taramasının yakalayamayabileceği bağlamları (iş kuralları, dağıtım kuralları veya ekibe özgü uygulamalar gibi) eklemek için manuel olarak da düzenleyebilirsin. Ekibinin aynı bağlamı paylaşması için AGENTS.md dosyasını versiyon kontrolüne işle.

Sonraki adımlar

Bu eğitimde şunları öğrendin:

Büyük dil modelleri durumsuz çalışır. /init komutunu çalıştırmak, Bob'un her konuşmanın başında okuduğu kalıcı bir bağlam dosyası olan AGENTS.md'yi oluşturarak bu sorunu çözer.

Bağlamı güncel tutmak için büyük proje değişikliklerinden sonra /init komutunu yeniden çalıştır.

İstediğin çıktıyı güvenilir biçimde üretecek prompt'lar yazmayı öğrenmek için Bob Shell için etkili prompt'lar yazma bölümüne geç.

Bob Shell'de /init ve AGENTS.md ile Proje Başlatma