İlk çalıştırma

bee makinenizde tam olarak tek bir şey tutar: yapılandırma deposuna nasıl ulaşılacağı. Geri kalan her şey — sağlayıcı anahtarları, uç noktalar, kurallar, hafızalar — MongoDB’de yaşar ve aynı depoyu gösteren her makine ve her ajan tarafından paylaşılır.

1 · bee’yi bir depoya bağlayın

bee init

Sihirbaz tek bir Mongo bağlantı dizesi ister, canlı test eder, ve ancak ondan sonra ~/.bee/config.json dosyasını 0600 izinleriyle yazar. Cevap vermeyen bir bağlantı asla kaydedilmez.

Betiklenebilir, etkileşimsiz:

bee init --mongo "mongodb://localhost:27017" --database bee --collection config

Herhangi bir MongoDB yeterli

Denemek için yerel bir konteyner yeter:

docker run -d --name bee-mongo -p 27017:27017 mongo:8
bee init --mongo "mongodb://localhost:27017" --database bee --collection config

Host’tan bir replica set’e bağlanmak

Bir replica set üyesi kendini bildiği adla ilan eder — çoğu zaman makinenizin çözemediği bir konteyner adıyla. Sürücü o adı çözmeye çalışır ve keşifte takılır. Bunun yerine doğrudan bağlanın:

bee init --mongo "mongodb://localhost:27018/?directConnection=true" \
         --database bee --collection config

Ayrı bir depo tutmak

BEE_HOME bee için ev dizininizin yerine geçer, ve bee üstüne yine .bee ekler. Bir dizini gösterdiğinizde <o dizin>/.bee/config.json elde edersiniz:

export BEE_HOME=/proje/yolu
bee init --mongo "mongodb://localhost:27017" --database bee_test --collection config
# → /proje/yolu/.bee/config.json

Gerçek işinizin kullandığı depoya dokunmaması gereken, atılabilir bir test deposu için kullanışlı.

2 · Ona bir beyin verin (isteğe bağlı)

Yalnızca bee ask için gerekli. Hafıza, kurallar ve lint bunsuz da çalışır.

bee config set ask.provider deepseek
bee config set deepseek.apiKey sk-... --secret
bee config show          # sırlar maskeli

DeepSeek, OpenAI ve Anthropic destekleniyor.

3 · İlk hafızayı yazın

bee remember "Redis oturum jetonlarını önbelleğe alır, kullanıcı verisini değil" \
  --type decision --reason "kullanıcı verisinin TTL'i farklı"

bee remember search "redis"

4 · Ajanınıza bağlayın

bee hook install --harness claude --scope project

Her çalışma ortamının neyi desteklediği ve neyi desteklemediği için Hook’lar sayfasına bakın.

Ne nerede yaşar

ne	nerede
Mongo önyükleme bağlantısı	~/.bee/config.json (0600) — tek yerel dosya
Gömme (embedding) modeli	~/.bee/models/ — ilk anlamsal aramada indirilir
Geri kalan her şey	sizin MongoDB yapılandırma deponuz