OpenAI Agents API’yi Tanıttı: Geliştiriciler Artık Bulutta Uzun Süre Çalışan Yapay Zeka Ajanları Oluşturabilecek

OpenAI, yapay zeka ajanları geliştirmek isteyen yazılımcılar için önemli bir adım atarak Agents API adlı yeni altyapısını kullanıma sundu. Public beta kapsamında geliştiricilere açılan yeni API, Codex’in arkasında bulunan ajan altyapısını doğrudan uygulamalara taşımayı amaçlıyor.

Yeni sistem sayesinde geliştiriciler; uzun süre çalışabilen, kod çalıştırabilen, dosyalar üzerinde işlem yapabilen, harici araçlara bağlanabilen ve karmaşık görevleri birden fazla alt ajana dağıtabilen yapay zeka sistemlerini daha az altyapı geliştirme yüküyle oluşturabilecek.

OpenAI’nin güncel dokümantasyonuna göre Agents API; oturum yönetimi, orkestrasyon, bağlam sıkıştırma ve hata sonrası devam etme gibi işlemleri OpenAI tarafından yönetilen Codex harness üzerinde gerçekleştiriyor. Geliştirici ise kullanılacak model, araçlar ve çalışma ortamı gibi bileşenleri belirleyebiliyor.

Agents API nedir?

Agents API, klasik bir yapay zeka API çağrısından daha kapsamlı bir çalışma modeli sunuyor.

Standart bir dil modeli API’sinde kullanıcı bir istek gönderir, model yanıt üretir ve işlem genellikle burada sona erer. Ajan tabanlı sistemlerde ise modelin görevi tamamlamak için çeşitli araçları kullanması, dosyalara erişmesi, kod çalıştırması, sonuçları kontrol etmesi ve gerektiğinde farklı görevleri alt ajanlara devretmesi gerekebiliyor.

OpenAI, Agents API ile bu karmaşık altyapının önemli bir bölümünü kendi tarafında yönetiyor.

API içerisinde temel olarak şu yapılar bulunuyor:

Agent: Kullanılacak model, talimatlar, araçlar ve MCP bağlantılarının tanımlandığı yapı.

Environment: Ajanın dosyalara eriştiği, komut çalıştırdığı ve gerekli yetenekleri kullandığı çalışma ortamı.

Session: Bir ajanın belirli bir görev üzerinde çalışmaya devam ettiği kalıcı oturum.

Events ve Items: Ajanın aldığı girdiler ile çalışma sırasında ürettiği çıktıların takip edildiği yapı.

OpenAI’ye göre sistem; kod çalıştırma, dosya düzenleme, MCP sunucularına bağlanma, çıktı dosyaları üretme ve uzun görevleri sürdürebilme gibi yeteneklere sahip.

Tek API çağrısıyla kapsamlı bir yapay zeka ajanı oluşturulabilecek

Agents API’nin dikkat çeken yönlerinden biri, karmaşık ajan yapılandırmalarının tek bir oturum oluşturma çağrısı üzerinden tanımlanabilmesi.

Geliştirici API isteği içerisinde kullanılacak modeli, araçları, çalışma ortamını ve ajanın gerçekleştirmesi gereken görevi belirleyebiliyor.

Örneğin bir yazılım şirketi, üretim ortamındaki hata oranlarını inceleyen bir ajan oluşturabilir. Bu ajan log kayıtlarını analiz edebilir, bağımlılıkları kontrol edebilir, dağıtım değişikliklerini araştırabilir ve elde ettiği sonuçları ayrı bir rapor halinde kaydedebilir.

Bu yaklaşım özellikle DevOps, yazılım geliştirme, araştırma, veri analizi ve kurumsal otomasyon gibi çok aşamalı işlerde önemli avantajlar sağlayabilir.

Alt ajanlar aynı görev üzerinde paralel çalışabilecek

Agents API’nin en önemli özelliklerinden biri multi-agent, yani çoklu ajan desteği.

Ana ajan, karmaşık bir görevi daha küçük parçalara ayırarak farklı alt ajanlara gönderebiliyor. Her alt ajan kendi bağlamı içerisinde çalışırken ana ajan elde edilen sonuçları tekrar bir araya getiriyor.

