Ana içeriğe atla
OpenAI

10 Eylül 2026

ÜrünAPI

Agents API'yi kullanıma sunuyoruz

OpenAI'ın tamamen yönettiği Codex düzeneğiyle bulut ajanları geliştirip çalıştırın.

Yükleniyor...

Codex'i ve ChatGPT Çalışma'yı dünya çapında milyonlarca kişiye ulaştırırken, uzun süre çalışan ajanların pratikte iyi çalışması için neler gerektiğini öğrendik. Kullanışlı ajanlar; bağlamı yöneten, araçları verimli kullanan ve alt ajanları koordine eden güçlü bir düzeneğe ihtiyaç duyar. Ayrıca günlerce güvenilir biçimde çalışmalarını sağlayan ve dosyalarla çalışabilecekleri, kod çalıştırabilecekleri ve ara sonuçları kaydedebilecekleri ortamlar sunan bir altyapıya ihtiyaçları vardır.

Bugün, Codex'in temelindeki düzeneği ve altyapıyı basit ve esnek bir API aracılığıyla geliştiricilere sunan Agents API⁠(yeni bir pencerede açılır)'yi herkese açık beta sürümüyle kullanıma açıyoruz.

Müşterilerimiz Agents API hakkında ne diyor?

1 / 8
“Agents API ile değerlendirme puanımız 0,71’den 0,85’e yükseldi. API’deki alt ajan desteği harika ve iş akışımızı büyük ölçüde hızlandırdı. Eski düzenimizde alt ajanları gözlemlemek ve koordine etmek oldukça zahmetliydi, ancak yeni API’ler gecikmeyi 4 kat azalttı. Bunu optimize etmek için uzun süre uğraştık; kullanıma hazır sunulan alt ajan akışları performansımızı muazzam ölçüde artırdı.”
Jack Weissenberger, CTO, Ciridae

Tek bir API çağrısıyla bulut ajanları geliştirin

Agents API ile görevi, modeli, araçları ve ortamı belirterek tek bir API çağrısıyla canlı ortamda kullanıma hazır bir ajan oluşturabilirsiniz:

JavaScript

1
import OpenAI from "openai";
2

3
const client = new OpenAI();
4

5
const session = await client.beta.agents.sessions.create({
6
agent: {
7
model: "gpt-6-astra",
8
tools: [
9
{
10
type: "mcp",
11
server_label: "observability",
12
transport: {
13
type: "http",
14
server_url: "https://observability.example.com/mcp",
15
},
16
},
17
],
18
multi_agent: { enabled: true, max_concurrent_subagents: 3 },
19
},
20
vault_ids: ["vault_YOUR_VAULT_ID"],
21
environment: {
22
type: "openai_hosted",
23
capability_directories: ["/workspace/capabilities/skills"],
24
},
25
input:
26
"Investigate service-api’s elevated 5xx rate over the last 30 minutes. " +
27
"Delegate deployment, error, and dependency analysis to subagents. " +
28
"Save findings, evidence, and recommended mitigation in /workspace/outputs.",
29
});

Düzeneği OpenAI barındırır ve bakımını üstlenir. Ajanın çalışacağı bilgi işlem ortamını siz seçersiniz: OpenAI tarafından yönetilen bir sandbox, kendi altyapınız veya sandbox iş ortaklarımızdan birinin sunduğu ortam. Agents API, optimize edilmiş ajan düzeneğimiz ve altyapımız üzerinde ajanlar geliştirmeniz için güçlü bir temel sunar. Böylece ajanınızı benzersiz kılan araçlara, bilgilere ve iş akışlarına odaklanabilirsiniz.

Bir uygulama, Agents API’ye görevler gönderir ve olaylarla çıktıları alır. Agents API, yönetilen Codex düzeneğini çalıştırır; araç çağrılarını korumalı alana gönderir ve araç sonuçlarını alır. Uygulama, kendi barındırdığı işlem kaynaklarını denetler.

Agents API, ajanlarınıza Codex’in temelindeki düzenek ve altyapıyla güç verir.

Ajan ortamınızı seçin

Farklı iş yükleri, farklı bilgi işlem, depolama ve dağıtım seçenekleri gerektirir. Agents API, uygulamanıza uygun bir sandbox seçmenize olanak tanır.

Çeşitli ihtiyaçlara yönelik birinci sınıf entegrasyonlar sunmak için Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop ve Vercel dahil olmak üzere ekosistem sağlayıcılarıyla iş ortaklığı yapıyoruz⁠(yeni bir pencerede açılır):

  • Tamamen yönetilen ortamlar veya VPC'niz içinde dağıtımlar

  • Belirli dosya ve gizli bilgi depolama mekanizmaları

  • Şirketinizin iş akışına uygun performans, soğuk başlatma ve maliyet profillerine sahip farklı CPU, GPU ve bellek yapılandırmaları.

Korumalı alan iş ortakları: Modal, Cloudflare, Daytona, Blaxel, Runloop, Vercel, Oracle, E2B ve DigitalOcean.

Agents API, popüler ekosistem sağlayıcılarıyla birinci sınıf entegrasyonlar sunar.

OpenAI tarafından barındırılan sandbox'lar

Hızla başlamak ve verimli biçimde ölçeklenmek isteyen geliştiriciler için OpenAI tarafından barındırılan sandbox⁠(yeni bir pencerede açılır)'ı da kullanıma sunuyoruz. Bu sandbox, Codex ve ChatGPT'nin kullandığı sandbox altyapısından yararlanır.

