OpenAI Agents API, Responses API, Agents SDK, AgentKit Karşılaştırması: Geliştirme İçin Hangisini Seçmeli?

Bu dört isim farklı katmanlarda yer alır ve tek bir soru onları ayırır: ajan döngüsünü kim çalıştırır? Yanıtlar API'si (Responses API) model çağrısıdır ve kodunuz onun etrafındaki döngüyü çalıştırır. Ajanlar SDK'sı (Agents SDK), çalıştırıcısı uygulamanızın içinde döngüyü yürüten bir TypeScript ve Python kütüphanesidir. 10 Eylül 2026'dan beri herkese açık beta sürümünde olan Ajanlar API'si (Agents API), OpenAI'nin Codex çalışma çerçevesini sizin için çalıştırır ve oturumu, isteğe bağlı olarak da sanal alanı korur. AgentKit, Ekim 2025'te çıkan Agent Builder, ChatKit, Bağlayıcı Kayıt Defteri (Connector Registry) ve Değerlendirmeler (Evals) paketidir ve Agent Builder'ın 30 Kasım 2026'da kapatılması planlanmaktadır.

29 Eylül'deki DevDay etkinliği, Ajanlar API'sine bilgisayar kullanımını ekledi (bkz. DevDay 2026 özeti), bu da isimlendirme sorusunu göz ardı etmeyi daha da zorlaştırdı. Aşağıda: döngü, hesaplama, durum, fiyat ve olgunluk üzerine yan yana bir karşılaştırma, bir karar tablosu ve elle yazılmış bir Yanıtlar döngüsünden geçiş yolu bulunmaktadır. Oturumlar ve onaylar hakkında uygulamalı bir inceleme için OpenAI Ajanlar API'si kılavuzunu okuyun. Hangisini seçerseniz seçin, HTTP yüzeyi Apidog'da test edilebilir.

OpenAI ajan seçenekleri yan yana

Kaynaklar: OpenAI'nin ajan çalışma zamanı karşılaştırması, Ajanlar API'si genel bakışı ve kullanımdan kaldırma sayfası.

Döngüyü kim çalıştırır

Diğer satırların çoğuna karar veren eksen budur.

Yanıtlar API'si (Responses API): siz çalıştırırsınız. Web araması, dosya araması, kod yorumlayıcı ve uzaktan MCP gibi barındırılan araçlar tek bir istek içinde birden fazla çağrı yapabilir, ancak kendi fonksiyonlarınız size geri döner. Model birini çağırdığında, bir function_call öğesi alırsınız, onu çalıştırırsınız ve bir sonraki istekte aynı call_id ile bir function_call_output gönderirsiniz. Ne zaman duracağınıza, geçmişi nasıl saklayacağınıza (yanıtlar varsayılan olarak saklanır; store: false bunu kapatır) ve context_management ve compact_threshold ile uzun bağlamları ne zaman sıkıştıracağınıza siz karar verirsiniz. Yanıtlar API'si kılavuzu ve fonksiyon çağırma kılavuzu bu döngüyü kapsar.

Ajanlar SDK'sı (Agents SDK): sizin süreciniz çalıştırır. OpenAI'nin belgeleri, SDK'nın çalıştırıcısının "ajan döngüsünü ve devir teslimlerini yönettiğini" belirtirken, sunucunuz dağıtıma, araç uygulamalarına, durum depolamasına ve onay kararlarına sahiptir. Sandbox Ajanları ile, komutlar Unix yerel, Docker veya barındırılan sağlayıcı çalışma alanında çalışırken, çalışma çerçevesi sizin altyapınızda kalabilir, böylece yetkilendirme, denetim günlükleri ve insan incelemesi kapsayıcı dışında kalır.

Ajanlar API'si (Agents API): OpenAI çalıştırır. Yönetilen çalışma çerçevesi oturumları, orkestrasyonu, bağlam sıkıştırmayı ve kurtarmayı yönetir ve alt ajanları, araç aramasını ve programatik araç çağırmayı ekler. Uzak MCP sunucuları doğrudan OpenAI tarafından çağrılır. Kodunuz hala fonksiyon araçlarını yönetir: oturum required_actions içinde bir function_call bildirdiğinde, turn_id ve call_id ile bir agent.session.input.tool_result olayı döndürürsünüz.

Aynı görev, iki şekilde:

