AWS, Bedrock agentlarını TypeScript ile geliştirmek ve dağıtmak için AgentCore CLI 1.0'ı yayınladı

AWS, AgentCore CLI 1.0'ı yayınladı

dev.to'da yayımlanan uygulamalı bir rehbere göre AWS, AgentCore CLI'nın 1.0 sürümünü 28 Ekim 2026'da genel kullanıma açtı. CLI, AI agentlarını üretim ortamında çalıştıran AWS platformu olan Amazon Bedrock AgentCore'a girişin fiili yolu. Agent projeleri oluşturuyor, bunları test için yerel olarak çalıştırıyor ve AWS'ye dağıtıyor. Dağıtım arka planda AWS CDK'ya dayanıyor, ancak araç bu detayı kullanıcıdan gizliyor.

@aws/agentcore npm paketi, Şubat 2026'dan bu yana bir dizi 0.x sürümü olarak önizlemedeydi. Dev.to yazarının aktardığına göre AWS, 1.0 için CLI'yı baştan yazdı: artık daha hızlı açılıyor, tek tip bir komut yapısı izliyor ve daha fazla kaynak türünü kapsıyor. Yazar her şeyi 1.0.1 sürümüyle test etti ve özel araçlara sahip bir TypeScript agentının boş bir dizinden AWS'de canlı bir çağrıya ulaşması için kabaca beş komut ve iki dosya gerektiğini tahmin ediyor.

Bilinmesi gereken dört kavram

AgentCore, tek başına veya birlikte kullanılabilen yapı taşlarına ayrılıyor ve CLI bunları yönetiyor. Rehber platformu dört terime indirgiyor. Runtime, agent kodu için yönetilen ortam ve her oturuma kendi izole microVM'ini veriyor. Harness, yalnızca yapılandırma üzerinden tanımlanan — model, prompt ve araçlar — bir agent; AgentCore agent döngüsünü çalıştırıyor ve hiç kod yazılmıyor. Memory, konuşma geçmişlerini ve buradan türetilen bilgileri saklıyor, böylece bir agent oturumlar arası hatırlayabiliyor. Gateway, API'leri ve Lambda fonksiyonlarını agentların çağırabileceği MCP araçları olarak açığa çıkarıyor.

CLI'daki yenilikler

Komutlar üç bölümde gruplanıyor: Project (create, dev, deploy, invoke), Resources (runtime, harness, gateway, memory) ve Settings. Mevcut kaynaklara, önce bir projeye eklenmeden doğrudan ID veya ARN ile erişilebiliyor. Region, JSON çıktısı ve hata ayıklama için global seçenekler her komutta aynı şekilde davranıyor; yazar bunun CI scriptlerini çok daha kullanışlı hale getirdiğini belirtiyor. Argümansız komutu çalıştırmak, menüler ve sihirbazlar içeren etkileşimli bir terminal arayüzü başlatıyor.

TypeScript yolu

Pratik gereksinimler mütevazı: Node.js 20.12 veya daha yenisi, geçerli AWS kimlik bilgileri, AgentCore ve CDK bootstrap rolleri için IAM izinleri ile Bedrock'ta bir Claude modeline erişim. TypeScript şablonu ZIP arşivi olarak paketlendiği için Docker gerekmiyor.

Proje oluşturma bir template bayrağı kullanıyor; varsayılan sihirbaz bir harness üretiyor, bu yüzden kendi kodunu isteyen geliştiriciler açık kaynak bir AWS çerçevesi olan Strands Agents üzerine inşa edilen agent-typescript-strands gibi bir template seçiyor. Bir Vercel AI SDK varyantı ve birkaç Python template'i de mevcut. Oluşturulan projenin merkezinde, hangi kaynakların dağıtılacağını listeleyen ve bir CDK stack'ine çevrilen agentcore.json dosyası var; yanında geliştiricilerin kendi AWS kaynaklarını ekleyebileceği, DynamoDB örneği de içeren bir CDK projesi üretiliyor. Araçlar, modelin çağırabileceği fonksiyonlar; Strands argümanları bir Zod şemasına göre doğruluyor.

Rehberdeki bilinçli bir basitleştirme: Strands template'i otomatik olarak dört stratejili — facts, preferences, summaries ve episodes — bir Memory ekliyor; yazar bunu ilk çalıştırmada kaldırdı çünkü ekstra maliyet getiriyor, dağıtımı yavaşlatıyor ve agentın kendisinin ne yaptığını belirsizleştiriyor. Bir agent gerçekten bir şeyler hatırlaması gerektiğinde Memory geri eklenebilir.

Dikkat edilmesi gereken pürüzler

0.x sürümleriyle oluşturulan projelerin agentcore migrate ile dönüştürülmesi gerekiyor ve çevrimiçi dokümantasyonun bir kısmı hâlâ migrate yerine import gibi eski komut adlarını anlatıyor. Yazar ilk haftalarda komut başına yardım çıktısına güvenilmesini öneriyor. Eski bir Python araç seti olan bedrock-agentcore-starter-toolkit de agentcore adında bir binary kuruyor ve çakışmaları önlemek için kaldırılmalı. CLI varsayılan olarak anonim kullanım verisi topluyor; bu, bir config ayarıyla kapatılabiliyor. Kodsuz bir harness ile başlayan geliştiriciler kilitlenmiyor: yalnızca yapılandırmaya dayalı yaklaşım sınırlayıcı hale gelirse, harness daha sonra koda aktarılabiliyor.

Neden önemli

Pek çok agent prototipi geliştiricinin makinesinden hiç çıkmıyor ve dev.to yazarına göre bunun nedeni nadiren model — aradaki runtime, izinler ve loglama gibi cazibesiz sıhhi tesisat işleri. AgentCore CLI 1.0, AWS dükkânları için tam da bu boşluğu hedefliyor ve dağıtımı özel altyapı çalışmalarından küçük sayıda komuta dönüştürüyor. Tek tip komut yapısı ve tutarlı çıktı bayrakları, aracı tek seferlik yerel kullanım yerine CI hataları için de makul kılıyor. Kısa vadeli maliyetler gerçek — 0.x'ten zorunlu geçiş ve sürümün gerisinde kalan dokümantasyon — ama Bedrock'a standardize olan ekipler için CLI, çalışan bir prototip ile üretimde gerçekten çalışan bir agent arasındaki eşiği düşürüyor.