OpenAI Agents API: bilgisayar kullanımı, fiyatlar ve Decisions API

👁 118 okunma

OpenAI Agents API, DevDay 2026’da bilgisayar kullanımı (computer use) özelliği kazandı: Ajan, OpenAI bulutunda bir tarayıcı açıp görevini tamamlamak için web sitelerinde kendi başına gezinebiliyor. Bunun yanında, önceden belirlenmiş bir yanıt listesinden çok hızlı seçimler yapan Luna modelini kullanan Decisions API duyuruldu. Amazon da aynı motoru Bedrock Managed Agents olarak sunmaya başladı. Nasıl çalıştıklarını, dolar cinsinden maliyetlerini ve güvenlik risklerini açıklıyorum. Kod örnekleri resmî belgelerden alınmıştır. Decisions API’nin açık kaynaklı alternatifleri Cloudflare Clef ve AWS Strands Decider’ı Yapay zekâ karar modelleri rehberinde test ettim.

OpenAI Agents API nedir?

OpenAI, Agents API’yi 10 Eylül 2026’da herkese açık beta olarak kullanıma sundu. API, Codex’in kullandığı altyapı üzerine kurulu: OpenAI ajan döngüsünü yönetiyor, oturumları kontrol ediyor, sınır yaklaşınca önceki bağlamı özetliyor ve aradan sonra çalışmayı sürdürüyor. Uygulamanız görevi gönderiyor ve olayları alıyor. DevDay 2026’da (29 Eylül) bilgisayar kullanımı eklendi; Codex’in çok ajanlı özellikleri, araç arama (tool search) ve araçları koddan çağırma da API’ye geldi. Etkinlikteki duyuruların tamamı için OpenAI DevDay 2026 canlı yayın özetimize göz atabilirsiniz.

Belgelerde dört temel kavram açıklanıyor:

• Ajan - model, talimatlar, araçlar ve MCP sunucuları.
• Ortam - isteğe bağlı sandbox veya bilgisayar. OpenAI tarafından barındırılabilir, size ait olabilir ya da bir iş ortağının (Cloudflare, E2B, Modal, Daytona veya Vercel gibi) altyapısında çalışabilir.
• Oturum - art arda yeni görevler alabilen kalıcı bir ajan örneği.
• Olaylar ve öğeler - ajana gönderdikleriniz ve çalışma sırasında ajanın döndürdükleri.

OpenAI sandbox’ı; Python, Node.js ve komut satırı araçlarını içeren bir Linux ortamıdır. Üç boyutu vardır: small (1 vCPU, 1 GB), medium (2 vCPU, 4 GB, varsayılan) ve large (4 vCPU, 16 GB). Ağ erişimini açabilir, kapatabilir veya 1-100 alan adından oluşan bir listeyle sınırlandırabilirsiniz. Bir saat boyunca etkinlik ya da ortamı canlı tutan sinyal gönderilmezse sandbox silinebilir.

İlk ajan: belgedeki Python kodu

Aşağıdaki örnek, resmî hızlı başlangıç rehberinden (Python) değiştirilmeden alınmıştır. Ajan, sandbox içinde tree.py adlı bir betik oluşturuyor, çalıştırıyor ve çıktıyı gösteriyor. API anahtarının api.agents.read, api.agents.write ve api.responses.write izinlerine sahip olması gerekir. Bu örneği kendi hesabımda çalıştırmadım.

from openai import OpenAI

with OpenAI() as client:
    with client.beta.agents.sessions.create(
        agent={
            "model": "gpt-6-astra",
            "instructions": "Temiz kod yaz, çalıştır ve gerçek çıktıyı bildir.",
        },
        environment={"type": "openai_hosted"},
        input="Geçerli dizindeki dosyaları okunaklı bir ağaç biçiminde yazdıran tree.py adlı bir Python betiği oluştur. Betiği çalıştır ve çıktıyı göster. (Bu, Lehçe olarak test edilmiş özgün istemin Türkçe çevirisidir; Türkçe olarak yeniden test edilmemiştir.)",
        stream=True,
    ) as events:
        for event in events:
            print(event.to_json(indent=None), flush=True)

