Quickstart

1. Einen API-Key holen

Registriere dich auf moonborn.co ↗ und navigiere zu Settings → API keys → New key. Zwei Präfixe gibt es:

• sk_test_* — an einen Test-Workspace gebunden; isoliert von Produktionsdaten.
• sk_live_* — Produktion. Behandle ihn wie ein Datenbank-Passwort.

Speichere den Key in einer Environment-Variable:

export MOONBORN_API_KEY=sk_live_...

2. Eine Persona erstellen

3. Eine Chat-Session starten

const session = await client.chat.sessions.create({
 personaId: persona.id,
});
 
const message = await client.chat.messages.create({
 sessionId: session.id,
 content: 'Was treibt dich an?',
});
 
console.log(message.content); // Persona antwortet in ihrer eigenen Stimme

4. Voice-Drift überwachen

Jede Chat-Response enthält einen driftScore — wie weit die Persona von ihrem Voice-Fingerprint gedriftet ist. Ein Score über der Workspace-Schwelle (Default 0.30) triggert ein Alert.

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

Tipp — setze engine.pipeline.drift_detection.threshold in deiner Workspace-Config, um die Alert-Schwelle pro Use Case zu tunen. Nutze 0.20 für markensicheren Support, 0.45 für Creative- Play.

Nächste Schritte

• API reference — volle REST- API-Dokumentation für Personas, Chat und Webhooks.
• TypeScript SDK — type-safes SDK für Node.js und Browser.
• Python SDK — SDK für Python-Anwendungen.
• Webhooks — HMAC-signierte Delivery mit fünf Retries und einer Dead-Letter-Queue.