Skip to content

Assistants API: Threads, Runs, Tools

Custom GPT'nin programatik karşılığı: stateful asistanlar, kalıcı thread'ler, tool ekosistemi.

Şükrü Yusuf KAYA
11 min read
Advanced
Assistants API: Threads, Runs, Tools

"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ı
Assistants API mimari diyagramı.
Assistant kalıcı, Thread kullanıcı, Run birleşim.
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 ekle
await 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ı al
const 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...

Related Content