OpenAI
Bu sayfanın çevirisi otomatik olarak yapılmıştır. Orijinal İngilizce makaleyi görüntüleyin.

Assistants API (v2) SSS

Assistants API v2 özelliklerini, sınırlarını, fiyatlandırmasını ve Responses API'ye geçişi inceleyin.

Güncellenme zamanı: 5 days ago

11 Mart 2025 itibarıyla yeni Agents platformumuzun yapı taşlarını kullanıma sunduk. Ayrıntılar için Responses API’ye yönelik API dokümanlarımıza; Web Search, File Search ve Computer Use dahil Tools’a; ayrıca Agents SDK ve Tracing’e bakın. Assistants API beta için geri bildirimlerinize dayanarak, temel iyileştirmeleri Responses API’ye dahil ettik. Tam özellik eşitliğine ulaştıktan sonra, bu yılın ilerleyen dönemlerinde Assistants API için kullanımdan kaldırma planını duyuracağız; hedeflenen kapatma tarihi 2026’nın ilk yarısıdır.

SSS

Assistants API nedir?

Assistants API, geliştiricilerin uygulamalarında kolayca güçlü yapay zeka asistanları oluşturmasını sağlar. Bu API, konuşma geçmişini yönetme gereğini ortadan kaldırır ve Kod Çalıştırma Aracı ile Dosya Arama gibi OpenAI tarafından barındırılan araçlara erişim sağlar. API ayrıca üçüncü taraf araçlar için geliştirilmiş fonksiyon çağrısı desteği sunar.

Assistants API v1 beta sürümünü hâlâ kullanabilir miyim?

Hayır. Kullanıcılar, 18 Aralık 2024 itibarıyla Assistant API beta sürümünün v1 versiyonuna artık erişemiyor. Şu anda yalnızca v2'yi destekliyoruz. API çağrılarınızı v1'den v2'ye geçirmek için bu geçiş kılavuzuna göz atın.

Buna nasıl erişebilirim?

Assistants API, OpenAI API hesabı olan herkes tarafından kullanılabilir; ancak kullanım dışı bırakılmaktadır ve Ağustos 2026’da kaldırılacaktır. Yeni projelerde bunun yerine Responses API’yi kullanın. Assistants API’yi zaten kullanıyorsanız, Responses API’ye geçişinizi planlayın. API kullanılabilir kaldığı sürece, mevcut assistant’lara Assistants Playground’da erişmeye devam edebilirsiniz.

Asistan nedir?

Asistan, OpenAI modellerini kullanan, dosyalara erişebilen, kalıcı konuşma dizilerini sürdürebilen ve araçları çağırabilen, belirli bir amaç için geliştirilmiş bir yapay zekayı temsil eder.

Konuşma dizisi nedir?

Konuşma dizisi, bir asistan ile kullanıcı arasındaki sohbet oturumudur. Konuşma dizileri, mesaj geçmişini saklayıp konuşma modelin bağlam uzunluğunu aştığında bu geçmişi kırparak uygulama geliştirmeyi kolaylaştırır.

Dosya Arama aracı nedir?

file_search aracı, modelin yanıtlarını zenginleştirmek için dosyalarınızdan doğru verileri çıkarmanıza yardımcı olur. Bunun için bilgi getirme alanındaki çeşitli en iyi uygulamaları ek yapılandırma gerektirmeden uygular.

file_search aracı varsayılan olarak şu ayarları kullanır:

  • Parça boyutu: 800 token

  • Parçalar arası örtüşme: 400 token

  • Gömme modeli: 256 boyutlu text-embedding-3-large

  • Bağlama eklenen maksimum parça sayısı: 20

Dosya yükleme sınırları nelerdir?

Dosya yükleme sınırları şunlardır:

  • Dosya başına 512 MB

  • Dosya başına 5 milyon token

  • Vektör deposu başına 10 bin dosya

  • Asistan başına 1 vektör deposu

  • Konuşma dizisi başına 1 vektör deposu

Bir kuruluştaki her proje için toplam depolama sınırı 100 GB'tır.

Dosya Arama aracının sınırlamaları nelerdir?

Önümüzdeki aylarda destek ekleyerek gidermeye çalıştığımız, bilinen birkaç sınırlama var:

  1. Şu anda parçalara ayırma, gömme veya bilgi getirme ayarları değiştirilemiyor.

  2. Belgelerdeki görsellerin ayrıştırılması desteklenmiyor.

  3. Yapılandırılmış dosya biçimlerinden (.csv veya .jsonl dosyaları gibi) bilgi getirme desteklenmiyor. Desteklenen dosya türlerine bakın.

Assistants API'nin hız sınırları nelerdir?

Assistants API'nin hız sınırları, kullanım katmanına ve modele bağlı değildir. Bunun yerine, birkaç istisna dışında istek türüne göre varsayılan sınırlar uygulanır:

  • GET: Dakikada 1000 istek

  • POST: Dakikada 300 istek

  • DELETE: Dakikada 300 istek

API'deki Kod Çalıştırma Aracı nasıl ücretlendirilir?

