> ## Documentation Index
> Fetch the complete documentation index at: https://docs.empiricintelligence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Uyumluluk

> E2B bulutu, Tencent CubeSandbox, duraklatma semantiği ve özel sertifika otoriteleri

Empiric Intelligence hem gerçek **E2B bulutuyla** hem de **Tencent CubeSandbox** gibi E2B uyumlu sandbox platformlarıyla çalışır. Ne Empiric Intelligence ne de köprü worker'ı bir E2B ana makine adını koda gömer; platform çözümlemesi tümüyle `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 --probe` bir 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](#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=false` ayarlayı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:

```bash theme={null}
SSL_CERT_FILE=/etc/ssl/certs/your-private-ca-bundle.pem
```

Empiric Intelligence bulut API'si her zaman herkesçe güvenilen bir sertifika sunar; `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.

## 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, ardından oluşturduğu her şeyi siler. 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 platform `error` 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.