Quickstart

1. Bir API key al

moonborn.co ↗'da kaydol ve Settings → API keys → New key'e git. İki prefix var:

• sk_test_* — test workspace'ine bağlı; production verisinden izole.
• sk_live_* — production. Bir database parolası gibi davran.

Anahtarı bir environment variable'a koy:

export MOONBORN_API_KEY=sk_live_...

2. Persona yarat

3. Chat oturumu başlat

const session = await client.chat.sessions.create({
 personaId: persona.id,
});
 
const message = await client.chat.messages.create({
 sessionId: session.id,
 content: 'Seni ne tetikler?',
});
 
console.log(message.content); // Persona kendi sesinde yanıt verir

4. Voice drift'i izle

Her chat yanıtı bir driftScore içerir — personanın voice fingerprint'inden ne kadar drift'lediği. Workspace eşiğinin üstünde (default 0.30) bir skor alert tetikler.

{
 "driftScore": 0.12,
 "driftThreshold": 0.30,
 "driftAlert": false
}

İpucu — alert eşiğini use case başı tune etmek için workspace config'inde engine.pipeline.drift_detection.threshold'unu set'le. Marka-güvenli destek için 0.20, yaratıcı oyun için 0.45 kullan.

Sonraki adımlar

• API reference — personalar, chat ve webhook'lar için tam REST API dokümantasyonu.
• TypeScript SDK — Node.js ve tarayıcılar için type-safe SDK.
• Python SDK — Python uygulamaları için SDK.
• Webhooks — beş retry ve dead-letter queue ile HMAC imzalı delivery.