Persona düzenleme — Lock, Cascade, Manual, Refine

Bir persona üretildikten sonra donmaz. Arayüz dört adlandırılmış düzenleme modu sunar; API yüzeyi (PATCH /v1/personas/{id} + POST /v1/personas/{id}/refine) bunları parametreleştirir. Mod seçimi, hangi katmanın kilitli kaldığını ve hangi katmanların yeniden üretileceğini belirler.

Bu sayfayı bitirdiğinde

• Dört modun (Lock / Cascade / Manual / Refine) ne yaptığını ve ne zaman seçeceğini bileceksin.
• Hangi modun denetim yeniden koşumu (audit re-run) tetiklediğini ayırt edebileceksin.
• Hangi modun parmak izi (fingerprint) yenilemesi tetiklediğini bileceksin.
• Her modun lineage tree'de (soy ağacında) nasıl göründüğünü anlayacaksın.

Ön koşul: Soul/Self/Mask/Surface kavramını biliyor olmak.

Karar matrisi — hangi modu seçerim?

1. Lock (kilitle)

"Bu katmanları koru, kalanını yeniden üret."

Lock, bir veya birden fazla katmanı kilitler; kalanlar üretim hattında yeniden koşar. Karakter çekirdeği doğru ama demografi / dil taşınmalı olduğunda.

await client.personas.refine(personaId, {
  mode: 'lock',
  lockLayers: ['soul', 'self', 'mask'],
  edits: {
    'surface.language': 'de',
    'surface.location': 'Berlin, Germany',
  },
});

Bu örnekte: Soul, Self, Mask dokunulmaz. Sadece Surface yeniden üretilir — yerel (locale) varyantı deseni.

2. Cascade (zincirleme)

"Soul değişti. Aşağıdaki her şey takip etmeli."

Cascade yıkıcı varyant: Soul'u (veya başka bir üst katmanı) düzenle; Self → Mask → Surface sırayla yeniden üretilir, her biri yeni Soul ile kısıtlı.

await client.personas.refine(personaId, {
  mode: 'cascade',
  layer: 'soul',
  edits: { 'soul.wound': 'a sibling who left the country young' },
});

3. Manual (manuel)

"Bir alanı doğrudan yaz. Kalanı bırak."

Manual, LLM çağrısı olmadan tek bir alanı yazar. Persona sürüm numarası artar; lineage tree manual düzenlemeyi kaydeder.

await client.personas.refine(personaId, {
  mode: 'manual',
  edits: {
    'mask.signaturePhrases': ['fine', 'fair point', 'look —'],
    'surface.name.display': 'Mert Kaya'
  }
});

4. Refine (rafine et)

"Bu persona'yı daha karanlık / sıcak / otoriter yap."

Refine, bir katman üzerinde eksen dönüşümü uygular. Bir LLM-istem-yazar, katmanı adlandırılmış eksen boyunca yeniden yazar.

Yerleşik eksenler:

darker · warmer · colder · more-authoritative ·
more-vulnerable · more-playful · more-formal · more-casual

await client.personas.refine(personaId, {
  mode: 'refine',
  layer: 'mask',
  axis: 'warmer',
  amount: 0.4,  // 0..1
});

Denetim refine sonucunu orijinal referans hatla (baseline) karşılaştırır — eksen dönüşümü çok uzak gittiyse persona flagged döner; sen kabul eder veya reddedersin.

Lineage tree — her düzenleme bir düğüm

Hangi mod kullanılırsa kullanılsın, refine sonucu lineage tree'de yeni bir düğüm oluşturur:

per_canonical
├── per_locale_de    (mode: lock, lockLayers: [soul, self, mask])
├── per_warmer       (mode: refine, layer: mask, axis: warmer)
├── per_v2           (mode: cascade, layer: soul, edits: {...})
└── per_fix_typo     (mode: manual, edits: {"surface.name.given": "Mert"})

Tam geçmiş GET /v1/personas/{id}/versions ile erişilebilir, farkları (diff) görüntülenebilir, geri alınabilir (rollback). Detay: Lineage + fork tree.

Düzenleme öncesi — denetim geçmişini incele

Üretimde bir refine yapmadan önce önceki refine'ların denetim sonuçlarına bakmak iyi pratik. Distinctiveness skoru bir önceki refine'da düşmüşse, yeni refine kanonik karakterden çok uzağa gidiyor olabilir.

const versions = await client.personas.versions.list({ id: personaId });
for (const v of versions.data) {
  console.log(`${v.createdAt}  ${v.refineMode}  audit:${v.auditScore}  dist:${v.distinctivenessScore}`);
}

API yüzeyi

• POST /v1/personas/{id}/refine — dört modu da kapsar (mode alanı ile)
• PATCH /v1/personas/{id} — manuel düzenleme kısayolu
• GET /v1/personas/{id}/versions — refine geçmişi
• POST /v1/personas/{id}/versions/{versionId}/rollback — eski sürüme dön

Plan gereksinimi

Dört modun hepsi Free ve üzeri. Özel Refine eksenleri Pro ve üzeri; Cascade refine'ın denetim yeniden koşumu Free'de aylık kotaya sayılır.

İlgili