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.

docs.api.assistants.getDraft.etkinYapilandirmayiTaslakYayinlanmisVarsayilan/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": "Draft system prompt...",
  "greetingMessage": "Draft greeting message",
  "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) {
  // Show draft fields in the form
  setFormValues(draft);
} else {
  // No draft, show effective values
  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('You have unsaved draft changes');
}