Örneğin kapsamlı bir yazılım problemi araştırılırken bir alt ajan hata kayıtlarını incelerken, başka bir alt ajan son yapılan dağıtımları araştırabilir. Üçüncü bir ajan ise kullanılan harici servislerde sorun olup olmadığını kontrol edebilir.

Bu görevler birbirinden bağımsızsa aynı anda yürütülebiliyor.

OpenAI dokümantasyonunda max_concurrent_subagents ayarıyla aynı anda çalışabilecek alt ajan sayısının sınırlandırılabildiği belirtiliyor. Güncel dokümana göre varsayılan eşzamanlı alt ajan sınırı koordinatör hariç 6 olarak belirtilmiş durumda.

OpenAI ayrıca yönetilen harness yapısının görevleri alt problemlere ayırarak subagent’lara devredebildiğini açıkça belirtiyor.

Uzun süren görevlerde bağlam yönetimi otomatik yapılabilecek

Uzun süre çalışan yapay zeka ajanlarının karşılaştığı en büyük problemlerden biri modelin context window, yani bağlam sınırına ulaşması.

Bir ajan saatler boyunca kod, doküman, terminal çıktısı ve farklı araçlardan gelen bilgilerle çalıştığında bağlam hızla büyüyebiliyor.

OpenAI bu problemi otomatik context compaction sistemiyle çözmeye çalışıyor.

Sistem, bağlam sınırına yaklaşılırken önceki çalışmaların önemli bölümlerini özetleyerek yeni bağlam içerisinde koruyor. Böylece geliştiricilerin uzun görevler için kendi bağlam sıkıştırma sistemlerini yazma ihtiyacı azalıyor.

Agents API dokümantasyonunda yönetilen harness özellikleri arasında önceki çalışmaların özetlenerek bağlam penceresinin yönetilmesi de yer alıyor.

Ajanlar MCP ve farklı araçları kullanabilecek

Agents API yalnızca model çalıştırmakla sınırlı değil.

Sistem farklı araçların ajanlara bağlanmasına izin veriyor.

Bunlar arasında:

• MCP sunucuları
• Özel fonksiyonlar
• Web araması
• Dosya işlemleri
• Programatik araç çağrıları

gibi seçenekler bulunuyor.

Özellikle MCP (Model Context Protocol) entegrasyonu sayesinde şirketler kendi veri kaynaklarını veya kurumsal servislerini ajanlara bağlayabiliyor.

OpenAI’nin örnek yapılandırmalarında geliştirici dokümantasyonuna erişmek için MCP sunucusu ile web aramasının aynı ajan içerisinde birlikte kullanılabildiği görülüyor.

OpenAI-hosted sandbox seçeneği geliyor

Agents API ile geliştiriciler ajanın çalışacağı ortamı da seçebiliyor.

Bunlardan biri OpenAI-hosted sandbox.

Bu modelde çalışma ortamı doğrudan OpenAI tarafından oluşturuluyor ve yönetiliyor. Ajan bu ortam içerisinde kod çalıştırabiliyor, dosyaları değiştirebiliyor ve çıktı dosyaları oluşturabiliyor.

OpenAI dokümantasyonunda Agents API için hem OpenAI-hosted hem de self-hosted sandbox seçenekleri ayrı çalışma modelleri olarak yer alıyor.

Self-hosted yapı tercih edildiğinde ise geliştiriciler ajanı kendi altyapılarında çalıştırabiliyor.

Bu yaklaşım özellikle şirketlerin güvenlik, ağ erişimi veya veri yerleşimi gereksinimlerine göre farklı ortamlar oluşturabilmesine olanak sağlayabilir.

Sandbox sağlayıcılarıyla iş birlikleri de bulunuyor

OpenAI aynı zamanda farklı bulut ve sandbox sağlayıcılarının Agents API ekosistemine entegre olabilmesi için çeşitli şirketlerle çalışıyor.

Duyuruda adı geçen sağlayıcılar arasında Cloudflare, DigitalOcean, E2B, Modal, Oracle, Vercel, Daytona, Blaxel ve Runloop gibi şirketler bulunuyor.

