Taslak Yapılandırma Al

Asistanın SADECE taslak yapılandırma alanlarını alın

Endpoint

GET/assistants/:id/draft

Sadece taslak yapılandırma değerlerini döner. Taslak yoksa null döner.

Önemli Not

Bu endpoint, yalnızca taslak olarak değiştirilen alanları döner. Eğer bir alan taslakta değiştirilmemişse, yanıtta yer almaz.

Hiç taslak değişiklik yoksa, null döner.

Etkin yapılandırmayı (taslak + yayınlanmış + varsayılan) almak için /assistants/:id/effective endpoint'ini kullanın.

URL Parametreleri

idzorunlu

Asistan ID'si

Örnek İstek

cURL
curl -X GET https://api.wespoke.ai/api/v1/assistants/ast_1234567890/draft \
  -H "Authorization: Bearer YOUR_API_KEY"

Yanıt (Taslak Varsa)

200 OK
{
  "systemPrompt": "Taslak sistem talimatı...",
  "greetingMessage": "Taslak karşılama mesajı",
  "voice": "draft-voice-id",
  "temperature": 0.8,
  "maxOutputTokens": 1000,
  "toolIds": ["tool_123", "tool_456"],
  "knowledgeBaseIds": ["kb_789"]
}

Not: Yalnızca taslakta değiştirilen alanlar yanıtta yer alır.

Yanıt (Taslak Yoksa)

200 OK
null

Hiç taslak değişiklik yoksa null döner.

Olası Yanıt Alanları

systemPromptstring | undefined

Taslak sistem talimatı

greetingMessagestring | undefined

Taslak karşılama mesajı

voicestring | undefined

Taslak ses ID'si

languagestring | undefined

Taslak dil kodu (ör: "tr", "en")

temperaturenumber | undefined

Taslak LLM sıcaklık değeri (0.0-1.0)

maxOutputTokensnumber | undefined

Taslak maksimum çıktı token sayısı

llmModelstring | undefined

Taslak LLM model adı

toolIdsstring[] | undefined

Taslak araç ID'leri listesi

knowledgeBaseIdsstring[] | undefined

Taslak bilgi tabanı ID'leri listesi

Hata Yanıtları

404 Not Found
{
  "error": "Assistant not found"
}

Belirtilen ID'ye sahip asistan bulunamadı veya size ait değil.

401 Unauthorized
{
  "error": "Invalid API key"
}

API anahtarı geçersiz veya eksik.

Kullanım Örnekleri

Taslak Düzenleyici UI

Kullanıcıya taslak alanlarını göstermek için:

const draft = await fetch('/api/assistants/ast_123/draft');
if (draft) {
  // Taslak alanları form'da göster
  setFormValues(draft);
} else {
  // Taslak yok, etkin değerleri göster
  const effective = await fetch('/api/assistants/ast_123/effective');
  setFormValues(effective);
}

Taslak Değişiklik Kontrolü

Kullanıcıya "kaydedilmemiş değişiklikler" uyarısı göstermek için:

const draft = await fetch('/api/assistants/ast_123/draft');
if (draft !== null) {
  showWarning('Kaydedilmemiş taslak değişiklikleriniz var');
}