Moonborn'a hoş geldin

Moonborn, yapay zeka karakterlerinin uzun konuşmalarda, farklı kanallarda ve birden çok dilde aynı kişi gibi kalmasını sağlayan bir tutarlılık katmanıdır. Bu dokümantasyon, Moonborn'u API'si, SDK'ları ve çalışma zamanı (runtime) üzerinden ürününe entegre eden geliştiriciler için yazıldı.

Tek cümlelik bir tarif — "Altmışlı yaşlarında, İstanbul'da bahçesine takıntılı emekli bir cerrah" — Moonborn'da içten dışa kurulan dört katmanlı bir karaktere dönüşür: motivasyonu, kişiliği, konuşma tarzı ve görünür detayları. Aynı karakter daha sonra bir sohbet oturumunda, oyun sahnesinde, destek akışında veya marka kanalında sesini koruyarak konuşur.

Ürünün tamamına dışarıdan bakmak istersen moonborn.co ↗ adresine git; burası kodla çalışacak geliştirici için.

İlk olarak nereye gideyim?

Geldiğin yere göre öneri:

• İlk kez geliyorsan — Hızlı başlangıç: beş dakikada ilk persona'nı (karakter) üret ve onunla bir mesaj alışverişi yap.
• API entegre edeceksen — Kimlik doğrulama ile başla; sonra İlk persona'yı üret ve Sohbet oturumu kur rehberlerini geç.
• Karakter modelini önce anlamak istiyorsan — Persona katmanları: Soul (motivasyon), Self (özellikler), Mask (ses), Surface (demografi) — bu dört katmanın ne tanımladığı ve neden bu sırayla kurulduğu.
• Üretim (production) ortamına çıkacaksan — Webhook'lar, hız limitleri (rate limits), hata kodları ve drift detection (sesin kaymasını ölçme).

Burada ne bulursun?

Dokümantasyon beş ana bölüme ayrılır:

• Kavramlar (Concepts) — Karakter nasıl kurulur, tutarlılık nasıl korunur, drift (sesin kayması) nedir, voice fingerprint (sesin parmak izi) ne işe yarar, lineage tree (soy ağacı) nasıl çalışır.
• Eğitimler (Tutorials) — Adım adım çalışan rehberler: ilk persona'dan marka variant'larına fork'a, çok karakterli sahneye, kendi sentetik kullanıcı paneline kadar.
• SDK'lar — TypeScript, Python, Go, Ruby, Rust, Elixir ve komut satırı aracı (CLI); hepsi OpenAPI spec'inden otomatik üretilir.
• Entegrasyonlar (Integrations) — OpenAI uyumlu uç nokta (endpoint), MCP sunucusu, webhook olay gönderimi, Git senkronizasyonu, Slack / Discord / Zapier.
• Başvuru (Reference) — Yetki (scope) kataloğu, hız limitleri, hata kodları, plan özellik matrisi, terimler sözlüğü, SSS.

Üretim için neye güvenebilirsin?

Production'a (üretim ortamına) çıkmadan önce şu altyapıların hazır olmasını bekleyebilirsin:

• Persona sürümleme ve geri alma — her rafine etme (refine) yeni bir sürüm; istediğin sürüme geri dönersin.
• Denetim kaydı (audit log) — kim ne zaman ne okudu/yazdı; dışa aktarılabilir, saklama süresi (retention) plan'a göre uzar.
• Yetki kapsamlı (scoped) API anahtarları — en az yetki prensibi; API anahtarı yetki referansı tam 13'lük listeyi taşır.
• Hız limitleri — plan'a göre tabanlar, yanıt başlıklarıyla (response header) şeffaf; bkz. hız limitleri.
• Webhook olay gönderimi — persona, sohbet ve drift olayları için HMAC imzalı gönderim, otomatik yeniden deneme; webhook olay kataloğu.
• Hata kodları — tüm 4xx/5xx kodları belgelidir; hata referansı.

Devam et

Henüz ilk persona'nı üretmediysen Hızlı başlangıç en kısa yol. Karakter modelini önce anlamak istiyorsan Persona katmanları ile başla. Ürünün ne yaptığına ürün anlatısı olarak bakmak istiyorsan moonborn.co ↗ adresine git.