Uygulamayı aç
Moonborn — Developers

Ses varyantı (voice variant) soy yönetişimi (lineage governance) akışı

Dil-bölge (locale) + ton varyantlarını kanonik persona'ya yakın tutmak için marka ekibi yönetişim döngüsü — distinctiveness kapıları, refine inceleme kuyruğu, denetim izi, emekliye ayırma (sunset) politikası.

Bir marka persona'sı birçok varyanta (dil-bölgeler, tonlar, alt-markalar) fork'landığında drift bir başarısızlık biçimidir. Bir varyant kanonik karakterden saatte değil ayda kayar — kimse fark etmeden marka sesi kontrolden çıkar. Bu rehber yönetişim döngüsünü kurar: kanonik karakteri referans hat (baseline) yap, fork'larda marka DNA'sını kilitle, webhook ile refine inceleme kuyruğunu besle, denetim izini kullan, eski varyantları emekliye ayır (sunset).

Moonborn alt yapıyı (substrate) sağlar (soy grafiği, distinctiveness kapıları, webhook'lar). Asıl inceleme döngüsü — kim neyi hangi sıklıkta onaylar — ekibinin operasyon el kitabında (runbook) yaşar.

Bu rehberi bitirdiğinde

  • Kanonik persona'yı distinctiveness referans hattı olarak sabitleyebileceksin.
  • Fork'lara Soul + Self + Mask kilidi zorlayabileceksin (sadece Surface değişsin).
  • persona.audit_failed webhook'unu marka kalite kontrol inceleme kuyruğuna bağlayabileceksin.
  • Her refine'in denetim izinde nasıl göründüğünü bileceksin.
  • 90+ gün terk edilmiş varyantları silmek yerine arşivleyebileceksin.
  • Yönetişimin ne kadarının Moonborn'da, ne kadarının ekibinin operasyon el kitabında olduğunu netleştirebileceksin.

Ön koşul: Team veya üstü plan, marka çalışma alanı, kanonik karakter (denetim ≥ 4.5/5). Varyant fork akışı yeni bir konuysa önce Marka varyantlarını fork'la.

1. Kanonik karakteri distinctiveness referans hattı yap

Distinctiveness varsayılanda "genel ChatGPT tonuna" karşı ölçer. Marka için bu yanlış referans hattıdır — varyantlarının kanonik markaya karşı ne kadar yakın kaldığını ölçmek istiyorsun.

await client.config.setItem({
  key: 'consistency.distinctiveness.custom_baseline_persona_id',
  value: canonical.id,
  scope: 'workspace',
  scopeId: 'ws_...',
});
 
await client.config.setItem({
  key: 'consistency.distinctiveness.min_score',
  value: 0.65,
  scope: 'workspace',
  scopeId: 'ws_...',
});

Artık her varyant kanonik karaktere karşı skorlanır. 0.65 altındaki skorlar genele drift sinyalidir — inceleme kuyruğuna iner.

2. Fork'larda marka DNA'sını kilitle

Bir pazarlamacı veya tasarımcı fork yaptığında Soul + Self + Mask kilidi zorla — sadece Surface (dil-bölge, görünür detaylar) değişsin:

const variant = await client.personas.fork({
  id: canonical.id,
  refine: {
    mode: 'lock',
    lockLayers: ['soul', 'self', 'mask'],
    edits: {
      'surface.language': 'de',
      'surface.location': 'Berlin, Germany',
    },
  },
  note: 'DE locale variant',
});

Eğer dil-bölge altında ton varyantı (resmi / sıradan) gerekiyorsa, bunu fork'un altında ikinci bir fork olarak yap — kanonikten değil, dil-bölge ebeveyninden refine et. Detay: Karakter ses varyantları.

3. persona.audit_failed webhook'unu kalite kontrol kuyruğuna bağla

Refine sonrası denetimi eşik altına düşen herhangi bir varyantı inceleme kuyruğunda gör:

await client.webhooks.create({
  url: 'https://your-app.com/brand/qa',
  events: ['persona.audit_failed'],
  description: 'Brand variant audit failures',
});

Webhook imza doğrulama + yeniden deneme (retry) semantiği için Voice drift'i ele al rehberindeki HMAC deseni geçerlidir.

Tipik inceleme akışı:

  1. Refine yapılır, denetim otomatik çalışır.
  2. Denetim skoru < 4.0persona.audit_failed olayı.
  3. Webhook olayı marka kalite kontrol kuyruğuna iner.
  4. Kalite kontrol inceleyicisi varyantı inceler:
    • Kabul (accept) → varyant yayında kalır.
    • Refine → kaybı düzeltmek için yeniden refine.
    • Reddet (reject) → varyantı arşivle, yeni bir varyant aç.

4. Denetim izi — fark (diff) incelemesi

Her refine soy ağacında yeni bir sürüm üretir. Refine eden eyleyen (actor), refine zamanı, hangi katman ve eksen, önceki / sonraki fingerprint kimlikleri — hepsi denetim kaydına iner.

const history = await client.audit.events.list({
  workspaceId: 'ws_...',
  targetId: variant.id,
  category: 'persona',
  limit: 50,
});
 
for (const e of history.data) {
  console.log(`${e.occurredAt}  ${e.actor.email}  ${e.action}`);
  if (e.action === 'persona.refined') {
    console.log(`  layer: ${e.payload.refine.layer}, axis: ${e.payload.refine.axis}`);
  }
}

PR tabanlı inceleme deseni kurmak istersen Git eşitlemesi ile birleştir — her refine bir commit olur, marka onay süreci PR incelemesi olarak çalışır. Detay: Persona'ları Git ile senkronize et.

5. Eski varyantları emekliye ayır (sunset)

90+ gün hiç kullanılmamış (sohbet oturumu açılmamış, refine yapılmamış) varyantlar silinmemeli, arşivlenmelidir:

await client.personas.archive({ id: variant.id });

Emekliye ayırma kararı için periyodik inceleme

Çeyrek bazında tüm varyantları "kullanım sinyali" üzerinden gözden geçir:

const variants = await client.personas.list({
  workspaceId: 'ws_...',
  parent: canonical.id,
  status: 'active',
});
 
for (const v of variants.data) {
  const usage = await client.personas.usage.summary({ id: v.id, range: '90d' });
  if (usage.totalSessions === 0 && usage.totalRefines === 0) {
    console.log(`Sunset candidate: ${v.id} (${v.note})`);
  }
}

Emekliye ayırma adaylarını marka direktörünün incelemesine al; arşivleme kararı insan tarafında olmalıdır (otomatik arşivleme sürpriz kesintilere — outages — yol açabilir).

Yönetişim akışı — pratik döngü

SıklıkEylemSahip
Refine başına (otomatik)Denetim ve webhook kalite kontrol kuyruğuna iletirMoonborn
HaftalıkKalite kontrol kuyruğundaki refine'leri inceleMarka kalite kontrol
Çeyrek bazındaTüm varyantları distinctiveness taramasından geçir; 0.65 altı düşenleri emekliye ayırmak için aday yapMarka operasyonu
YıllıkDenetim kaydı dışa aktarımı + çevrimdışı arşiv; emekliye ayrılan varyantları temizleUyumluluk

Yönetişimin sınırı — Moonborn ve operasyon el kitabı ayrımı

- Soy grafiği (lineage graph)
- Distinctiveness referans hattı + min_score kapısı
- Refine sırasında otomatik denetim
- persona.audit_failed webhook'u
- Denetim kaydı + saklama
- Persona arşivleme (soy güvenli emekliye ayırma)

Moonborn alt yapıyı ekibe verir; karar mantığını ekip kendi operasyon el kitabında yazar. Bu kasıtlıdır — her marka yönetişim akışı farklıdır, genel bir akış uydurmak yanlış kısıtlar getirir.

Plan gereksinimi

Team ve üstü (özel referans hattı + distinctiveness kapısı + Git eşitlemesi).

İlgili

Marka varyantlarını fork'la

Fork mekaniğinin adım adım eğitimi.

Open →
Çok dilli marka persona'sı iş akışı

Beş haftalık iş akışında bu yönetişim akışının nasıl oturduğu.

Open →
Distinctiveness kavramı

min_score eşiklerinin arkasındaki ölçüm anatomisi.

Open →
Fork atıfı

Soy ağacında varyantların ata-torun ilişkisini sorgulama.

Open →