Yazan: @41five
Box Mount artık özel ön izleme (private preview) aşamasında kullanıma sunuldu.
Bir sandbox içinde çalışan bir yapay zeka ajanı geliştiriyorsanız, modelin işe yarar bir çıktı üretmesini sağlamak işin yalnızca bir kısmıdır. Ajanın hâlâ üzerinde çalışacağı dokümanlara, bu dokümanlarla etkileşime gireceği araçlara ve oluşturduğu dosyaları kaydedeceği bir yere ihtiyacı vardır.
İlk bakışta bu dokümanları taşımak birkaç API çağrısıyla halledilebilir gibi görünür: girdiyi indir, ajanı çalıştır ve sonucu yükle. Ancak iş akışı sırasında dosyalar değişebildiğinde, insanların çıktıyı incelemesi gerektiğinde veya birden fazla ajan aynı içeriği paylaştığında bu katman çok daha karmaşık bir hâl alır. Artık senkronizasyon, sürümler, çakışmalar ve yeniden denemelerle de uğraşmanız gerekir.
Box Mount tam da iş akışının bu kısmı için tasarlandı. Bir ajan sandbox'ına POSIX uyumlu bir Box çalışma alanı sunarak, sandbox içindeki kodun ve araçların tanıdık dosya yolları üzerinden Box içerikleriyle çalışmasını sağlar. Box Mount her iki yöndeki veri hareketini yönetirken, Box yönetilen ana kayıt sistemi olmaya devam eder.
Box Mount ne zaman doğru tercih olur?
Box Mount'un amacı her Box API veya MCP çağrısının yerini almak değildir. Ajanınızın tek ihtiyacı bir dokümanı alıp bir prompt'a eklemekse, mevcut arayüzler size gereken her şeyi zaten sağlıyor olabilir.
Buradaki fark, dokümanların yalnızca bir bağlam mı yoksa ajanın çalışma ortamının bir parçası mı olduğudur.
Bir klasör dolusu sözleşmeyi inceleyen, doküman işleme araçlarını çalıştıran, bir inceleme notu oluşturan ve ardından bir avukatın değişiklik yapmasını bekleyen bir ajan düşünün. Ya da onaylı yanıtlardan oluşan bir kütüphaneden veri çeken, bir taslak hazırlayan ve bunu hukuk ile güvenlik ekiplerinin incelemesine geri gönderen bir RFP (Teklif Talebi) iş akışı hayal edin.
Bu durumlarda ajan, içeriği sadece bir kez alıp kenara çekilmez; harici bir çalışma zamanı (runtime) içinde bir dosya koleksiyonuyla aktif olarak çalışır.
Box Mount'un hedeflediği kalıp tam olarak budur: Geliştirici bir ajan sandbox'ı hazırlar, Box içeriğini bu ortama aktarır ve ajanın ürettiği işi tekrar Box'a geri gönderir.
Box Mount'u iş başında görün
Bu kısa demo, Box içeriğini bir E2B sandbox'ına aktarmak, ajanı bu çalışma alanında çalıştırmak ve tamamlanan incelemeyi insan kontrolü için Box'a geri senkronize etmek amacıyla Box Mount kullanan bir sözleşme inceleme uygulamasını gösteriyor.
Bu örnek, kurumsal içeriği bir OpenAI Agents API sandbox'ına aktarmak, beş kaynak dosya üzerinde paralel olarak bir lider ajan ve üç uzman ajan çalıştırmak ve temel MSA (Ana Hizmet Sözleşmesi) revize edildiğinde dört raporu otomatik olarak Box'a senkronize etmek için Box Mount kullanan çoklu ajanlı bir anlaşma odası (deal room) incelemesini göstermektedir.
Bu demo, onaylı politika dokümanlarını bir Vercel Sandbox microVM'ine aktarmak, 10 geçerli yanıt için kanıt sunacak ve 2 tanesini insan incelemesine yönlendirecek şekilde 12 madde üzerinde bir ajan çalıştırmak ve tamamlanan Excel çalışma kitabını otomatik olarak Box'a senkronize etmek amacıyla Box Mount kullanan bir güvenlik anketi incelemesini göstermektedir.
Bu demo, bir DigitalOcean sandbox ajanına Box bulut içeriğine erişimi için standart dosya yolları sağlamak, anlaşma odası dokümanlarını yerel olarak okumak ve herhangi bir indirme ya da yükleme mantığı kurmadan tamamlanan notu Box'a geri yazmak için Box Mount kullanan bir anlaşma odası durum değerlendirme notunu göstermektedir.
Sandbox içinde tanıdık bir çalışma alanı
Bir Box klasörü bağlandıktan (mount edildikten) sonra, ajan sıradan bir dizin görür:
1/mnt/box2├── Incoming/3│ └── Acme-MSA.docx4├── Playbook/5│ └── approved-contract-playbook.md6└── Reviewed/
Bu noktadan itibaren mevcut kütüphaneler ve komut satırı araçları, her işlem için Box'a özel bir araca ihtiyaç duymadan içerikle çalışabilir. Örneğin bir Node uygulaması, yerel dosyalar için kullanacağı dosya sistemi API'lerinin aynısını kullanabilir:
1import { readFile, writeFile } from "node:fs/promises";23const playbook = await readFile(4 "/mnt/box/Playbook/approved-contract-playbook.md",5 "utf8",6);78const review = await reviewContract({9 contractPath: "/mnt/box/Incoming/Acme-MSA.docx",10 playbook,11});1213await writeFile(14 "/mnt/box/Reviewed/Acme-MSA-review.md",15 review,16);
Uygulamanın bakış açısından bu son yazma işlemi sadece normal bir dosya işlemidir. Box Mount yeni incelemeyi Box'a senkronize eder; burada bir kişi dosyayı açabilir, düzenleyebilir, bir görev atayabilir veya yeni bir sürüm oluşturabilir.
Sandbox çalışmaya devam ederken biri dosyayı Box'ta güncellerse, bu değişiklik ajanın bir sonraki adımı için bağlı çalışma alanına geri akabilir. Bu durum, geliştiricilerin her dosya etrafında özel taşıma ve senkronizasyon mantığı kurmasını gerektirmeden ajanlar ve insanlar için ortak bir çalışma ortamı yaratır.
Ayrıca iş akışını belirli bir modele veya ajan çerçevesine olan bağımlılığından kurtarır. Sandbox; bir OpenAI ajanı, bir Anthropic ajanı, LangGraph, CrewAI, bir Python betiği, LibreOffice CLI veya bunların bir kombinasyonunu çalıştırıyor olabilir. Araç dosyalarla nasıl çalışacağını bildiği sürece, bağlı çalışma alanıyla da çalışabilir.
Parçalar birbiriyle nasıl uyum sağlar?
Ürününüz veya orkestratörünüz sandbox'ı hazırlamaktan ve ajanı çalıştırmaktan sorumludur. Box Mount, bu sandbox içinde başsız (headless) bir senkronizasyon bileşeni olarak çalışır; dosya sistemi arayüzünü sağlar ve Box API'leri aracılığıyla Box ile iletişim kurar.
Ajan, her doküman işlemi için Box'ı çağırmak yerine bağlı yol üzerinden çalışır. Box Mount klasörü güncel tutar, değişiklikleri yükler, çakışan güncellemeleri tespit eder ve çalışma alanı bağlantısı kesildiğinde (unmount) son senkronizasyonu tamamlar.
Box; izinler, sürümler, sınıflandırmalar, saklama politikaları, Shield korumaları ve denetim geçmişi dahil olmak üzere içerik katmanını sağlamaya devam eder. Sandbox senkronize edilmiş bir çalışma kopyası içerdiğinden, geliştiriciler bu ortamı ve yerel verilerini kendi güvenlik gereksinimlerine göre yönetmeye devam etmelidir.
Müşterinin ürünü sandbox'ı hazırlar ve ajanı çalıştırır. Box Mount, ajanın dosya sistemi çalışma alanını Box API'leri aracılığıyla Box'a bağlar.
Box Mount'u kullanmak
Temel Box Mount iş akışı yalnızca birkaç komuttan oluşur. Öncelikle Box kimlik bilgilerinizi yapılandırın:
1box-mount config
Bir Box klasörünü ajanın sandbox'ına bağlayın:
1mkdir -p /mnt/box2box-mount mount "/mnt/box" "<box-folder-id>"
Bağlantı kurulduktan sonra ajan sıradan dosya sistemi araçlarını kullanabilir:
1find /mnt/box -type f2cat /mnt/box/Playbook/approved-contract-playbook.md3cp generated-review.md /mnt/box/Reviewed/
Ajan çalışırken aktif bağlantıyı kontrol edebilirsiniz:
1box-mount status
Çalışma tamamlandığında, çalışma alanının bağlantısını kesin ve son senkronizasyonu tamamlayın:
1box-mount unmount "/mnt/box"
Kimlik doğrulama ve hazırlık süreçleri, uygulamanızın sandbox'larını nasıl başlattığına bağlı olacaktır. İkili dosyayla birlikte gelen özel ön izleme dokümantasyonu, mevcut yapılandırma seçeneklerini kapsamaktadır.
Neler inşa edebilirsiniz?
Sözleşme incelemesi bunlardan sadece bir örnek. Bir ajan, gelen anlaşmaları onaylı bir kılavuzla karşılaştırabilir, bulgularını Box'a geri yazabilir ve sonucu bir avukata devredebilir. Avukat incelemeyi Box'ta değiştirirse, ajan güncellenmiş dosyayı kendi çalışma ortamında görebilir.
Aynı kalıp; teklif ve RFP taslakları hazırlama, anlaşma odası analizi, yönetici brifingleri oluşturma, araştırma sentezi, uyumluluk incelemesi ve diğer doküman yoğun iş akışlarını destekleyebilir. Birden fazla ajan ortak bir Box klasörü üzerinden de çalışabilir; örneğin biri taslak oluşturur, diğeri inceler ve bir insan nihai kararı verir.
Model ve iş akışı değişebilir, ancak altındaki temel kalıp aynı kalır: Box içeriği harici bir sandbox'a girer, ajanın çalışma ortamının bir parçası hâline gelir ve ortaya çıkan iş tekrar Box'a döner.
Örnek uygulamayı keşfedin
Box Mount sözleşme inceleme örneği, E2B kullanan eksiksiz bir iş akışını göstermektedir.
Uygulama bir sandbox oluşturur, Box Mount'u kurar, bir Box sözleşme çalışma alanını bağlar ve Box AI ya da bir OpenAI ajanını çalıştırır. Ardından oluşturulan incelemeyi Box'a geri senkronize eder, isteğe bağlı olarak bir insan inceleyiciye atar ve geliştiricilerin kapatmadan önce sonucu inceleyebilmesi için sandbox'ı çalışır durumda bırakır.
Depo şu anda gizlidir ve Box Mount ikili dosyasını içermez. Özel ön izleme katılımcılarının depoya erişim sağlaması ve örneği çalıştırmadan önce kendilerine sağlanan ikili dosyayı projenin private/ dizinine yerleştirmesi gerekecektir.
Özel ön izlemeye katılın
Box Mount henüz erken aşamada ve sandbox'larda çalışan, Box içerikleriyle etkileşime giren ajan iş akışları geliştiren (veya bu konuyu keşfetmeye yeni başlayan) geliştiriciler arıyoruz.
Bu mimari sizin yapınıza benziyorsa, bugün içeriği nasıl taşıdığınızı, sandbox'ınızda nelerin çalıştığını ve mevcut yaklaşımın hangi noktada zorlaşmaya başladığını öğrenmek isteriz. Özel ön izleme katılımcıları, kendi iş akışlarıyla deneyebilmeleri için Box Mount ikili dosyasını ve kurulum rehberini alacaktır.
https://bit.ly/box-mount-preview
Box içeriğinin ajanınızın çalışma ortamının bir parçası olması gerekiyorsa, neler inşa ettiğinizi görmekten büyük mutluluk duyarız.
