Agentbits

DokümantasyonBaşvuru

İzinler

Ajan başına izin matrisi, yetki şablonları, her iznin sağlayıcıya göre nasıl uygulandığı ve onaylar.

Her ajanın kendi izinleri vardır: dosya okuyup okuyamayacağı, dosya yazıp yazamayacağı, terminal ya da ağ kullanıp kullanamayacağı ve her görevden önce senin onayını bekleyip beklemeyeceği. Bu sayfa izinleri nereden ayarlayacağını, her birinin ne işe yaradığını ve her sağlayıcının bunları gerçekte ne kadar uyguladığını anlatır.

İzinleri nereden ayarlarsın

Aynı izinleri iki yerden düzenleyebilirsin. İkisi senkron kalır ve değişiklikler anında kaydedilir.

  • Ayarlar → İzin Matrisi: tüm ajanları ve izinlerini gösteren bir tablo; ek klasörler için Yollar sütunu ve bir Nasıl uygulanır? notu vardır. Ayarları Ctrl+, ile aç.
  • Organizasyon → Ajanlar → bir ajan → İzinler: tek bir ajan için aynı anahtarlar, ayrıca Ek izinli klasörler.

İzinler

İzin Neye izin verir
Dosya okuma Çalışma alanındaki (proje klasöründeki) dosyaları okuma ve arama.
Dosya yazma Dosya oluşturma ve düzenleme.
Terminal Kabukta senin kullanıcı yetkilerinle komut çalıştırma.
Ağ İnternetten sayfa çekme ve arama yapma.
Tarayıcı Henüz uygulanmıyor: ajanlar uygulama içi tarayıcıyı kullanamaz.
Onay iste Her göreve başlamadan önce senin onayını bekleme.
Ek izinli klasörler Ajanın proje klasörüne ek olarak erişebileceği klasörler.

Ajanlar her zaman görevin ait olduğu projenin klasöründe başlar. CLI sağlayıcısıyla (Claude Code ya da Codex) çalışan ajanlar bir proje klasörüne ihtiyaç duyar; klasör yoksa çalışmaz. Bkz. Projeler.

Yetki şablonları

Bir ajan oluştururken bir Yetki şablonu seçersin. İzinleri sonradan tek tek değiştirebilirsin.

Şablon Açıklama
Salt okuma İnceler, raporlar; dosyalara dokunmaz.
Geliştirici Dosya okur ve yazar; terminal ve ağ kapalı.
Tam yetki Dosya, terminal, ağ ve tarayıcı açık.

Bir takım şablonundan kurulan ajanlar Onay iste açık başlar (görev almayan Çekirdek Ekip lideri hariç); bu yüzden ilk çalışmalarında sol panelde onay kartları bekle. Bkz. Organizasyon.

Her sağlayıcı izinleri nasıl uygular

Ajanlar izinlerini kendi talimatlarında görür, ama izinleri uygulayan bu değildir. Asıl zorlama, Agentbits’in sağlayıcıyı nasıl başlattığından gelir.

İzin Claude Code CLI Codex CLI Anthropic / OpenAI API
Dosya okuma Dosya okuma ve arama araçları açılır, çalışma klasörleriyle sınırlıdır. Codex her zaman okur; bu izin yoksa Codex ajanı hiç çalışmaz. Dosya sistemi erişimi yok.
Dosya yazma Düzenleme araçları açılır. Düzenlemeler yalnızca proje klasöründe ve ek klasörlerde otomatik onaylanır; dışarısı reddedilir. Codex’in workspace-write sandbox’ında çalışır: yalnızca proje klasörüne yazar. İzin yoksa sandbox salt-okunurdur. Dosya sistemi erişimi yok.
Terminal Kabuk aracı açılır. Açıkken dosya ve ağ kısıtları kabuk üzerinden aşılabilir. Codex komutları her zaman kendi sandbox’ında çalıştırır. Terminal yok.
Ağ Web’den sayfa çekme ve web araması açılır. Sandbox içinde ağ erişimi (Dosya yazma da açıksa). Kısıtsız “tam erişim” modu hiçbir zaman kullanılmaz. Web erişimi yok.
Ek izinli klasörler Ek çalışma klasörü olarak eklenir. Desteklenmez. Geçerli değil.
Tarayıcı Uygulanmaz. Uygulanmaz. Uygulanmaz.
Onay iste Uygulanır. Uygulanır. Uygulanır.

Bunlara ek olarak:

  • Claude Code, deponun kendi .claude ayarları ve hook’ları olmadan çalışır ve projenin .mcp.json dosyasını yok sayar; böylece bir depo ajanın izinlerini değiştiremez ya da kendi sunucularını ekleyemez. İzinlerin reddettiği araç çağrıları ajanın terminalinde uyarı olarak görünür.
  • Anthropic ve OpenAI API ajanları hiç dosya düzenleyemez ve komut çalıştıramaz. Metinle ve Agentbits’in kendi araçlarıyla (bağlantılar, dosya ekleri, skill’ler, uygulamalar) çalışırlar; bunların her biri kendi izniyle denetlenir. Proje klasöründe kod değiştirmek için bir CLI sağlayıcısı kullan. Bkz. Sağlayıcılar.
  • Demo işi canlandırır, dosyalarına dokunmaz.
  • Sohbet yanıtları ve lider incelemeleri hiçbir zaman dosya düzenleme ya da terminal aracı almaz.
  • Dosya, terminal ve ağ değişiklikleri ajanın bir sonraki çalışmasından itibaren geçerlidir. Bağlantı ve uygulama değişiklikleri bir sonraki araç çağrısından itibaren geçerlidir.

Uyarı: Claude Code’da Terminal izni olan bir ajan, senin kullanıcı hesabının yapabildiği her şeyi yapabilir. İşletim sistemi düzeyinde bir yalıtım yoktur. Bu izni yalnızca güvendiğin ajanlara ver ya da Agentbits’i kısıtlı bir işletim sistemi kullanıcısıyla çalıştır. Terminal ve Ağ birlikte açıksa ajan, bilgisayarında kayıtlı kimlik bilgileriyle sunuculara doğrudan da ulaşabilir.

Onay iste

Onay iste açıkken ajanın aldığı her görev, sol paneldeki Çalışan işler altında, istediği yetkileri gösteren bir onay kartıyla bekler. Çalışmayı başlatmak için onayla ya da reddet. Bu her sağlayıcıda çalışır; API sağlayıcılarında sen onaylamadan modele istek gönderilmez.

Bu, tek tek işlemlerin tetikleyebildiği onaylardan ayrıdır:

  • Production bağlantılarda yazma ve admin işlemleri (Bağlantılar),
  • Önce bana sor politikalı uygulama araçları (Uygulamalar).

Diğer erişimler

İzin matrisi dosyaları, terminali ve ağı kapsar. Diğer erişimler ayrı verilir ve hepsi varsayılan olarak kapalıdır:

Ne Nereden verilir
Sunucular ve veritabanları Ayarlar → İzin Matrisi → Bağlantı izinleri ya da bağlantının Ajan erişimi sekmesi. Bkz. Bağlantılar.
Uygulamalar (MCP) Uygulamanın Erişim sekmesi ya da ajanın Uygulamalar bölümü. Bkz. Uygulamalar.
Skill’ler Ajana ya da birimlerinden birine atama. Bkz. Skill’ler.
Dosya ekleri Dosyayı eklerken paylaşım ya da dosyanın Erişim sekmesi. Bkz. Dosyalar.

Genel model ve sınırları için bkz. Güvenlik.

Yanlış ya da eksik bir şey mi buldun? GitHub'da bildir