OpenAI Assistants API ve Threads
OpenAI'nin yönetilen aracıları: sıfır altyapı gerektirir, ancak sağlayıcı bağımlılığı ve gözlemlenebilirlikte eksik bir parça vardır.
OpenAI Assistants API ve Threads, CoddyKit'te ücretsiz bir AI Agents dersidir. Bu, 4 dersinin 3. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, AI Agents öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. AI Agents kursu toplamda 4 dersten oluşur.
Bu dersin bazı bölümleri henüz çevrilmemiş olup İngilizce olarak gösterilmektedir.
Bu Nedir?
OpenAI Assistants API, yönetilen bir aracı ürünüdür. Bir asistan (model + yönergeler + araçlar) tanımlarsınız; kullanıcılar iş parçacıkları (konuşmalar) üzerinden etkileşim kurar. OpenAI durum yönetimini, RAG'i, kod yorumlayıcısını ve dosya depolamayı üstlenir.
İki Büyük Koz
- Dahili file_search — yönetilen RAG; çalıştırılacak vektör veritabanı yok
- Dahili code_interpreter — yalıtılmış bir ortamda Python çalıştırma
Bu özellikleri kendiniz geliştirmeden istiyorsanız Assistants hızlı bir seçenektir.
Creating an Assistant
from openai import OpenAI
client = OpenAI()
assistant = client.beta.assistants.create(
name='Support Bot',
instructions='You help customers with orders.',
model='gpt-4o-mini',
tools=[{'type': 'file_search'}, {'type': 'code_interpreter'}]
)Threads = Conversations
thread = client.beta.threads.create()
client.beta.threads.messages.create(
thread_id=thread.id,
role='user',
content='Where is my order?'
)
run = client.beta.threads.runs.create(
thread_id=thread.id,
assistant_id=assistant.id
)Tamamlanma Durumunu Yoklama
Çalıştırmalar eşzamansızdır. Tamamlanana kadar durumu yoklayın:
import time
while run.status not in ('completed', 'failed', 'requires_action'):
time.sleep(1)
run = client.beta.threads.runs.retrieve(thread_id=thread.id, run_id=run.id)İşlev Çağrısı
chat.completions araçlarıyla aynı kalıp kullanılır. run.status == 'requires_action' olduğunda araç çağrılarını yönlendirin ve sonuçları gönderin:
if run.status == 'requires_action':
tool_outputs = []
for tc in run.required_action.submit_tool_outputs.tool_calls:
result = dispatch(tc)
tool_outputs.append({'tool_call_id': tc.id, 'output': json.dumps(result)})
client.beta.threads.runs.submit_tool_outputs(thread_id=thread.id, run_id=run.id, tool_outputs=tool_outputs)File Search (Vector Store)
vector_store = client.beta.vector_stores.create(name='docs')
client.beta.vector_stores.file_batches.upload_and_poll(
vector_store_id=vector_store.id,
files=[open('handbook.pdf', 'rb')]
)
assistant = client.beta.assistants.update(assistant.id, tool_resources={'file_search': {'vector_store_ids': [vector_store.id]}})Kod Yorumlayıcı
code_interpreter eklediğinizde asistan yalıtılmış bir Python ortamı edinir. Veri görevleri için harikadır:
{'type': 'code_interpreter'}Streaming
with client.beta.threads.runs.stream(thread_id=thread.id, assistant_id=assistant.id) as stream:
for event in stream:
print(event)Ödünler
- + Vektör mağazaları ve yalıtılmış ortam için sıfır altyapı
- + Yönetilen bellek ve iş parçacığı durumu
- + file_search tarafından sağlanan dahili kaynak gösterimleri
- - Sağlayıcıya bağımlılık
- - Getirme stratejisi üzerinde daha az denetim
- - Doğrudan chat.completions kullanımından daha yüksek gecikme
- - Gözlemlenebilirlik daha sınırlıdır
Yol Haritası
OpenAI, Assistants'ın halefi olarak Responses API'yi duyurdu. Bazı ekipler Responses API kesinleşene kadar Assistants kullanmayı erteliyor.
Prototipler İçin Kullanın
50 satırda bir belge-soru-cevap botu oluşturmak mı istiyorsunuz? Assistants'ı geçmek zordur. Katı hizmet düzeyi sözleşmeleri ve özel bir getirme sistemiyle üretim kullanımı içinse kendiniz geliştirin.
Maliyet
Assistants şu ücretleri alır:
- Normal belirteç maliyetleri
- file_search: GB başına günlük depolama ücreti
- code_interpreter: oturum başına ücret
Düşük hacimde ucuzdur; yoğun kullanımda maliyet hızla birikebilir.
Assistants İçin En Uygun Kullanım
Hangi kullanım alanı Assistants API'sine en uygun olur?
Özet
Assistants = yönetilen bir ajan ürünü. file_search + code_interpreter + iş parçacıkları. Prototipler için harikadır; yüksek ölçekli üretim kullanımı için daha az uygundur. Responses API'yi takip edin.
Sıkça Sorulan Sorular
“OpenAI Assistants API ve Threads” dersi ücretsiz mi?
Evet — “OpenAI Assistants API ve Threads” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve AI Agents kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. AI Agents kursu toplamda 4 dersten oluşur.
“OpenAI Assistants API ve Threads” dersinde ne öğreneceğim?
OpenAI'nin yönetilen aracıları: sıfır altyapı gerektirir, ancak sağlayıcı bağımlılığı ve gözlemlenebilirlikte eksik bir parça vardır. AI Agents ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.
AI Agents öğrenmeye başlamak için deneyim gerekli mi?
Önceden deneyim gerekmez. CoddyKit'te AI Agents, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 3. dersidir.
“OpenAI Assistants API ve Threads” dersi ne kadar sürer?
Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.
Bu AI Agents dersinde kod yazıp çalıştırabilir miyim?
Evet. Her AI Agents dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.
Bu kursun tüm dersleri
- LangGraph ve CrewAI ve AutoGen
- Uzun Ömürlü Aracılar için Letta (eskiden MemGPT)
- OpenAI Assistants API ve Threads
- Kullanım Alanına Uygun Çerçeveyi Seçme