OpenAI, sandbox'ı hazırlar ve yönetir; ajanınıza kod çalıştırabileceği, dosyalarla çalışabileceği ve çıktılar üretebileceği güvenli ve yüksek performanslı bir ortam sunar. Bu sandbox'lar, ajana görevi tamamlamak için gerekenleri sağlamak üzere dosyalarınız, paketleriniz, becerileriniz ve eklentilerinizle esnek biçimde yapılandırılabilir.

Sürekli gelişen Codex düzeneğiyle geliştirin

Yeni model yeteneklerinden yararlanmak çoğu zaman düzeneğinizi yeniden düzenlemenizi gerektirir ve uygulamanızı geliştirmeye ayırabileceğiniz değerli zamanı alır. Agents API, her yeni modelin kullanıma sunulmasıyla bu yeteneklere sürümlendirilmiş erişim sağlar. Düzeneği modellerimizle birlikte yönetip sürekli geliştirerek ajanlarınızın her yükseltmede daha yüksek performans göstermesine yardımcı oluyoruz. Örneğin, düzenekte yakın zamanda yapılan iyileştirmeler şunlardır:

Ajanların uzun oturumlar boyunca çalışmasını sağlayın

Modellerin saatlerce çalışmasını desteklemek için ajanların ilgili bilgileri daha uzun oturumlar boyunca korumasına yardımcı olan bir bağlam yönetimi geliştirdik. Bir oturum bağlam sınırına yaklaştığında Agents API, önceki bağlamı otomatik olarak yoğunlaştırır⁠(yeni bir pencerede açılır) ve ajanın devam etmek için ihtiyaç duyduğu bilgileri korur. Geliştiriciler, kendi bağlam yoğunlaştırma mantıklarını uygulamadan birden fazla bağlam kapasitesine yayılan iş akışları oluşturabilir.

Ajanların daha fazla aracı verimli kullanmasına yardımcı olun

Agents API, ajanların doğru araçları bulup verimli biçimde kullanmasına yardımcı olur. Araç arama⁠(yeni bir pencerede açılır), ilgili araç tanımlarını gerektiğinde yükleyerek modelin önbelleğini korurken token kullanımını ve maliyeti azaltmaya yardımcı olur. Araçlar kullanılabilir olduğunda programatik araç çağırma⁠(yeni bir pencerede açılır), ajanların çağrıları paralel yürütmesine, ilgili işlemleri zincirlemesine ve sonuçları kod içinde filtrelemesine veya birleştirmesine olanak tanır. Böylece yalnızca ilgili sonuçları bağlama geri getirerek büyük miktarda veriyi işleyebilirler. Agents API; MCP'yi, özel işlevleri ve web araması gibi yerleşik araçları destekler.

JSON

1
"agent": {
2
"tools": [
3
{
4
"type": "mcp",
5
"server_label": "openai_docs",
6
"transport": {
7
"type": "http",
8
"server_url": "https://developers.openai.com/mcp"
9
}
10
},
11
]
12
}

Ajanların işi alt ajanlarla paralel yürütmesini sağlayın

Agents API, çoklu ajan desteği⁠(yeni bir pencerede açılır) sayesinde karmaşık görevleri bağımsız parçalara ayırıp paralel çalışan alt ajanlara devredebilir. Her alt ajan kendi bağlamını koruyarak görevine odaklanırken ana ajan çalışmalarını koordine eder ve sonuçları bir araya getirir. Bu özellik, kendi orkestrasyonunuzu oluşturmanızı gerektirmeden paralel çalışmadan yararlanan araştırma, analiz ve kodlama görevlerini hızlandırabilir.

JSON

1
"agent": {
2
"model": "gpt-6-astra",
3
"multi_agent": {
4
"enabled": true,
5
"max_concurrent_subagents": 3,
6
}
7
}

Açık kaynaklı temel

Agents API, açık kaynaklı Codex düzeneğinden güç alır ve geliştiricilerin model çağrılarını, araçları ve bağlamı koordine eden temel mantığı görmesini sağlar. Agents API ile bu düzeneği OpenAI işletip yönetirken geliştiriciler de düzeneğin herkese açık kod tabanını⁠(yeni bir pencerede açılır) inceleyip ondan öğrenebilir.

Geliştirmeye başla

Agents API, bugünden itibaren herkese açık beta sürümüyle tüm geliştiricilerin kullanımına sunuluyor. Agents API kullanımı için ek ücret alınmaz. Yalnızca ajanlarınızın kullandığı token'lar ve araçlar için fiyatlandırma sayfamızda⁠(yeni bir pencerede açılır) belirtildiği şekilde ödeme yaparsınız.

Daha fazla bilgi edinmek için Agents API'ye genel bakış sayfasını⁠(yeni bir pencerede açılır) inceleyin ya da Codex'in temelindeki düzeneği kendi ajanlarınızda kullanmaya başlamak için hızlı başlangıç kılavuzunu⁠(yeni bir pencerede açılır) izleyin.

Genel kullanıma sunmaya hazırlanırken, herkese açık beta sürecinde geri bildirimleriniz doğrultusunda Agents API'yi hızla geliştirmeye devam edeceğiz. Nelerin iyi çalıştığını, nerelerde zorluk yaşadığınızı ve ajanlarınızı geliştirip canlı ortamda çalıştırmak için nelere ihtiyaç duyduğunuzu bize bildirin.

Yazar

OpenAI