OpenAI Agents API Nedir? Codex’in Harness’ı Artık Tek API Çağrısı

OpenAI, 10 Eylül 2026’da Agents API’yi public beta olarak yayınladı. Agents API, Codex’i çalıştıran ajan altyapısını — bağlam yönetimi, araç kullanımı, alt ajan koordinasyonu ve uzun süren oturumların kurtarılması — tek bir API çağrısının arkasına koyuyor.

Bugüne kadar bu katmanı ya kendiniz yazıyordunuz ya da LangChain, CrewAI gibi üçüncü parti çerçevelerle kuruyordunuz. Artık resmî ve yönetilen bir alternatifi var. Aşağıda API’nin gerçekte ne verdiğini, neyi vermediğini ve hangi durumda mantıklı olduğunu inceliyoruz.

Agents API hangi sorunu çözüyor?

Bir dil modeline araç vermek kolay. Zor olan, o modeli saatlerce, bazen günlerce ayakta tutmak. OpenAI’ın kendi çerçevelemesi şöyle: kullanışlı bir ajan, bağlamı yöneten ve alt ajanları koordine eden güçlü bir harness‘a; bir de dosyayla çalışabildiği, kod çalıştırabildiği ve ara sonuçları saklayabildiği bir ortama ihtiyaç duyuyor.

Uzun süren bir ajanı kendi başınıza yazdığınızda karşılaştığınız problemler hep aynı:

• Bağlam şişmesi: Konuşma uzadıkça pencere doluyor; neyi atacağınıza karar vermek ayrı bir mühendislik işi.
• Araç kalabalığı: Onlarca aracın tanımını her turda modele göndermek token yakıyor.
• Kopma: Süreç düştüğünde ajanın nerede kaldığını bilmek ve oradan devam etmek.
• İzolasyon: Ajanın kod çalıştıracağı, güvenli ve tekrarlanabilir bir kum havuzu kurmak.

Agents API bu dördünü de kendi tarafına alıyor. Karşılığında harness üzerindeki kontrolü bırakıyorsunuz — ana takas bu.

Dört kavram: Agent, Environment, Session, Events

API’nin tamamı dört nesne etrafında kuruluyor:

• Agent — model, sistem talimatı, araçlar ve MCP sunucu bağlantıları.
• Environment — isteğe bağlı sandbox; ajanın dosyaya eriştiği çalışma alanı.
• Session — turlar arasında durumu taşıyan kalıcı ajan örneği.
• Events ve items — ajana gönderilen girdiler ve yürütme sırasında ürettiği çıktılar.

Tek uç nokta var: POST https://api.openai.com/v1/agents/sessions. Resmî SDK’larda aynı çağrı Python ve Node.js’te client.beta.agents.sessions.create(), Go’da client.Beta.Agents.Sessions.New(), Java’da client.beta().agents().sessions().create() olarak geçiyor.

Oturum açmak için gereken alanlar: agent.model, agent.instructions, environment.type ve ilk kullanıcı mesajını taşıyan input. Dokümantasyondaki örneklerin tamamı gpt-6-astra modelini kullanıyor.

from openai import OpenAI

client = OpenAI()

session = client.beta.agents.sessions.create(
    agent={
        "model": "gpt-6-astra",
        "instructions": "Dokümantasyon MCP'sini ve web aramasını kullanarak soruları yanıtla",
        "tools": [
            {"type": "programmatic_tool_calling"},
            {"type": "web_search"},
        ],
    },
    environment={"type": "self_hosted", "workspace_directory": "/workspace"},
    input=[{"role": "user", "content": [{"type": "input_text", "text": "Görev metni"}]}],
)

Oturum açıldıktan sonra ilerlemeyi akış (streaming) ile izleyebiliyor ya da webhook ile haber alabiliyorsunuz. Harness’ın kendi kattığı üç şey var: otomatik bağlam sıkıştırma, token tüketimini azaltan araç arama ve araçları paralel çalıştırabilen programatik araç çağırma.

Ajan nerede çalışır? Üç sandbox seçeneği

environment alanı, ajanın dosyaya dokunduğu ve kod çalıştırdığı yeri belirliyor. Üç yol var:

1. OpenAI barındırmalı sandbox — Codex ve ChatGPT’nin kullandığı altyapı. Dosyalar, paketler ve beceriler yapılandırılabiliyor.
2. Kendi altyapınız — codex exec-server‘ı çalıştırıp WebSocket ile bağlanıyorsunuz.
3. Partner sandbox’ları — duyuruda adı geçen sağlayıcılar: Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop, Vercel.

Responses API ve Agents SDK’dan farkı ne?

OpenAI’ın artık üç ayrı ajan katmanı var ve ayrım tek bir soruya iniyor: döngüyü kim çeviriyor?

• Responses API: Döngüyü siz kuruyorsunuz. En yüksek kontrol, en yüksek efor.
• Agents SDK: Orkestrasyon kodu hazır ama sizin süreçinizde çalışıyor; çalışma ortamı ve kalıcılık hâlâ sizin sorununuz.
• Agents API: Harness OpenAI tarafında. Entegrasyon eforu en düşük, harness üzerindeki kontrol en az.

