Dosyalar

Ajanlara üzerinde çalışacakları belgeler verebilirsin: PDF, Word, Excel ve PowerPoint dosyaları, CSV, Markdown, JSON, metin, kod ve görseller. Agentbits her dosyayı arka planda okur, parçalara böler ve aranabilir hale getirir. Ajanlar yalnızca kendilerine verilen dosyaları okur ve içeriği talimat olarak değil, her zaman veri olarak ele alır.

Dosyaları nereye ekleyebilirsin

Nereye	Kimle paylaşılır
Sohbet, #general	Varsayılan olarak liderle; Dosyaları kim okuyabilsin: seçicisinde Tüm proje ekibi ya da Takım: ad da var
Sohbet, direkt mesaj	O ajanla
Sohbet, görev akışı	Göreve bağlanır
Görev çekmecesi (Dosyalar) ya da Yeni görev penceresi	Göreve bağlanır
Ajan terminali (bölmeye bırak)	O ajanla; talimatına ve görevine bağlanır
Dosyalar bölümü	Sen izin verene kadar kimseyle paylaşılmaz

Her yerde ekleme düğmesini, sürükle-bırakı ya da yapıştırmayı kullanabilirsin. Yükleme dosyayı eklediğin anda başlar; metin çıkarma sen yazarken sürer. Kaldırdığın ya da hiç göndermediğin yüklemeler silinir.

Lider mesajını görevlere çevirdiğinde dosyalarını yeni görevlere ekler (sohbette bunu söyleyen kısa bir not çıkar); böylece o görevleri yapan ajanlar da dosyaları okuyabilir.

Desteklenen biçimler

Biçim	Ne okunur
PDF	Metin, sayfa sayfa (yalnızca metin katmanı; düzen ve tablolar yaklaşıktır)
Word (.docx)	Paragraflar, başlıklar, listeler ve tablolar. İzlenen silmeler atlanır. Üst/alt bilgi, dipnotlar ve belge içi görseller okunmaz.
Excel (.xlsx)	Tüm sayfalar, tarih biçimleriyle. Önbellekli değeri olmayan formül =FORMÜL olarak görünür.
PowerPoint (.pptx)	Slaytlar ve konuşmacı notları
CSV	Tablolar; ayraç kendiliğinden bulunur
Markdown	Başlıklara göre bölünür
JSON / JSONL, kod, düz metin	Metin olarak
Görseller (PNG, JPEG, GIF, WebP, BMP)	Boyutlar; görselin kendisi görsel kabul eden sağlayıcılara gider

Metin dosyaları UTF-8 (BOM’lu ya da BOM’suz) veya UTF-16 olabilir; diğerleri Windows-1254 olarak okunur. Dosya türü yalnızca uzantıya göre değil, dosyanın gerçek içeriğine göre de doğrulanır.

Okunmayanlar

• Taranmış PDF’ler ve görsellerdeki metin: OCR yok. Metin katmanı olmayan bir PDF açık bir mesajla kısmen okundu olarak işaretlenir.
• Eski Office biçimleri (.doc, .xls, .ppt) ve .rtf saklanır ama okunmaz.
• Görseller yalnızca görsel kabul eden sağlayıcılara gider: Anthropic API, OpenAI API (yalnızca görseller; PDF’ler OpenAI’ye belge olarak gönderilmez), Claude Code ve Codex CLI. Demo sağlayıcı görsel kullanmaz.

Sınırlar

Sınır	Değer
Dosya boyutu	Dosya başına 50 MB
Gönderim başına dosya	20
Görsel önizleme	En fazla 15 MB
Ajanın kaydettiği dosya	Yalnızca metin biçimleri, her biri 2 MB, çalışma başına 20

Metin çıkarma, bellek ve süre sınırları olan ayrı bir worker’da yapılır; sıkıştırılmış bir Office dosyasının ne kadar açılabileceği de sınırlıdır.

Kim neyi okuyabilir

Erişim varsayılan olarak kapalıdır: aşağıdakilerden biri doğru değilse hiçbir ajan dosyayı okuyamaz.