Kaynak: Agents API hızlı başlangıç rehberi. cURL isteklerine OpenAI-Beta: agents=v1 başlığını eklemeniz gerekir; SDK’lar bunu otomatik yapar.

Computer use: ajan tarayıcıyı nasıl kullanıyor?

Ajana tarayıcı erişimi vermek için belgelere göre araçlara {"type": "computer_use"} eklemeniz ve masaüstü etkinleştirilmiş bir openai_hosted ortamı ayarlamanız gerekir. Tarayıcı sizin bilgisayarınızda değil, OpenAI ortamında çalışır. Böyle bir oturum oluşturan belge örneği (görev çalıştırılmadan):

session = client.beta.agents.sessions.create(
    agent={
        "model": "gpt-6-astra",
        "instructions": "Tarayıcıda herkese açık belgeleri oku. Oturum açma veya herhangi bir web sitesi verisini değiştirme. Bulduğun sayfa başlığını ve URL'yi bildir.",
        "tools": [{"type": "computer_use", "include_screenshots": True}],
    },
    environment={
        "type": "openai_hosted",
        "desktop": {"enabled": True},
        "network": {"access": "enabled"},
    },
)
print("Oturum kimliği:", session.id, flush=True)

Sonraki adımda uygulama olay akışını açıyor, görevi gönderiyor (agent.session.input.message olayı) ve onay isteklerini işliyor. Tarayıcıdaki her işlem, durum ve isteğe bağlı ekran görüntüsü içerebilen bir computer_use_call öğesi olarak kaydediliyor. Ekran görüntüleri hesap verileri içerebileceği için API yanıtlarında varsayılan olarak devre dışı.

OpenAI’nin özetine göre bilgisayar kullanımı API üzerinden; Codex ve ChatGPT Work içinde ise Pro 500 ve Enterprise planlarında kullanılabiliyor. Uygulamadaki aynı özelliği Codex bulut yazısında ele alıyorum.

Güvenlik: bilgisayara erişimi olan ajan

OpenAI, DevDay’den bir gün önce GPT-6.1 Astra’nın lansmanını durdurduanalizde, dokuz olayın altısı sürekli gözetim olmadan çalışan ajanlarla ilgiliydi. Bu nedenle computer use belgelerinde belirtilen sınırları bilmek önemli:

• Her alan adı için onay gerekir. Tarayıcı, herkese açık olsa bile her yeni adres (origin) için onay ister. Ağ erişimini etkinleştirmek bu gerekliliği ortadan kaldırmaz.
• Alan adına verilen onay, işlem onayı değildir. Belgeler, bir alan adını onaylamanın satın alma veya veri silme gibi işlemlerden önce ayrıca onay istenmesini zorunlu kılmadığı konusunda açıkça uyarıyor. Böyle bir onaya ihtiyacınız varsa tarayıcıyı bu işlemlere izin vermeyen kaynaklarla sınırlandırın veya kendi ortamınızı kullanın.
• Web sayfalarının içeriği güvenilmezdir. Bir web sayfası ajana yeni izinler veremez veya kullanıcının talimatlarını geçersiz kılamaz.
• Parolalar modelin dışında tutulur. Oturum açma işlemi ayrı bir olay üzerinden gerçekleşir; girilen değerler model girdisine veya oturum geçmişine eklenmez. Oturum açma işlemini yalnızca ana ajan yapabilir, alt ajanlar yapamaz. Passkey ve QR koduyla oturum açma desteklenmiyor.

Belgedeki örnek işlev, kullanıcıya her alan adı için onay soruyor ve varsayılan olarak isteği reddediyor (“default: deny”); oturum açma isteklerini ise iptal ediyor. Bu benim değerlendirmem: Yeni bir siteye kendi başına giremeyen bir ajanın hata yapabileceği alan çok daha dar olduğu için bu, üretim ortamlarında kullanmak için iyi bir varsayılan yaklaşım.

OpenAI Agents API fiyatları

OpenAI, Agents API’nin kendisi için ücret almıyor. Seçtiğiniz modelin token kullanımı, araçların kendi tarifeleri ve konteyner tarifesine göre sandbox için ödeme yapıyorsunuz. Fiyat listesinde computer use için ayrı bir kalem bulamadım. Vergiler hariç standart milyon token fiyatları (272 bin token’a kadar bağlam):