Bu tür seçeneklerin geliştiricilere CPU, GPU, bellek, güvenlik ve maliyet açısından farklı çalışma ortamları sunması hedefleniyor.

Böylece şirketler tamamen OpenAI tarafından yönetilen bir sandbox kullanmak yerine kendi altyapı ihtiyaçlarına daha uygun bir çalışma ortamı seçebilecek.

Codex’in arkasındaki ajan altyapısı geliştiricilere açılıyor

Agents API’nin teknik açıdan en dikkat çekici taraflarından biri Codex harness altyapısını temel alması.

OpenAI, aynı yaklaşımın Codex tarafında uzun süre çalışan kodlama ajanlarını yönetmek için kullanıldığını belirtiyor.

Harness; model çağrılarının yönetilmesi, araç kullanımı, bağlamın korunması, görevlerin alt ajanlara dağıtılması ve oturumların devam ettirilmesi gibi işlemleri kontrol ediyor.

OpenAI ayrıca Agents API dokümantasyonunda sistemi doğrudan “managed Codex harness” üzerinden dayanıklı bulut ajanları oluşturmak için konumlandırıyor.

Bu da geliştiricilerin yalnızca model API’sini kullanmak yerine OpenAI’nin ajan çalıştırmak için geliştirdiği orkestrasyon katmanına erişmesi anlamına geliyor.

Agents API ücretli mi?

OpenAI’nin fiyatlandırma yaklaşımında önemli bir ayrıntı bulunuyor.

Agents API için ayrıca bağımsız bir platform kullanım bedeli yerine kullanılan kaynaklar üzerinden ücretlendirme uygulanıyor.

Güncel OpenAI dokümantasyonuna göre:

Model kullanımı seçilen modelin API fiyatına göre, OpenAI araçları standart araç fiyatları üzerinden ve OpenAI-hosted sandbox kullanımı da standart container ücretleri üzerinden hesaplanıyor.

Dolayısıyla “Agents API ücretsiz” ifadesi teknik olarak yanıltıcı olabilir. API katmanının ayrıca ücretlendirilmemesi, ajanın çalıştırılmasının tamamen ücretsiz olduğu anlamına gelmiyor.

Uzun süre çalışan ve çok sayıda araç kullanan ajanlarda token, araç çağrısı ve sandbox kaynak maliyetleri toplam maliyeti doğrudan etkileyebilir.

Yapay zeka uygulamalarında yeni dönem başlayabilir

Son yıllarda yapay zeka sektöründe odak noktası yalnızca soru yanıtlayan sohbet botlarından görev tamamlayan ajan sistemlerine doğru kayıyor.

OpenAI daha önce Responses API, Agents SDK, web search ve computer use gibi araçlarla ajan tabanlı uygulamalar için çeşitli yapı taşlarını kullanıma sunmuştu. Şirket, Mart 2025’te Responses API ve Agents SDK’yı geliştiricilerin ajan tabanlı sistemler oluşturmasını kolaylaştırmak amacıyla duyurmuştu.

Agents API ise bu yaklaşımı bir adım ileri taşıyarak yalnızca araç sağlayan bir API yerine, ajanın çalışma sürecini yöneten barındırılmış bir orkestrasyon altyapısı sunuyor.

Özellikle saatler süren yazılım geliştirme, araştırma, veri analizi ve operasyon görevlerinde bu yaklaşım geliştiricilerin kurması gereken altyapıyı önemli ölçüde azaltabilir.

Bununla birlikte sistem halen beta aşamasında olduğu için üretim ortamlarında kullanılmadan önce güvenlik, maliyet kontrolü, araç yetkilendirmeleri ve insan denetimi gibi konuların dikkatli şekilde ele alınması gerekiyor.

OpenAI’nin Agents API hamlesi, yapay zeka yarışının bir sonraki aşamasının yalnızca daha güçlü modeller üretmek değil, bu modellerin uzun süre güvenilir biçimde çalışabileceği ajan altyapıları oluşturmak üzerine şekilleneceğini gösteriyor.