Genel bakış

Agents API, beta sürümüyle kullanıma sunulmuştur. Geliştiricilerin, birden çok adımda çalışabilen ve aynı oturumda çalışmaya devam edebilen, OpenAI tarafından yönetilen bir Codex ajanıyla uygulamalar geliştirmesini sağlar.

Görevi, araçları ve yapılandırmayı uygulamanız sağlar. Ajanın oturumunu ve modeli ile araçları arasındaki koordinasyonu OpenAI yönetir.

Bir ajan neler yapabilir?

Bir ajan, araçlarına ve yürütme ortamına bağlı olarak kod çalıştırabilir, dosyaları düzenleyebilir, MCP bağlantılarını kullanabilir ve uygulamanız için dosyalar oluşturabilir. Aynı oturumda ek talimatlar gönderebilir veya başka bir görevle devam edebilirsiniz.

Desteklenen özellikler ve örnekler için Agents API’ye genel bakış sayfasına bakın.

Nasıl başlayabilirim?

1. OpenAI Platform projenizde bir uygulama API anahtarı oluşturun. Oturumlar için api.agents.read ve api.agents.write, model istekleri için de api.responses.write izinlerini verin.

2. Bir ajan yapılandırmak, oturum oluşturmak ve görev göndermek için hızlı başlangıç kılavuzunu izleyin.

3. İlerlemeyi ve sonuçları incelemek için oturumun olaylarını takip edin. Çalışmaya devam etmek istiyorsanız oturum kimliğini kaydedin.

API anahtarınızı ajanın korumalı alanının dışında tutun. İsteklerde OpenAI-Beta: agents=v1 başlığı gereklidir. OpenAI SDK’ları bu başlığı otomatik olarak ekler.

Ajanımın korumalı alana ihtiyacı var mı?

Göreve uygun ortamı seçin:

• Ortam yok: Ajan, yerleşik kabuk komutlarına veya çalışma alanı dosyalarına ihtiyaç duymadan soruları yanıtlar ya da harici araçları kullanır.

• OpenAI tarafından barındırılan korumalı alan: Ajanın betik çalıştırması veya dosyalarla çalışması gerekir ve korumalı alanını OpenAI’ın yönetmesini istersiniz.

• Kendi barındırdığınız korumalı alan: Kendi altyapınıza, yazılımınıza veya özel ağınıza ihtiyaç duyarsınız. Ortamın yaşam döngüsünü uygulamanız yönetir.

Yapılandırma ayrıntıları için Agents API mimarisi sayfasına bakın.

Bir oturumu nereden inceleyebilirim?

Platform panosundaki Günlükler bölümünü açın, Ajanlar seçeneğini seçin ve oturum kimliğini arayın. Turları, araç çağrılarını ve alt ajan etkinliklerini inceleyebilirsiniz.

Gözlemlenebilirlik kılavuzunda, kaydedilen token kullanımının nasıl inceleneceği de açıklanır.

Olay akışının bağlantısı kesilirse ne yapmalıyım?

Yeniden denemeden önce mevcut oturumu ve kaydedilmiş öğelerini alın. Bu, yeni işler göndermeden önce neler olduğunu kontrol etmenize yardımcı olur.

Bir turun tamamlanması, tüm araçların başarıyla çalıştığı anlamına gelmez. Bildirilen sonucu inceleyin. Bir oturumun boşta olması, tek başına görevin başarıyla tamamlandığını göstermez.

Kullanım nasıl faturalandırılır?

Model istekleri için seçilen modelin API ücretleri uygulanır. OpenAI araçları ve OpenAI tarafından barındırılan korumalı alanlar için ilgili araç ve konteyner ücretleri uygulanır.

Güncel ücretler için API fiyatlandırması sayfasına bakın.

Oturum verileri ve dosyaları nasıl yönetilir?

Agents API, çalışmanın turlar boyunca sürdürülebilmesi için oturum durumunu saklar. Artık ihtiyaç duymadığınız oturumları ve yayımlanmış çıktıları silebilirsiniz. Bir oturumu silmeden önce ihtiyacınız olan dosyaları kaydedin.

Agents API şu anda yalnızca Amerika Birleşik Devletleri’nde veri yerleşimini destekler. Kendi barındırdığınız bir korumalı alan kullansanız bile sıfır veri saklamayı desteklemez. Veri denetimleriyle ilgili ayrıntılar için Agents API belgelerine bakın.