# Yanıtlar API'si: tek model çağrısı; döngü sizin kodunuza aittir
curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "reasoning": {"effort": "low"},
    "tools": [{"type": "web_search"}],
    "input": "En son Node.js sürümündeki önemli değişiklikleri özetle."
  }'

# Ajanlar API'si: kalıcı bir oturum; döngü OpenAI'ye aittir
curl https://api.openai.com/v1/agents/sessions \
  -H "OpenAI-Beta: agents=v1" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {"model": "gpt-6-astra", "tools": [{"type": "web_search"}]},
    "environment": {"type": "none"},
    "input": "En son Node.js sürümündeki önemli değişiklikleri özetle."
  }'

Ajanlar API'si belgelerindeki örnekler gpt-6-astra kullanır; başka modellerin kabul edilip edilmediği belirtilmemiştir, bu yüzden gpt-6.1-sol ile değiştirmeden önce kontrol edin.

Hesaplama, durum ve maliyet

Hesaplama. Ajanlar API'si, tüm oturum için bir sanal alan sağlayabilir ve yönetebilir: environment.type değerini openai_hosted, self_hosted veya none olarak ayarlayın. SDK ile, sanal alan sağlayıcısını siz seçer ve ödersiniz. Yanıtlar (Responses) ile kod, barındırılan araçlar dışında, sizin çalıştırdığınız yerde çalışır.

Durum. Bir Ajanlar API'si oturumu, OpenAI tarafında yapılandırma, dönüşler ve öğeleri tutar, bu nedenle bir takip, aynı oturum kimliği üzerinde tek bir olaydır. Yanıtlar ile previous_response_id zincirini kullanırsınız veya Konuşmalar (Conversations) API'sini kullanırsınız. SDK ile durum, kendi depolamanızda veya SDK oturumlarında yaşar.

Maliyet. Her seçenek aynı modelleri çağırdığı için token fiyatları her yerde aynıdır. Ajanlar API'si "ek ücret" talep etmez, ancak barındırılan kapsayıcılar 20 dakikalık oturum başına 0,03 dolardan (1 GB) 0,48 dolara (16 GB) kadar maliyetlidir. SDK'nın ek maliyeti kendi barındırmanızdır. AgentKit açıklayıcımıza göre AgentKit'in ayrı bir aboneliği yoktur.

Veri. Ajanlar API'si yalnızca ABD veri yerleşimini destekler ve kendi kendine barındırılan bir sanal alanla bile Sıfır Veri Saklama (ZDR) özelliğini desteklemez. OpenAI'nin veri kontrolleri sayfası, /v1/agents'ı ZDR'ye uygun değil olarak listeler, silinene kadar durum korunur; oysa /v1/responses sınırlamalarla ZDR'ye uygundur ve eu.api.openai.com gibi bölgesel uç noktalarda mevcuttur. Eğer ZDR veya AB yerleşimi bir gereksinimse, bu durum Ajanlar API'sini bugün için devre dışı bırakır.

2026'nın sonlarında AgentKit: geriye ne kaldı

AgentKit, 6 Ekim 2025'te dört parça halinde piyasaya sürüldü. İşte her birinin durumu:

• Agent Builder: 3 Haziran 2026'da kullanımdan kaldırılacağı duyuruldu; 30 Kasım 2026'da kapatılması planlanıyor. OpenAI'nin geçiş kılavuzu, bir iş akışını Ajanlar SDK'sı kodu olarak dışa aktarır veya Business, Enterprise veya Edu'da bir ChatGPT Çalışma Alanı Ajana olarak yeniden oluşturur.
• Evals: Mevcut değerlendirmeler 31 Ekim 2026'da salt okunur hale gelecek ve kontrol paneli ile API'nin 30 Kasım'da kapatılması planlanıyor.
• ChatKit: Gömülü sohbet için kullanılabilir kalır.
• Connector Registry: OpenAI ürünleri genelindeki bağlayıcılar ve MCP sunucuları için yönetici paneli.

AgentKit kılavuzumuzun belirttiği gibi, AgentKit aracılığıyla kalıcı, kod öncelikli yol Ajanlar SDK'sıdır.

Hangisini temel almalı

AWS'de, OpenAI destekli Bedrock Yönetilen Ajanlar, Ajanlar API'sinin temel yeteneklerini AWS'de yerel olarak çalıştırmak için getiriyor. Her iki kod öncelikli yolda da MCP bağlantısı için OpenAI ajanları ile MCP sunucuları bölümüne bakın.

