Assistants API (v2) SSS

Assistants API nedir?

Assistants API, geliştiricilerin uygulamaları içinde güçlü yapay zekâ asistanlarını kolayca oluşturmasını sağlar. Bu API, konuşma geçmişini yönetme gereksinimini ortadan kaldırır ve Kod Çalıştırma Aracı ile File Search gibi OpenAI tarafından barındırılan araçlara erişim ekler. API ayrıca 3. 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. 18 Aralık 2024 itibarıyla kullanıcılar artık Assistant API beta sürümünün v1 versiyonuna erişemiyor. Şu anda yalnızca v2'yi destekliyoruz. API çağrılarınızı v1'den v2'ye dönüştürmek için lütfen bu geçiş kılavuzuna göz atın

Buna nasıl erişebilirim?

Assistants API, OpenAI API hesabı olan herkesin kullanımına açıktır. Ayrıca Assistants Playground üzerinden de başlayabilirsiniz.

Assistant nedir?

Bir assistant, OpenAI'nin modellerini kullanan ve dosyalara erişebilen, kalıcı thread'leri sürdürebilen ve araç çağırabilen belirli bir amaç için oluşturulmuş bir yapay zekâyı temsil eder.

Thread nedir?

Thread, bir assistant ile bir kullanıcı arasındaki konuşma oturumudur. Thread'ler, mesaj geçmişini depolayarak ve konuşma modelin bağlam uzunluğu için fazla uzadığında bunu kısaltarak uygulama geliştirmeyi basitleştirir.

File Search aracı nedir?

file_search aracı, modelin yanıtlarını zenginleştirmek için dosyalarınızdan doğru verileri çıkarmanıza yardımcı olacak çeşitli veri getirme en iyi uygulamalarını varsayılan olarak uygular. Daha fazla bilgi için lütfen geliştirici dokümantasyonumuzu okuyun.

Varsayılan olarak file_search aracı aşağıdaki ayarları kullanır:

• Parça boyutu: 800 token

• Parça örtüşmesi: 400 token

• Embedding modeli: 256 boyutta text-embedding-3-large

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

Dosya yükleme için kısıtlamalar nelerdir?

Bir dosya yüklemek için kısıtlamalar şunlardır:

• Dosya başına 512 MB

• Dosya başına 5M token

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

• Assistant başına 1 vektör deposu

• Thread başına 1 vektör deposu

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

File Search aracının sınırlamaları nelerdir?

Önümüzdeki aylarda destek eklemek için üzerinde çalıştığımız birkaç bilinen sınırlama var:

1. Şu anda parçalama, embedding veya veri getirme ayarlarını değiştirme imkânı yoktur.

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

3. Yapılandırılmış dosya biçimleri (.csv veya .jsonl dosyaları gibi) üzerinde veri getirmeyi desteklemiyoruz. Desteklenen dosya türlerine bakın.

Assistants API için hız sınırları nelerdir?

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

• GET: 1000 RPM

• POST: 300 RPM

  • /v1/threads/<thread_id>/runs adresine POST: 200 RPM

  • /v1/threads/runs adresine POST: 200 RPM

• DELETE: dakikada 300 istek

API'de Kod Çalıştırma Aracı nasıl fiyatlandırılır?

Kod Çalıştırma Aracı, oturum başına 0,03 $ olarak fiyatlandırılır. Assistant'ınız Kod Çalıştırma Aracı'nı aynı anda iki farklı thread içinde çağırırsa, bu iki Kod Çalıştırma Aracı oturumu oluşturur (2 * 0,03 $). Her oturum varsayılan olarak bir saat boyunca aktiftir; bu da kullanıcınız aynı thread içinde bir saate kadar Kod Çalıştırma Aracı'na komut vermeyi sürdürürse bu ücreti yalnızca bir kez ödeyeceğiniz anlamına gelir.

API'de File Search nasıl fiyatlandırılır?

File Search, günlük vektör deposu depolaması için 0,10 $/GB olarak fiyatlandırılır (ilk GB depolama ücretsizdir). Vektör deposunun boyutu, dosyanız ayrıştırılıp parçalara bölündükten ve embedding uygulandıktan sonra ortaya çıkan vektör deposu boyutuna göre belirlenir.

17 Nisan 2024'ten önce oluşturulan tüm vektör depoları 2024 sonuna kadar ücretsiz olacaktır; sonrasında ise şu durumlardan biri geçerli olacaktır:

• 17 Nisan 2024'ten sonra oluşturulan bir Run içinde en az bir kez kullanılmışlarsa mevcut ücretler üzerinden (şu anda 0,10 $/GB/gün) faturalandırılırlar.

• 17 Nisan 2024 ile 31 Aralık 2024 arasında tek bir Run içinde bile kullanılmadılarsa silinirler — bunun amacı, bu fiyat değişikliği duyurulmadan önce oluşturmuş olabileceğiniz ancak hiç kullanmadığınız vektör depoları için sizden ücret alınmasını önlemektir.

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

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

API'de streaming mevcut mu?

Evet, streaming Assistants API'de mevcuttur.

Assistants API'de JSON modu mevcut mu?

Evet, JSON modu Assistants API'de, Assistants veya Run nesnelerindeki response_format parametresi aracılığıyla kullanılabilir.

Assistants API, 3. taraf fonksiyon çağrıları için istekleri de yönetecek mi?

Hayır. Fonksiyon çağrısı modelin araçları seçmesini ve bunlar için istekleri biçimlendirmesini sağlasa da, 3. taraf araçlara çağrıların yürütülmesi OpenAI tarafından yönetilmez.

OpenAI'ye gönderdiğim veriler nasıl işleniyor?

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

DALL-E, Assistants API üzerinden kullanılabiliyor mu?

Şu anda DALL-E 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 açmak istediğiniz Araçlarla uyumlu bir model kullandığınızdan emin olun.

Assistants API'de assistant yönergeleri için karakter sınırı nedir?

Assistant'ın kullandığı sistem yönergelerinin azami uzunluğu 256.000 karakterdir.

“The server had an error while processing your request. Sorry about that! You can retry your request, or contact us through our help center at help.openai.com if the error persists. “ gibi bir hata alıyorum. Ne yapmalıyım?

Bu hatayı alıyorsanız, bu komutunuzun doğru ayarlanmamış olduğu anlamına gelebilir. İsteği tekrar tekrar denemenize rağmen başarısız oluyorsa, deneyebileceğiniz bazı şeyler şunlardır:

1. komutunuzdaki işlev benzeri komutları işlev olarak ele alacak şekilde komutunuzu yeniden yapılandırdığınızdan emin olun

2. komutunuzdaki komutları tools içine bir işlev olarak ekleyin

File Search aracım neden iyi çalışmıyor?

File Search aracını kullanırken, max_prompt_tokens değerini 20.000'den düşük ayarlamamanızı öneririz. Daha uzun konuşmalar veya File Search ile birden fazla etkileşim için bu sınırı 50.000'e çıkarmayı ya da ideal olarak en yüksek kaliteli sonuçları almak için max_prompt_tokens sınırlarını tamamen kaldırmayı değerlendirin. Daha fazlasını burada okuyun.

Nasıl geri bildirim sağlayabilirim?

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