AWS Bedrock AgentCore'a Session Endpoints Geldi: Kodlama Ajanı Uygulamayı Canlı Önizletiyor
Yazar: KOZBA
İçindekiler
Kodlama ajanları artık yalnızca dosya üretmiyor; çalışan bir web uygulaması, panel ya da ürün sayfası ortaya çıkarıyor. Bu işi değerlendirmenin en hızlı yolu uygulamayı açıp kullanmak, değişiklik istemek ve sonucu görmek. AWS, Amazon Bedrock AgentCore runtime'a eklediği Session Endpoints ile bu döngüyü ajanın kendi oturumunun içinde çalıştırıyor.
Session Endpoints ne yapıyor?
AgentCore runtime, her ajan oturumunu kendi izole mikroVM'inde çalıştırıyor. Session Endpoints ise o oturuma kimlik doğrulamalı bir URL veriyor. Bu URL, gelen isteğin HTTP metodunu, yolunu, sorgu dizesini ve gövdesini izin verilen portlara yönlendiriyor; WebSocket bağlantılarını da geçiriyor. Sonuç: ajan bir dosyayı kaydettiğinde tarayıcıdaki sayfa yenileme gerektirmeden güncelleniyor.
Altı kural: port, kimlik, protokol
- Portları sen seçiyorsun. "allowedPorts" alanına 1 ile 5 arası giriş veriliyor; her giriş 8000-12000 aralığında tek port ya da aralık olabilir, platformun ayırdığı portlar hariç. Portu izinli yapmak sunucuyu başlatmıyor; uygulamanın o portu 0.0.0.0 üzerinde dinlemesi gerekiyor.
- URL oturumla birlikte geliyor. InvokeAgentRuntime yanıtı adresi "X-Amzn-Bedrock-AgentCore-Runtime-Session-Endpoint-Url" başlığında taşıyor; SDK'larda "sessionEndpointUrl" olarak görünüyor.
- Her istek doğrulanıyor. IAM kullanan runtime'da her HTTP isteği, HTTP/2 akışı ve WebSocket el sıkışması SigV4 imzası taşıyor; çağıranın "bedrock-agentcore:InvokeAgentRuntimeProxy" izni de olmalı. JWT yetkilendirici kullanan runtime'da ise bearer token gerekiyor. URL'yi bilmek erişim hakkı vermiyor.
- Protokol desteği geniş. HTTP/1.1 ve HTTP/2 (server-sent events ve gRPC dahil) ile WebSocket geçiyor.
- Oturuma özel. URL yalnızca oturum sürdüğü sürece çalışıyor; üretimde kullanıcıya sunmak için uygulamayı AWS Amplify gibi bir barındırma servisine dağıtmak gerekiyor.
- Tarayıcı köprüsü. Tarayıcı kendi isteklerine SigV4 imzası ekleyemiyor; bu yüzden SDK'daki istemci makinede yerel bir uç açıyor. Tarayıcı localhost üzerinden bağlanıyor, kimlik bilgileri yerel uçta ekleniyor.
Örnek mimari: Vite + ajan + yerel köprü
AWS'nin örneğinde ajan oturumda 8080 portunda çalışıp site dosyalarını dört araçla (listele, oku, yaz, düzenle) değiştiriyor. Ajan 8090 portunda bir Vite geliştirme sunucusu başlatıyor; sunucu her kaydedilen değişikliği hot-reload WebSocket'iyle tarayıcıya itiyor. Kullanıcı ajanın adımlarını akış halinde izliyor ve siteyi koyu temaya çevirmesini istediğinde değişiklik yenileme olmadan görünüyor. Örnek kod, awslabs/agentcore-samples deposundaki Session Endpoints klasöründe.
Runtime endpoint ile farkı
Runtime endpoint, çağıranın ajanın hangi sürümüne ulaşacağını belirliyor; geliştirme ve üretimi ayrı sürümlerde tutup geri alma yapmayı sağlıyor. Session endpoint ise ajanın oturumunda ne çalıştığını, örneğin canlı bir web önizlemesini görmek için kullanılıyor. Yani biri sürüm yönetimi, diğeri gözlem aracı.
Ne zaman işe yarar?
İnceleme döngüsünü kısaltmak isteyen ekipler için doğrudan fayda sağlıyor: her değişiklik için dağıtım beklemek yerine uygulama oturum içinde açılıyor. Buna karşılık bu uç bir yayınlama yöntemi değil; oturum bitince adres de bitiyor. Hassas veriyle çalışanların izin verilen port listesini ve kimlik doğrulama yöntemini dikkatle seçmesi gerekiyor.
Kurulumda üç pratik not
- Portu izinli yapmak yetmiyor: uygulamanın o portu 0.0.0.0 üzerinde dinlemesi şart, aksi halde istekler ulaşmıyor.
- İstemci her zaman 443 portuna bağlanıyor; hedef portu host adındaki önek seçiyor. Yani port numarasını URL'ye elle yazmak gerekmiyor.
- Örnek ortamı kapatırken önizleme sayfası, yerel uç ve oturum durduruluyor; temizlik adımı runtime'ı, yüklenen kodu ve IAM rolünü siliyor.
Bir uyarı daha: bu adres paylaşılabilir bir demo bağlantısı değil. Her istek kimlik bilgisi taşıdığı için bağlantıyı bir meslektaşa göndermek tek başına erişim sağlamıyor; oturum bittiğinde adres de ölüyor. Kalıcı bir önizleme gerekiyorsa uygulamanın ayrı bir barındırma katmanına dağıtılması gerekiyor.
Sonuç
Session Endpoints, "ajan yazdı, insan baktı" döngüsündeki en büyük gecikmeyi kaldırıyor. Kimlik doğrulama zorunluluğu ve oturum ömrü sınırı ise güvenlik tarafında makul bir denge kuruyor. Ajan tabanlı geliştirme yapan ekipler için bu, değerlendirme sürecini dakikalardan saniyelere indiren pratik bir adım.