1. Dosya ajana gönderildi: lidere (#general’de varsayılan), bir takıma, tüm proje ekibine ya da direkt mesajla veya talimatla o ajana.
2. Dosya, ajanın üzerinde çalıştığı göreve bağlı.
3. Dosyanın Erişim sekmesinden o ajana ya da tüm proje ekibine izin verdin.

Ajanlar dosyaları yalnızca okuyabilir. Değiştiremez, silemez.

Uzun bir dosyada ajan okuyabildiği dosyaların listesini ve bir önizleme alır; gerisini dosya araçlarıyla bölüm bölüm okur ya da içinde arar. Codex CLI ajanlarının dosya aracı yoktur: prompt’a sığdığı kadar bölüm alırlar, dışarıda kalanı söyleyen bir notla birlikte.

Her dosyanın içeriği modele güvenilmeyen veri olarak işaretlenmiş şekilde gider. Agentbits ayrıca yapay zekâya yönelik talimat gibi okunan satırları arar ve bir uyarı gösterir (“talimat benzeri satır”). Bu satırlara her durumda uyulmaz.

Reddedilen okumalar, ajanların kaydettiği dosyalar, senin silmelerin ve erişim değişiklikleri denetim kaydına yazılır.

Ajanların ürettiği dosyalar

• Kaydedilen dosyalar: bir görev sırasında ajan metin çıktısını yeni bir dosya olarak kaydedebilir (Markdown, metin, CSV, JSON, HTML, XML, YAML, SQL, SVG ve benzerleri). Kaydeden ajan ve işi inceleyen proje lideri bu dosyayı okuyabilir.
• Klasördeki değişiklikler: dosya yazma izni olan Claude Code ve Codex CLI ajanlarında Agentbits başarılı bir çalışmadan sonra proje klasörünü tarar ve değişen dosyaları Klasör dosyaları olarak listeler. Kopyalanmazlar, klasöründe kalırlar. Tarama .git, node_modules, dist ve build gibi klasörleri atlar ve çalışma başına sınırlı sayıda dosya kaydeder.

Üretilen dosyalar görev akışında çip olarak, #general’de “📎 n dosya” olarak, ajanın dökümünde ve görev raporunda görünür.

Dosyalar bölümü

Her projenin bir Dosyalar bölümü (Ctrl+9) vardır: yüklenenler, ajanların ürettikleri ve proje klasöründe değişenler.

• Tümü, Yüklenen, Ajan ya da Klasör ile süz.
• Ad ya da içerikte ara…: içerikteki isabetler önizlemeyi eşleşen bölümde açar.
• Dosya yükle ya da dosyaları bölüme bırak. Buraya eklenen dosyalar henüz paylaşılmaz: sohbette ya da bir görevde paylaş veya Erişim’den izin ver.
• Listede Dosya, Tür, Boyut, Kaynak, Erişim, Durum ve Eklenme sütunları var.

Önizlemeyi açmak için bir dosyaya tıkla:

• İçerik: çıkarılan metin, 20’şer bölüm; CSV ve Excel tablo olarak; görseller.
• Erişim: ajan başına anahtarlar ve Tüm proje ekibi okuyabilsin. Erişim veren görevler de listelenir.
• Kullanım: dosyanın nerede Eklendi, Prompta verildi, Okundu ya da Üretildi olduğu.
• Farklı kaydet, varsayılan uygulamanla açma (yalnızca açılması güvenli türlerde), Klasörde göster (klasör dosyaları) ve silme.

Not: Bir klasör dosyasını silmek yalnızca kaydını siler. Proje klasöründeki dosyaya dokunulmaz.

Saklama

Dosyalar Agentbits veri klasöründe saklanır (Windows’ta %APPDATA%\Agentbits altında). Aynı dosya tek kez saklanır. Ayarlar → Veri yönetimi dosyaların ne kadar yer kapladığını gösterir; proje temizliği, proje klasörüne dokunmadan projenin dosya kayıtlarını silebilir. Bkz. Ayarlar.

İpucu: Yedekler çıkarılmış metni içerir. Asıl dosyalar, onlara başvuran bir yedek durduğu sürece saklanır.