Yapılandırma

Yapılandırma

Bob Shell'i iş akışı tercihlerinle eşleşecek şekilde yapılandırabilirsin.

Ayar dosyası konumları

Bob Shell ayarları iki konumda saklar:

KapsamDosya
Kullanıcı (tüm çalışma alanları)~/.bob/settings/settings.json
Proje (mevcut çalışma alanı)<workspace>/.bob/

CLI bayrakları, mevcut oturum için dosya değerlerini her zaman geçersiz kılar. Ayrıca bob chat içindeki /settings slash command'ı aracılığıyla ayarları etkileşimli olarak da değiştirebilirsin.

Ayarlar şeması

{
  "session": {
    "maxTurns": 50,
    "defaultMode": "agent",
    "mcp": true,
    "subagents": true
  },
  "logging": {
    "logLevel": "warn"
  },
  "tasks": {
    "retentionDays": 30
  },
  "telemetry": {
    "enabled": true
  }
}
AyarTürVarsayılanAçıklama
session.maxTurnsnumber50Oturum başına maksimum ajan turu (0 = sınırsız)
session.defaultModestring"agent"Oturum başlatırken varsayılan mod
session.mcpbooleantrueModel Context Protocol (MCP) sunucularını varsayılan olarak etkinleştir
session.subagentsbooleantrueAlt ajan oluşturmayı varsayılan olarak etkinleştir
logging.logLevelstring"warn"Log ayrıntı düzeyi (error, warn, info, debug, trace)
tasks.retentionDaysnumber30Görev geçmişinin saklanacağı gün sayısı. Otomatik temizlemeyi devre dışı bırakmak ve tüm görev geçmişini süresiz saklamak için 0 olarak ayarla.
telemetry.enabledbooleantrueKullanım telemetrisinin gönderilip gönderilmeyeceği. Devre dışı bırakmak kullanım verilerinin toplanmasını engeller.
Warning:

tasks.retentionDays değerini 0 olarak yalnızca Bob Shell 2.0.1 veya sonraki sürümlerde ayarla. Bu değeri önceki sürümlerde 0 olarak ayarlamak, sabitlenmemiş görevleri ve geçmişlerini silebilir.

| telemetry.excludePayload | boolean | — | IBM kullanıcıları: telemetriden konuşma yükünü hariç tut. Yalnızca onaylı hassas projeler için etkinleştir. |

Kimlik doğrulama token'ları (OAuth), ~/.bob/settings/auth-secrets.json dosyasında ayrı olarak saklanır.

Log dosyaları

Loglar, dönen dosyalar (bob-<timestamp>.log) kullanılarak ~/.bob/logs/shell/ dizinine yazılır. En fazla 10 log dosyası saklanır; eski dosyalar otomatik olarak temizlenir. Döndürme öncesi maksimum log dosyası boyutu 5 MB'tır.

Ayrıntılı çıktı yakalamak için --log-level debug (veya BOB_LOG_LEVEL=debug) kullan:

BOB_LOG_LEVEL=debug bob chat
bob run --log-level debug "Explain @app.js"

Ayrıca /logs slash command'ını kullanarak bir oturum içinden doğrudan en son log dosyasını açabilirsin.

Bağlam dosyaları

AGENTS.md gibi bağlam dosyaları, yapay zeka modeline talimat sağlar. Bu dosyalar hiyerarşik olarak yüklenir:

  1. Global bağlam: ~/.bob/AGENTS.md (tüm projelere uygulanır)
  2. Proje bağlamı: Proje kökündeki ve üst dizinlerdeki AGENTS.md
  3. Yerel bağlam: Alt dizinlerdeki AGENTS.md (bileşene özgü talimatlar için)

Örnek bağlam dosyası

# Project: My TypeScript Library

## General instructions

- Follow existing coding style
- Add JSDoc comments to all functions
- Prefer functional programming patterns
- Target TypeScript 5.0 and Node.js 20+

## Coding style

- Use 2 spaces for indentation
- Interface names should be prefixed with `I`
- Private class members should be prefixed with `_`
- Use strict equality (`===` and `!==`)

Kullanım istatistikleri

Bob Shell, ürünü iyileştirmek için anonim kullanım istatistikleri toplar. Bu şunları içerir:

  • Araç kullanım desenleri (adlar, başarı/başarısızlık, süre)
  • API istek metrikleri (model, süre, başarı)
  • Oturum yapılandırma bilgileri

Kişisel bilgi, prompt içeriği veya dosya içeriği toplanmaz.

Devre dışı bırakmak için ayar dosyanda telemetry.enabled değerini false olarak ayarla:

{
  "telemetry": {
    "enabled": false
  }
}
Bu konu nasıl?