Fiyatlandırma ve beta kısıtları

Ek ücret yok. OpenAI’ın ifadesiyle “token, araç ve container süresi” için ödüyorsunuz. Model kullanımı seçtiğiniz modelin API fiyatından, OpenAI araçları kendi standart fiyatından, OpenAI barındırmalı sandbox’lar standart container ücretinden faturalanıyor.

Beta aşamasında iki kısıt var ve ikisi de kurumsal kullanım için kritik:

• Veri yerleşimi yalnızca ABD. Avrupa veya Türkiye’de veri yerleşimi şartı olan bir projede bugün kullanılamaz.
• Zero Data Retention desteklenmiyor. Üstelik kendi sandbox’ınızı çalıştırmanız da ZDR uygunluğu kazandırmıyor — harness OpenAI tarafında çalıştığı için.

LangChain ve CrewAI gibi çerçevelere ne oluyor?

Kısa cevap: hemen bir şey olmuyor, ama ağırlık merkezleri değişiyor. Agents API tek sağlayıcıya bağlı: modeliniz OpenAI, harness’ınız OpenAI, faturanız OpenAI. Çerçevelerin en güçlü savunma hattı da tam burası — sağlayıcı bağımsızlığı.

Ama iki yerde gerçek bir daralma var:

• Prototip katmanı: “Bir ajan kuralım, araç bağlayalım, çalıştıralım” işi artık tek çağrıyla yapılabiliyorsa, o iş için çerçeve kurmanın gerekçesi zayıflıyor.
• Altyapı katmanı: Kalıcı oturum, kurtarma ve sandbox yönetimi bugüne kadar çerçevelerin etrafında kurulan işletim yükünün önemli bir kısmıydı.

Alt ajan koordinasyonunun ve MCP desteğinin resmî API’ye girmesi, aynı yönde ilerleyen bir eğilimin parçası. Claude tarafında subagent yapısı benzer bir işi ajan tanımının içine gömüyor; fark, orada harness’ın hâlâ sizin makinenizde çalışması.

Kimler için mantıklı, kimler için erken

Mantıklı: Saatler süren kod, araştırma veya veri işleme görevlerini ürüne gömmek isteyen ekipler. Kendi harness’ını yazmayı göze alamayan küçük ekipler için kazanç büyük — bir haftalık altyapı işi, bir gün içinde kuruluyor.

Erken: Veri yerleşimi veya ZDR şartı olan kurumlar. Sağlayıcı bağımsızlığını mimari ilke olarak benimsemiş ekipler. Ajanın her adımını denetlemesi gereken, regülasyonlu alanlarda çalışanlar.

Unutulmaması gereken: public beta, üretim garantisi değil. client.beta.* ad alanı, imzanın değişebileceğini baştan söylüyor.

Sık sorulan sorular

Agents API ek ücretli mi?

Hayır. OpenAI, API için ayrı bir ücret olmadığını açıkça belirtiyor: token, araç kullanımı ve container süresi için ödüyorsunuz. Model kullanımı seçtiğiniz modelin normal API fiyatından faturalanıyor.

Agents API hangi modelle çalışıyor?

Dokümantasyondaki tüm örnekler gpt-6-astra modelini kullanıyor. Model, agent.model alanında belirtiliyor — yani ajan tanımının bir parçası, ayrı bir uç nokta seçimi değil.

Agents API Avrupa’da veya Türkiye’de kullanılabilir mi?

API’ye erişim açık, ancak veri yerleşimi beta süresince yalnızca ABD. Verinin AB veya Türkiye sınırları içinde kalmasını şart koşan bir projede bu hâliyle uygun değil. Zero Data Retention da desteklenmiyor.

Agents API ile Agents SDK arasındaki fark ne?

Agents SDK orkestrasyonu sizin çalışma ortamınızda yürütür; kalıcılık, kurtarma ve sandbox sizin sorumluluğunuzdadır. Agents API’de harness OpenAI tarafında çalışır, oturum kalıcıdır ve bağlam sıkıştırma otomatiktir. Entegrasyon eforu düşer, kontrol azalır.

Agents API kendi sunucumda çalıştırılabilir mi?

Sandbox tarafı evet: codex exec-server‘ı kendi altyapınızda çalıştırıp WebSocket ile bağlayabilirsiniz. Ancak harness’ın kendisi OpenAI’da kalır — bu yüzden kendi sandbox’ınızı kullanmak Zero Data Retention uygunluğu sağlamıyor.

Kaynaklar

• “Introducing the Agents API” — OpenAI, 10 Eylül 2026
• Agents API genel bakış ve API changelog — OpenAI geliştirici dokümantasyonu

Bu yazı 11 Eylül 2026’da, kaynakların o günkü hâli üzerinden yazıldı; public beta’daki bir API’nin imzası değişebilir. İlgili okumalar: Claude ile zamanlayıcı kullanımı, GPT-6 Astra ile yapılan Model X Studio projesi ve tarayıcı ajanlarının riskleri.