Assistants API (v2) SSS

Assistants API nedir?

Assistants API, geliştiricilerin uygulamaları içinde güçlü AI assistant’larını kolayca oluşturmasını sağlar. Bu API, konuşma geçmişini yönetme ihtiyacını 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ını destekler.

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.

Assistant nedir?

Bir assistant, OpenAI’ın modellerini kullanan; dosyalara erişebilen, kalıcı iş parçacıklarını sürdürebilen ve araçları çağırabilen, belirli bir amaç için oluşturulmuş bir AI’yı temsil eder.

Thread nedir?

Thread, bir assistant ile 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 kolaylaştırır.

Dosya Arama aracı nedir?

file_search aracı, model yanıtlarını zenginleştirmek amacıyla dosyalarınızdan doğru verileri çıkarmanıza yardımcı olmak için çeşitli en iyi veri erişimi uygulamalarını yerleşik olarak kullanır. Daha fazla bilgi için geliştirici belgelerimizi okuyun.

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

• Parça boyutu: 800 token

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

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

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

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

Dosya yüklemeye ilişkin kısıtlamalar şunlardır:

• Dosya başına 512 MB

• Dosya başına 5M token

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

• Assistant başına 1 vektör deposu

• İş parçacığı 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 bilinen birkaç sınırlama var:

1. Şu anda parçalama, gömme veya getirme ayarlarını değiştirmenin bir yolu yoktur.

2. Belgelerin içindeki görsellerin ayrıştırılmasını desteklemiyoruz.

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

Assistants API için kullanım limitleri nelerdir?

Assistants API için kullanım limitleri 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

• 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. Asistanınız Kod Çalıştırma Aracı’nı iki farklı iş parçacığında aynı anda çağırırsa bu, iki Kod Çalıştırma Aracı oturumu oluşturur (2 * $0.03). Her oturum varsayılan olarak bir saat boyunca etkindir; bu da kullanıcınız aynı iş parçacığında en fazla bir saat boyunca Kod Çalıştırma Aracı’na talimat 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, vektör deposu depolaması için günlük $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 ayrıldıktan ve gömüldükten sonra ortaya çıkan vektör deposu boyutuna dayanır.

17 Nisan 2024’ten önce oluşturulan tüm vektör depoları 2024 sonuna kadar ücretsiz olacaktır; sonrasında bunlar aşağıdakilerden biri olacaktır:

• 17 Nisan 2024’ten sonra oluşturulan bir Run’da en az bir kez kullanılmışlarsa, geçerli ücretlerle (şu anda $0.10/GB/gün) faturalandırılır.

• 17 Nisan 2024 ile 31 Aralık 2024 arasında tek bir Run’da kullanılmamışlarsa silinirler — bunun amacı, bu fiyatlandırma değişikliği duyurulmadan önce oluşturmuş olabileceğiniz ancak hiç kullanmadığınız vektör depoları için faturalandırılmanızı önlemektir.

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 streaming kullanılabilir mi?

Evet, streaming Assistants API’de kullanılabilir.

Assistants API'de JSON modu kullanılabilir mi?

Evet, JSON modu Assistants veya Run nesnelerindeki response_format parametresi aracılığıyla Assistants API'de 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çmesine ve bunlara yönelik istekleri biçimlendirmesine olanak tanısa da 3. taraf araçlara yapılan çağrıların yürütülmesi OpenAI tarafından yönetilmez.

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

Platformumuzun geri kalanında olduğu gibi, OpenAI API’ye iletilen veriler ve dosyalar modellerimizi eğitmek için asla kullanılmaz ve verilerinizi ihtiyaç duyduğunuzda 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ılabilir mi?

Şu anda DALL-E kullanılabilir değildir.

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.

Assistants API’de assistant talimatları için karakter sınırı nedir?

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

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

Bu hatayı almanız, promptunuzun doğru yapılandırılmadığı anlamına gelebilir. İsteği tekrar tekrar denemenize rağmen başarısız oluyorsa şunları deneyebilirsiniz:

1. fonksiyon benzeri komutları fonksiyon olarak ele alacak şekilde promptunuzu yeniden yapılandırın

2. promptunuzdaki tüm komutları tools bölümüne fonksiyon olarak ekleyin

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

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

Nasıl geri bildirim verebilirim?

Geri bildiriminizi Geliştirici Forumumuzda, help.openai.com adresindeki Yardım Merkezi aracılığıyla veya Twitter’da @OpenAIDevs üzerinden duymaktan memnuniyet duyarız.