Yönetici Özeti ve Mimari Önem
vercel-ai-gateway-and-vercel-san entegrasyonunun yayınlanması, geliştiricilerin otonom kodlama ajanlarını nasıl koordine ettiği, izlediği ve çalıştırdığı konusunda kritik bir evrime işaret ediyor. Hermes Agent çerçevesini Vercel'in kurumsal düzeydeki altyapısıyla köprüleyen bu sürüm; çok modelli yapay zeka yönlendirmesini titiz, donanım düzeyinde yalıtımla eşleştiren birleşik bir boru hattı (pipeline) sunar. Geliştiriciler artık Vercel AI Gateway aracılığıyla herhangi bir token maliyet artışı cezasıyla karşılaşmadan 200'den fazla farklı temel modelden yararlanabilir; bu da ekiplerin karmaşık yapay zeka odaklı iş akışlarını yönetme biçimini dönüştürürken tüm operasyonlarda sıkı bir finansal görünürlük sağlar.
Mimari açıdan bakıldığında, yürütme ortamlarının ayrıştırılması muhtemelen en dönüştürücü adımdır. Geleneksel olarak, yerel ajan tabanlı iş akışlarının çalıştırılması; ana bilgisayar ortamını potansiyel yan etkilere, bağımlılık kirliliğine ve model tarafından oluşturulan rastgele kabuk komutlarının çalıştırılmasından kaynaklanan güvenlik açıklarına maruz bırakıyordu. Vercel Sandbox mikroVM mimarisini yürütme döngüsüne entegre eden bu güncelleme, sıfır güven (zero-trust) yürütme sınırı uygular. Her ajan komutu, /vercel/sandbox konumunda köklenen yönetilen, bulut tabanlı bir mikroVM çalışma alanında çalışır ve yerel geliştirme makinelerinin kusursuz kalmasını sağlarken bulutta sorunsuz bir şekilde yürütme ölçeklendirmesi gerçekleşir.
Temel İyileştirmeler ve Geliştirici Ergonomisi
Entegrasyon iki temel sütun etrafında yoğunlaşmaktadır: Vercel AI Gateway aracılığıyla merkezileştirilmiş model çıkarımı (inference) ve Vercel Sandbox aracılığıyla güvenli uzaktan yürütme. AI Gateway, Hermes kurulum sihirbazı sırasında canlı model kullanılabilirliğini ve güncel fiyatlandırma metriklerini dinamik olarak sorgulayan yüksek performanslı bir proxy katmanı görevi görür. Bu, birden fazla sağlayıcı genelinde parçalanmış API anahtarlarını yönetme sürtünmesini ortadan kaldırarak farklı LLM uç noktalarını tek bir kimlik doğrulamalı arayüz altında birleştirir. Ek olarak, her çağrı otomatik olarak Vercel AI Gateway kontrol paneline yansıtılır; böylece mühendislik liderlerinin operasyonel harcamaların, gecikme profillerinin ve token tüketim metriklerinin konsolide bir denetim izini koruması garanti edilir.
Yürütme cephesinde, geliştirici ergonomisi yerel iş akışlarından uzaktaki iş akışlarına isteğe bağlı (opt-in), sürtünmesiz bir geçişi desteklemek için titizlikle tasarlanmıştır. Kutudan çıktığı haliyle Hermes, tanıdık hata ayıklama paradigmalarını koruyarak komutları yerel olarak çalıştırmaya devam eder. Ancak, yapılandırma vercel_sandbox hedeflenecek şekilde güncellenerek geliştiriciler; node24, node22 ve python3.13 dahil olmak üzere modern çalışma zamanları tarafından desteklenen bulut tabanlı yürütmenin kilidini açar. Kimlik doğrulama ve çalışma alanı bağlama, standart Vercel CLI ilkelleri (vercel link ve vercel env pull) aracılığıyla yerel olarak işlenir; böylece mevcut CI/CD veya yerel geliştirme boru hatları bozulmadan güvenli OIDC token'larının (VERCEL_OIDC_TOKEN) şeffaf bir şekilde sağlanması garanti edilir.
Mimari Karşılaştırma Matrisi
| Yetenek | Önceki Temel Çizgi (Yerel Yürütme ve Doğrudan API'ler) | Yeni Mimari (vercel-ai-gateway-and-vercel-san) |
Mimari Etki |
|---|---|---|---|
| Çıkarım Katmanı | Parçalanmış üçüncü taraf sağlayıcı API'leri ile doğrudan entegrasyon | Vercel AI Gateway aracılığıyla merkezileştirilmiş (200+ model, sıfır token maliyet artışı) | Birleşik faturalandırma, dinamik fiyatlandırma senkronizasyonu ve merkezi kontrol paneli gözlenebilirliği. |
| Yürütme Ortamı | Korumasız yerel makine terminali (/bin/sh veya bash) |
/vercel/sandbox konumunda köklenen yalıtılmış bulut mikroVM çalışma alanı |
Yan etki kirliliğini ortadan kaldırır ve donanım düzeyinde çalışma zamanı yalıtımı garanti eder. |
| Çalışma Zamanı Ortamları | Ana makine ikili dosyalarına ve küresel paketlere bağımlı | Yönetilen çalışma zamanları (node24, node22, python3.13) |
Tüm mühendislik istasyonlarında belirleyici, yeniden üretilebilir yürütme ortamları sağlar. |
| Kimlik Doğrulama ve Yetkilendirme | .env dosyalarına dağılmış birden fazla ayrı API anahtarı |
VERCEL_OIDC_TOKEN aracılığıyla merkezi OIDC token yönetimi |
Azaltılmış gizli veri sızıntısı yüzeyi ve basitleştirilmiş kurumsal kimlik bilgisi rotasyonu. |
Önemli Değişiklikler ve Geçiş Uyarıları
Vercel Sandbox arka ucu kesinlikle isteğe bağlı (opt-in) olduğundan, bu sürüm mevcut Hermes Agent dağıtımlarıyla tamamen geriye dönük olarak uyumludur. Varsayılan olarak, açıkça geçersiz kılınmadığı sürece ajan komutları ana makinede yerel olarak yürütülmeye devam eder. Bununla birlikte, bulut mikroVM arka ucuna geçiş, belirli ortam ön koşullarına uyulmasını gerektirir. Ekipler, Vercel CLI aracılığıyla kimlik doğrulaması yaptıklarından ve gerekli VERCEL_OIDC_TOKEN değerini doldurmak için vercel env pull komutunu kullanarak ortam değişkenlerini başarıyla çektiklerinden emin olmalıdır. Geçerli OIDC token'larının sağlanamaması, uzaktan sandbox örneklerini başlatmaya çalışırken yetkilendirme reddedilmelerine neden olacaktır. Ek olarak, desteklenen node24, node22 ve python3.13 konteyner imajlarında bulunmayan özel ana makine düzeyindeki ikili dosyalarına güvenen projelerin, başlatma sırasında bağımlılıkları /vercel/sandbox kök dizinine yüklemek için kurulum betiklerini açıkça uyarlaması gerekir.
Adım Adım Yükseltme Kılavuzu
Yeni AI Gateway ve Sandbox mimarisini Hermes Agent iş akışlarınız dahilinde benimsemek için aşağıdaki yapılandırma adımlarını yürütün:
Hermes'i Yükleyin ve Başlatın: Hermes'in en son sürümünün yüklü olduğundan emin olun, ardından interaktif kurulum sihirbazını başlatın ve birincil çıkarım sağlayıcınız olarak Vercel AI Gateway'i seçin.
npm install -g hermes-agent hermes setupKimlik Doğrulaması Yapın ve Projeyi Bağlayın: Yerel deponuzu Vercel projektünüze bağlayın ve gerekli geliştirme ortamı kimlik bilgilerini ve token'larını içeri çekin.
vercel link vercel env pullSandbox Arka Uçunu Etkinleştirin: Terminal arka uç parametresini açıkça ayarlayarak yürütmeyi yerel makinenizden güvenli bulut mikroVM'sine geçirmek için yapılandırma dosyanızı güncelleyin:
{ "terminal.backend": "vercel_sandbox" }