Fiyat listesine göre uygun konteyner oturumları dakika başına ücretlendiriliyor; en az 5 dakika üzerinden hesaplanıyor. Hız önceliğinizse GPT-6 Astra için Ultrafast modu da var: milyon token başına 60 USD giriş ve 300 USD çıkış.

Decisions API: Luna ile hızlı kararlar

Decisions API, geliştiricinin belirlediği soruları önceden tanımlı bir yanıt listesinden seçim yaparak yanıtlıyor. Bağlamı metin veya görsel olarak verebilirsiniz. Çıktı; içerikleri sınıflandırmak, talepleri yönlendirmek ya da bir ajanın sonraki adımını seçmek için kullanılabiliyor. The New Stack’e göre API, güven puanlarıyla birlikte yanıtları 150 ms’de döndürüyor; standart GPT-6 Luna’da bu süre 1,6 saniye. The Decoder, OpenAI’nin hızın on katına çıktığını belirttiğini aktarıyor.

29 Eylül itibarıyla API sınırlı önizlemedeydi; geniş çaplı kullanımın “önümüzdeki günlerde” başlaması bekleniyordu. Herkese açık belge veya fiyat listesi bulunmadığından kod örneği paylaşmıyorum. Endpoint adlarını tahmin etmeyeceğim. Bu, daha önce TypeSafe Jev ve System One yazısında ele aldığım TypeSafe Jev ile aynı model sınıfında.

Amazon Bedrock Managed Agents

OpenAI tarafından desteklenen Amazon Bedrock Managed Agents, Agents API’nin AWS sürümüdür. OpenAI’nin ajan altyapısı ve modellerin çıkarımı Amazon Bedrock’ta çalışırken talimatlar ve araçlar AgentCore Runtime ya da kendi altyapınız üzerinden yürütülüyor. Kimlik doğrulama OpenAI anahtarıyla değil, IAM ve SigV4 imzalarıyla yapılıyor. AWS, verilerin AWS dışına çıkmadığını ve hizmetin sınırlı önizlemede olduğunu belirtiyor. OpenAI, ortak kavramların API’lerin aynı olduğu anlamına gelmediğini özellikle vurguluyor; bu nedenle OpenAI belgelerindeki örnekleri birebir kullanamazsınız. Bölgeleri, sınırları ve fiyatları AWS’den kontrol edin.

Sık sorulan sorular

Agents API’nin fiyatı ne kadar?

API’nin kendisi ücretsiz. OpenAI’nin fiyat listesine göre model token’ları (örneğin GPT-6.1 Sol için milyon giriş token’ı başına 2 USD, milyon çıkış token’ı başına 10 USD), araçlar ve konteynerler için ödeme yaparsınız.

Agents API, Zero Data Retention’ı destekliyor mu?

Hayır. Belgelerde Agents API’nin verileri yalnızca ABD’de tuttuğu ve kendi sandbox’ınızı kullansanız bile ZDR kapsamında olmadığı belirtiliyor.

Computer use kullanan bir ajan kendi başına alışveriş yapabilir mi?

Web sitesi buna izin veriyorsa yapabilir. Onay alan adı için geçerlidir, tek tek işlemler için değil. Bu nedenle OpenAI, tarayıcı erişimini sınırlandırmanızı veya onay adımları içeren kendi ortamınızı kullanmanızı öneriyor.

Decisions API ne zaman herkesin kullanımına açılacak?

OpenAI, geniş çaplı kullanıma sunumun önümüzdeki günlerde başlayacağını duyurdu. 29 Eylül 2026’da API sınırlı önizlemedeydi ve fiyat listesi yoktu.

// okumaya devamGPT-6.1 Terra bilgisayar kullanımı: Form doldurma testiKarşılaştırmalarPictory nasıl kullanılır? Video oluşturma ve fiyatlarYapay zekâ araçlarıOpenAI, ChatGPT’nin 1 milyar kullanıcıya ulaşan depolama altyapısını nasıl ölçekledi?Dergi