Kod Çalıştırma Aracı, oturum başına 0,03 ABD doları olarak ücretlendirilir. Asistanınız Kod Çalıştırma Aracı'nı aynı anda iki farklı konuşma dizisinde çağırırsa iki Kod Çalıştırma Aracı oturumu oluşturulur (2 * 0,03 ABD doları). Her oturum varsayılan olarak bir saat boyunca etkin kalır. Yani kullanıcınız aynı konuşma dizisinde bir saate kadar Kod Çalıştırma Aracı'na talimat vermeye devam ederse bu ücreti yalnızca bir kez ödersiniz.

API'deki Dosya Arama nasıl ücretlendirilir?

Dosya Arama, vektör deposunda kullanılan alan için GB başına günlük 0,10 ABD doları olarak ücretlendirilir (ilk 1 GB depolama alanı ücretsizdir). Vektör deposunun boyutu, dosyanız ayrıştırılıp parçalara ayrıldıktan ve gömme vektörlerine dönüştürüldükten sonra oluşan boyuta göre belirlenir.

17 Nisan 2024'ten önce oluşturulan tüm vektör depoları 2024 sonuna kadar ücretsiz olacaktır. Bu tarihten sonra ise şu işlemlerden biri uygulanacaktır:

  • 17 Nisan 2024'ten sonra oluşturulan bir Run işleminde en az bir kez kullanılmışlarsa güncel tarifeye göre ücretlendirilirler (şu anda GB başına günlük 0,10 ABD doları).

  • 17 Nisan 2024 ile 31 Aralık 2024 arasında hiçbir Run işleminde kullanılmamışlarsa silinirler. Böylece bu fiyatlandırma değişikliği duyurulmadan önce oluşturmuş olabileceğiniz ancak hiç kullanmadığınız vektör depoları için ücret ödemezsiniz.

Oluşturabileceğim assistant sayısında bir sınır var mı?

Bir kuruluşun oluşturabileceği assistant sayısında bir sınır yoktur.

API'de akış desteği var mı?

Evet, Assistants API'de akış desteği vardır.

Assistants API'de JSON modu kullanılabilir mi?

Evet, Assistants API'de JSON modu, Assistants veya Run nesnelerindeki response_format parametresiyle kullanılabilir.

Assistants API, üçüncü taraf fonksiyon çağrılarına yönelik istekleri de yönetir mi?

Hayır. Fonksiyon çağrısı, modelin araçları seçmesini ve bu araçlara yönelik istekleri biçimlendirmesini sağlar. Ancak üçüncü taraf araçlara yapılan çağrıların yürütülmesini OpenAI yönetmez.

OpenAI'a gönderdiğim veriler nasıl işlenir?

Platformumuzun geri kalanında olduğu gibi, OpenAI API'ye gönderilen veriler ve dosyalar modellerimizi eğitmek için asla kullanılmaz ve verilerinizi istediğiniz zaman silebilirsiniz. Assistants API'ye yüklenen veriler, bir kullanıcı bunları manuel olarak silene kadar süresiz olarak saklanır.

DALL-E, Assistants API üzerinden kullanılabilir mi?

DALL-E şu anda kullanılamıyor.

Assistants API için bir kullanıcı arayüzü var mı?

Assistants API için Playground’a göz atabilirsiniz. Sol kenar çubuğunda Assistants görünümünde olduğunuzdan ve etkinleştirmek istediğiniz Tools ile uyumlu bir model kullandığınızdan emin olun.

Playground Assistants view editing MyQuickstartAssistant with gpt-3.5-turbo and Code interpreter enabled

Assistants API'de asistan talimatları için karakter sınırı nedir?

Asistan talimatları alanının maksimum uzunluğu 256.000 karakterdir.

Şuna benzer bir hata alıyorum: “Sunucu, isteğinizi işlerken bir hatayla karşılaştı. Bunun için üzgünüz! İsteğinizi yeniden deneyebilir veya hata devam ederse help.openai.com adresindeki yardım merkezimiz üzerinden bizimle iletişime geçebilirsiniz. ” Ne yapmalıyım?

Bu hatayı alıyorsanız prompt'unuz doğru yapılandırılmamış olabilir. İsteği tekrar tekrar denemenize rağmen başarısız oluyorsa şunları deneyebilirsiniz:

  1. Prompt'unuzu, fonksiyon benzeri komutların fonksiyon olarak ele alınmasını sağlayacak şekilde yeniden yapılandırın.

  2. Prompt'unuzdaki tüm komutları tools alanına fonksiyon olarak ekleyin.

Dosya Arama aracım neden iyi çalışmıyor?

Dosya Arama aracını kullanırken max_prompt_tokens değerini en az 20.000 olarak ayarlamanızı öneririz. Daha uzun konuşmalarda veya Dosya Arama ile birden çok etkileşimde bu sınırı 50.000'e çıkarmayı düşünebilirsiniz. En kaliteli sonuçlar için ideal olan, max_prompt_tokens sınırlarını tamamen kaldırmaktır.

Nasıl geri bildirim verebilirim?

Geri bildirimlerinizi Geliştirici Forumumuzda, help.openai.com adresindeki Yardım Merkezi üzerinden veya Twitter'da @OpenAIDevs hesabımıza iletmenizden memnuniyet duyarız.

Bu makale yararlı oldu mu?