Hızlı başlangıç

Anahtar oluşturunBaşlık bağlantısını kopyala

Sonecentral'da Metin asistanı sayfasını açın ve API anahtarları bölümünden yeni anahtar oluşturun. Bu bölümü yalnız çalışma alanının yöneticileri görür. Tür alanında iki seçenek var:

• Sunucu anahtarı sk-sone-v1- ile başlar ve arka uç kodunuz içindir. Tarayıcıya, mobil uygulama paketine ya da herkese açık bir depoya asla koymayın.
• Tarayıcı anahtarı pk-sone-v1- ile başlar ve sitenizdeki sohbet penceresi içindir. Yalnız izin verdiğiniz sitelerden çalışır.

Anahtar yalnız oluşturulduğu anda bir kez gösterilir. Hemen ortam değişkeni olarak saklayın:

export SONE_API_KEY="sk-sone-v1-..."

Ayrıntılar: Kimlik doğrulama ve anahtarlar.

Asistanınızın kimliğini bulunBaşlık bağlantısını kopyala

curl https://pb.sonecentral.com/api/v1/models \
  -H "Authorization: Bearer $SONE_API_KEY"

Listedeki id, model alanına yazacağınız değerdir. Anahtar tek bir asistana açıksa "default" yazmanız da yeter.

İlk mesajı gönderinBaşlık bağlantısını kopyala

curl https://pb.sonecentral.com/api/v1/chat/completions \
  -H "Authorization: Bearer $SONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "default",
    "messages": [
      { "role": "user", "content": "Yarın öğleden sonra randevu alabilir miyim?" }
    ]
  }'

Kurulum: npm i openai, pip install openai ya da npm i ai @ai-sdk/openai. Örnekler openai 7 (Node), openai 2 (Python), ai 7 ve @ai-sdk/openai 4 ile denendi.

Sohbeti sürdürünBaşlık bağlantısını kopyala

Yanıtta choices[0].message.sone.conversation_id gelir. Sonraki mesajda bunu metadata içinde geri gönderin; asistan önceki mesajları hatırlar. Yalnız yeni mesajı gönderdiğiniz için her mesaja bir Idempotency-Key de ekleyin: ağ hatasından sonra aynı anahtarla yeniden denerseniz mesaj iki kez kaydedilmez.

// `sone` OpenAI tiplerinde yok; tipini Chat Completions sayfasında bulursunuz.
const { sone } = completion.choices[0].message as unknown as {
  sone: { conversation_id: string };
};

await client.chat.completions.create(
  {
    model: 'default',
    metadata: { conversation_id: sone.conversation_id },
    messages: [{ role: 'user', content: 'Saat dört uygun mu?' }],
  },
  { headers: { 'Idempotency-Key': crypto.randomUUID() } },
);

Başka yollar, yeniden deneme ve tarayıcıda saklama: Sohbet sürekliliği.