Kendi Yanıtlar döngünüzden Ajanlar API'sine geçiş

Yanıtlar üzerinde bir döngü oluşturduysanız ve OpenAI'nin bunu çalıştırmasını istiyorsanız:

1. Parçaları eşleştirin. Talimatlar, model ve araçlar agent içine taşınır; kapsayıcınız environment olur; konuşma depolama alanınız bir oturum kimliği haline gelir.
2. Uzak MCP sunucularını agent.tools içine taşıyın. Token'larını komut istemlerine değil, vault_ids ile eklenmiş bir kasaya koyun.
3. Fonksiyon işleme bölümünü yeniden yazın. function_call_output döngünüzü, agent.session.requires_action (akış) veya agent.session.action_required (webhook) için bir işleyiciyle değiştirin; bu işleyici turn_id ve call_id ile bir agent.session.input.tool_result döndürür. Alt ajanlar fonksiyon araçlarını çağıramaz, bu yüzden bunları ana ajanda tutun.
4. Sıkıştırma kodunuzu silin. Çalışma çerçevesi bağlamı otomatik olarak sıkıştırır.
5. Olaylara geçin. Dönüş sonuçlarını yayınlayın (agent.session.turn.completed, agent.session.turn.failed, agent.session.turn.cancelled) veya webhook'ları kullanın. Boşta bir oturum başarı anlamına gelmez.
6. Kısıtlamaları kontrol edin. Yalnızca ABD yerleşimi, ZDR yok ve bir beta başlığı.

Her ikisini de tek bir Apidog projesinde tutun

Geçiş yapmadan önce eski ve yeni sürümleri yan yana çalıştırın. Tek bir Apidog projesinde, {{OPENAI_API_KEY}} ve bir model değişkeni içeren bir ortamı paylaşan bir Responses klasörü ve bir Agents API klasörü oluşturun. Aynı komut istemlerini her ikisi üzerinden gönderin, durum kodları ve gerekli çıktı alanları üzerinde doğrulama yapın ve dönüş olaylarını izlemek için Ajanlar API'si akışını bir SSE isteği olarak açın. Çalıştırmaları bir test senaryosu olarak kaydedin ve Apidog CLI ile CI'da çalıştırın, böylece bir beta değişikliği başarısız bir kontrol olarak ortaya çıksın. Üretim yapay zeka ajanı güvenilirlik kılavuzu neyin doğrulanacağını kapsar. Kurulum için Apidog'u indirin.

Sıkça Sorulan Sorular

Ajanlar API'si Yanıtlar API'sinin yerini mi alıyor? Herhangi bir kullanımdan kaldırma duyurusu yapılmadı. OpenAI'nin ajanlar genel bakışı, Ajanlar API'si, Ajanlar SDK'sı ve Yanıtlar API'sini farklı ihtiyaçlar için mevcut seçenekler olarak listeler.

OpenAI AgentKit kullanımdan kaldırıldı mı? Kısmen. Agent Builder ve Evals'ın 30 Kasım 2026'da kapatılması planlanıyor; ChatKit kullanılabilirliğini sürdürüyor.

Ajanlar SDK'sı Ajanlar API'sini kullanıyor mu? Hayır. SDK uygulamanızda çalışır; Ajanlar API'si OpenAI'nin hizmetinde yönetilen bir çalışma çerçevesini çalıştırır.

Asistanlar API'sine ne oldu? OpenAI'nin kullanımdan kaldırma sayfası, kaldırılmasını 26 Ağustos 2026 olarak belirledi ve geliştiricileri Yanıtlar ve Konuşmalar API'lerine yönlendiriyor.

Hangi seçenek daha ucuz? Token fiyatları hepsi arasında aynıdır. Fark, Ajanlar API'sindeki barındırılan kapsayıcılar ile SDK veya Yanıtlar ile kendi barındırmanız arasındadır.

Bu hafta bir yol seçin

Döngüyü kimin çalıştırması gerektiğine göre seçin, ardından bir uygulama yazmadan önce isteklerle kanıtlayın. Yeni başlıyorsanız, bir Ajanlar API'si oturumunu deneyin ve çıktısını Apidog'da mevcut Yanıtlar kurulumunuzla karşılaştırın.