Assistants API: Threads, Runs, Tools
Custom GPT'nin programatik karşılığı: stateful asistanlar, kalıcı thread'ler, tool ekosistemi.
Şükrü Yusuf KAYA
11 dakikalık okuma
İleri"Custom GPT ama API'de"#
Assistants API (2023 lansmanı, 2024-2025'te v2): kendi uygulamana entegre edebileceğin stateful ve tool-equipped asistanlar.
3 ana kavram:
- Assistant: kişilik + tool'lar + knowledge (bir kez kur, çoklu kullan)
- Thread: bir kullanıcının sohbet geçmişi (kalıcı)
- Run: assistant + thread = bir yanıt üretim seansı
javascript
import OpenAI from "openai";const openai = new OpenAI(); // 1. Assistant oluştur (bir kez)const assistant = await openai.beta.assistants.create({ name: "Customer Support Bot", instructions: "Sen B2B SaaS müşteri destek asistanısın...", model: "gpt-5", tools: [ { type: "code_interpreter" }, { type: "file_search" }, { type: "function", function: { name: "create_support_ticket", description: "Yeni destek bileti aç", parameters: { /* ... */ } } } ],}); // 2. Thread oluştur (her kullanıcı için)const thread = await openai.beta.threads.create(); // 3. Mesaj ekleawait openai.beta.threads.messages.create(thread.id, { role: "user", content: "API anahtarımı sıfırlayamıyorum, yardım."}); // 4. Run başlat (model yanıt üretir)const run = await openai.beta.threads.runs.createAndPoll(thread.id, { assistant_id: assistant.id,}); // 5. Yanıtı alconst messages = await openai.beta.threads.messages.list(thread.id);console.log(messages.data[0].content[0].text.value);Assistants API tam akış — Assistant + Thread + Run.
Assistants kullan:
- Çoklu kullanıcı (her birinin ayrı thread'i)
- Kalıcı sohbet geçmişi (oturum arası)
- Knowledge base + dosya yükleme
- Multi-tool (code interpreter + file search + functions)
Chat Completions yeter:
- Tek-shot çağrı
- Stateless (sen geçmişi yönetiyorsun)
- Hızlı, ucuz, basit
Özet#
✓ Assistants API = stateful, tool-equipped asistanlar
✓ Assistant + Thread + Run modeli
✓ Çoklu kullanıcı + kalıcı geçmiş için ideal
✓ Tek-shot için Chat Completions yeter
Sıradaki ders: Embeddings ve Vector Search — RAG temelleri.
Yorumlar & Soru-Cevap
(0)Yorum yazmak için giriş yap.
Yorumlar yükleniyor...
İlgili İçerikler
Modül 1: Başlangıç ve Temeller
ChatGPT Nedir? Tarihçe, Evrim ve Bugünün Manzarası
Öğrenmeye BaşlaModül 1: Başlangıç ve Temeller
Hesap Açma ve Plan Karşılaştırması: Free, Plus, Pro, Team, Enterprise
Öğrenmeye BaşlaModül 1: Başlangıç ve Temeller