e2b SDK’sının standart ortam değişkenlerine bırakılmıştır ve tek bir worker ikili dosyasını farklı platformlar arasında taşınabilir kılan da budur.
Sonlandırma değil, duraklatma
Empiric Intelligence sandbox’ları boştayken duraklatılır ve görev devam ettiğinde bir ila iki saniye içinde kaldığı yerden sürdürülür; duraklatma boyunca sandbox’ın diski bozulmadan kalmalıdır. Bu önemlidir, çünkü ajan görevleri uzun ömürlüdür ve dalgalı seyreder: boştaki sandbox’ları sonlandırmak çalışma durumunu kaybettirir, onları sürekli açık tutmak ise kapasitenizi boşa harcar. Biten değerlendirme sandbox’ları, hata ayıklama ve yeniden puanlama için bir saklama süresi boyunca duraklatılmış halde tutulur (yeniden puanlamanın hâlâ gerekebileceği durumlarda önce anlık görüntü alınır), ardından geri kazanılır; sandbox çalışma alanı tasarım gereği geçicidir ve kalıcı sonuçlar her zaman Empiric Intelligence’in nesne depolamasına arşivlenir. Platformunuz iki işlevsel eşiği geçmelidir; her ikisi de canlı olarak doğrulanır (CubeSandbox bir sürüm uç noktası sunmaz, bu yüzden doğrulama her zaman işlevseldir, hiçbir zaman bir sürüm dizesine dayanmaz):- Zaman aşımında duraklatma ve disk bütünlüğü. E2B bulutu: yerleşik olarak destekler. CubeSandbox: v0.5.0 veya daha yenisi gerekir.
ei-worker doctor --probebir sandbox oluşturur, duraklamasını bekler, yeniden bağlanır ve diskin korunduğunu doğrular. - Anlık görüntü ve türetme (aşağıdaki Anlık görüntüler bölümüne bakın). E2B bulutu: yerleşik olarak destekler. CubeSandbox: v0.5.1 veya daha yenisi gerekir (anlık görüntüden başlatma için sağlamlaştırılmış CubeCoW anlık görüntü motoru).
ei-worker doctor --probe, Empiric Intelligence bulut denetiminin yürüttüğü anlık görüntü turunun aynısını çalıştırır.
doctor --probe komutunu devreye alırken ve her platform yükseltmesinden sonra çalıştırın. Eşiklerden herhangi birini geçemeyen bir platform, Empiric Intelligence uyumluluk denetimi tarafından reddedilir: runtime hiçbir zaman connected durumuna ulaşmaz ve bu platform üzerindeki değerlendirme işleri, platform yükseltilip yeniden denetlenene kadar engellenir.
Anahtar doğrulama
E2B SDK’sı, API anahtarlarını E2B’nin kendi anahtar biçimine (e2b_...) göre doğrular. Uyumlu platformlar kendi biçimlerini kullanır (CubeSandbox anahtarları sk-cube-... gibi görünür), bu nedenle bu platformlar için anahtar doğrulaması kapatılmalıdır:
- Köprü modu: worker ortamında
E2B_VALIDATE_API_KEY=falseayarlayın. - Doğrudan mod: Empiric Intelligence temsilcinizden runtime üzerinde anahtar doğrulamasını kapatmasını isteyin; uyumluluk denetimi bundan sonra anahtarın gerçekliğini değil, erişilebilirliği ve API uyumluluğunu kontrol eder ve bu kapsamı runtime üzerine kaydeder.
Özel sertifika otoriteleri
Özel bir CA arkasındaki intranet platformu, worker’ı CA sertifika paketinize yönlendirdiğinizde köprü modunda çalışır:SSL_CERT_FILE worker sürecinin bağlantılarındaki TLS doğrulamasını yönetir. Sistem sertifika deposunu genişletmek yerine değiştiren bir paketin, worker’ın Empiric Intelligence bulutuna kurduğu bağlantıyı da etkileyeceğini unutmayın; bu nedenle genel kök sertifikaları da içeren bir paket tercih edin.
Şablon derlemeleri
Bazı Empiric Intelligence özellikleri, E2B şablon derleme API’si üzerinden platformunuzda sandbox imajları (“şablonlar”) türetir. Uyumluluk denetimi, platformunuzun bunu destekleyip desteklemediğini kaydeder; şablon derlemeyi desteklemeyen platformlar görevleri önceden derlenmiş imajlar üzerinde yine de çalıştırır ve istediğiniz bir özellik buna ihtiyaç duyuyorsa Empiric Intelligence temsilciniz sizi bilgilendirir.Özel sandbox’lar
Bir sandbox’ın portlarına, port numarası ve sandbox kimliğinden oluşan bir adres üzerinden sandbox’ın dışından erişilebilir. Empiric Intelligence platformunda her sandbox özeldir: portlarına gelen dış trafik, yalnızca Empiric Intelligence’in tuttuğu o sandbox’a ait erişim belirtecini taşımıyorsa reddedilir. Komutlar ve dosya aktarımları etkilenmez, çünkü sandbox arka plan hizmetinin kendi portu kendi anahtarını kullanır. Kendi platformunuzdaki bir runtime, özel bir sandbox’ın orada çalıştığı bir doğrulamayla kanıtlanana kadar platformunuzun varsayılan ayarını korur. Uyumluluk denetimi özel bir sandbox oluşturur, içinde bir komut çalıştırır, bir dosya yazıp geri okur; doğrudan bir runtime üzerinde ayrıca platformun ayarı gerçekten uyguladığını doğrulamak için sandbox’ın kendi kaydını okur. Bu başarılı olduğunda, o andan itibaren runtime üzerinde oluşturulan her sandbox özeldir. Başarısız olduğunda runtimeconnected durumunda kalır, platformunuzun varsayılan ayarını korur ve sonucu kaydeder. Bazı E2B uyumlu platformlar erişim belirtecini arka plan hizmetininki dahil her portta denetler; bu platformlarda özel sandbox’lar komut çalıştıramaz, bu yüzden denetim onları çalışmıyor olarak kaydeder. Bir sandbox oluşturulduğu ayarı korur.
Sandbox imajları
Özel bir sandbox şablonu bubblewrap 0.8 veya daha yenisini içermelidir. Ajanın çalıştırdığı her komut küçük bir yazma sınırı içinde başlatılır: tüm sandbox’ı okuyabilir, yalnızca kendi klasörlerine yazabilir. Uygunluk denetimi, ajanlarınızın kullandığı her şablonda bir komutu bu şekilde başlatır; bubblewrap eksikse veya 0.8’den eskiyse runtimeerror durumunda kalır ve eklenmesi gereken paketi belirtir.
Tarayıcı
Ajanın tarayıcısı Empiric Intelligence sandbox imajının bir parçasıdır: Chrome, ekranı ve onu yöneten hizmet bu imajda kuruludur; canlı görüntü ve oturum açma formu ona Empiric Intelligence bulutu üzerinden ulaşır. Bu nedenle tarayıcı yalnızca Empiric Intelligence platformunda kullanılabilir. Doğrudan veya köprü bir runtime üzerinde ajan tarayıcı olmadan çalışır.Anlık görüntüler
Empiric Intelligence’in değerlendirme ve eğitim motoru, sandbox’ların anlık görüntüsünü alır ve bu anlık görüntülerden yeni sandbox’lar türetir (bellek + disk). Bir çalıştırmanın becerilerini yalnızca bir kez hazırlayıp her denemeyi bu hazır durumdan türetmesini, çöken denemeleri el değmemiş bir kopyadan yeniden başlatmasını ve biten bir denemeyi ajanı yeniden çalıştırmadan sonradan yeniden puanlamasını sağlayan şey budur. Anlık görüntü desteği, uyumluluk denetiminin her platform türü için zorunlu koşuludur: denetim bir sandbox oluşturur, bir işaret yazar, anlık görüntüsünü alır, bu anlık görüntüden ikinci bir sandbox başlatır ve işaretin türetilen sandbox’ta bulunduğunu doğrular. Her iki sandbox da ardından silinmez, duraklatılır. CubeSandbox üzerinde bu işlevsel tur tam olarak v0.5.1 eşiğidir: v0.5.0 duraklatma eşiğini geçer ama burada başarısız olur. Geçemeyen bir platformerror durumunda kalır ve başarısız adım runtime üzerinde belirtilir; platform yükseltildikten sonra bir sonraki denetimde otomatik olarak yeniden bağlanır.