OpenAI Agents API: Codex Altyapısı Tek Çağrıyla Açıldı

Bu duyurunun asıl anlamı şu: yapay zeka ajanı geliştirmenin en zahmetli katmanı, yani ajanı saatlerce ayakta tutan, hafızasını yöneten ve çöktüğünde toparlayan altyapı, artık OpenAI'nin sorumluluğunda. OpenAI, Codex'i ve ChatGPT'yi çalıştıran "harness" adı verilen bu iskeleti Agents API adıyla herkese açtı. Ürün 10 Eylül'de açık beta olarak tüm geliştiricilere sunuldu; ek ücret yok, sadece kullandığınız token, araç ve konteyner süresi faturalanıyor.

Bugüne kadar bir ajan yazmak isteyen ekip, modeli çağırmanın ötesinde bir sürü şeyi kendisi kuruyordu: konuşma geçmişi büyüdükçe bağlamı kırpmak, araçları sırayla ya da paralel çağırmak, uzun bir işte bağlantı koptuğunda kaldığı yerden devam etmek. Agents API bu işleri tek bir oturum nesnesinin içine gömüyor.

Dört parçalı bir kurgu

Agents API dört nesne üzerine kurulu. Agent (ajan): model, talimatlar, araçlar ve bağlı MCP sunucuları. Environment (ortam): ajanın dosya açıp komut çalıştırabildiği isteğe bağlı bir sandbox. Session (oturum): ajanın görev üzerinde çalışan kalıcı bir örneği. Events (olaylar): oturuma gönderdiğiniz girdiler ve geri akan çıktılar. Geliştirici bu dördünü tek bir API çağrısında tanımlıyor, gerisini OpenAI yürütüyor.

Otomatik gelen kabiliyetlerin listesi, bir ajan ekibinin aylarca uğraştığı işlerin özeti gibi:

• Bağlam sıkıştırma: oturum token sınırına yaklaşınca geçmiş kendiliğinden özetleniyor.
• Araç arama: araç tanımları ancak gerektiğinde yükleniyor, her istekte tüm listeyi taşımak zorunda kalmıyorsunuz.
• Programatik araç çağrısı: ajan birden fazla aracı paralel çalıştırıp sonuçları zincirleyebiliyor.
• Alt ajanlar: ana ajan, karmaşık bir işi bağımsız bağlamı olan alt ajanlara devredebiliyor; eşzamanlı alt ajan sayısı parametreyle sınırlanıyor.

Araç tarafında MCP (Model Context Protocol) sunucuları, özel fonksiyonlar, yerleşik web araması, gizli anahtarlar için "vault" ve olay bildirimi için webhook destekleniyor. Sandbox için iki yol var: OpenAI'nin barındırdığı konteynerler ya da kendi altyapınız. Kendi altyapı tarafında Cloudflare, Vercel, DigitalOcean, Oracle, Modal, E2B, Daytona, Runloop ve Blaxel ortak olarak sayılıyor. Belgelerdeki örnekler GPT-6 Astra modelini kullanıyor.

Responses API ve Agents SDK'dan farkı ne?

OpenAI bunu üçlü bir tabloyla anlatıyor. Responses API'de bütün akış sizin ortamınızda döner, geçmişi siz yönetirsiniz; entegrasyon yükü yüksek. Agents SDK uygulamanızın içinde çalışır, durumu siz saklarsınız; yük orta. Agents API'de harness'ı OpenAI yönetir, oturum durumu bulutta saklanır; yük düşük. Kısacası kontrolü ne kadar bırakırsanız, kurulum o kadar kısalıyor.

Küçük yazıyla yazılmış iki kısıt

Beta belgelerinde işletmeler için kritik iki not var. Birincisi, veriler şu an yalnızca ABD'de tutuluyor; başka bir bölge seçeneği yok. İkincisi, Sıfır Veri Saklama (Zero Data Retention) desteklenmiyor; sandbox'ı kendi sunucunuzda çalıştırmak bile bu durumu değiştirmiyor. Yani oturum içeriği OpenAI tarafında bir süre duruyor.

Türkiye'deki ekipler bundan ne çıkarmalı?

Sahada gördüğümüz tablo net: KOBİ projelerinde ajan geliştirme süresinin büyük bölümü modelin zekâsına değil, çevresindeki tesisata gidiyor. Bağlam yönetimi, yeniden deneme mantığı, uzun işlerin takibi. Agents API bu tesisatı hazır verdiği için bir prototipi haftalar yerine günler içinde ayağa kaldırmak mümkün hale geliyor. Muhasebe belgelerini tarayan, sipariş e-postalarını işleyen ya da eski kodu taşıyan bir ajan için bu ciddi bir hız kazancı.

Ancak iki kısıt Türkiye bağlamında büyütülerek okunmalı. Müşteri verisi, sözleşme ya da personel bilgisi içeren bir işi ABD'de tutulan ve silinme garantisi olmayan bir oturuma göndermek, KVKK'daki yurt dışına aktarım kurallarıyla doğrudan çarpışır. Bizce doğru sıra şu: Agents API'yi hassas veri içermeyen iş akışlarında, kod üretimi ve iç araç geliştirme gibi alanlarda deneyin; kişisel veri taşıyan süreçler için bölge seçeneği ve veri saklama garantisi gelene kadar Agents SDK ya da kendi harness'ınızla ilerleyin. Tesisatı dışarı vermek cazip, ama veri nerede yaşıyor sorusunun cevabı hâlâ sizin sorumluluğunuzda.

Kaynaklar: OpenAI, Introducing the Agents API, OpenAI Developers, Agents API Overview, The Decoder