Yapay Zeka İkizleri

AI Twin'iniz Chainabit'in sizi nasıl anladığına dair kişiselleştirilmiş bir görünümdür. Sistem bunu otomatik olarak sürdürür; siz onu bu uç noktalar aracılığıyla gözlemlersiniz, sınırlı davranışsal tercihleri ​​ayarlarsınız ve istemediğiniz öğeleri unutur veya işaretlersiniz.

Kimlik sistem tarafından yönetilir. Bir ikizin profilini veya anılarını elle yazmanın bir son noktası yoktur.

Uç noktalar

Method	Path	Description	Auth
GET	/workspaces/{workspaceId}/ai/twins	List twins in a workspace	JWT
GET	/workspaces/{workspaceId}/ai/twins/skill-coverage	Skill coverage summary	JWT
GET	/workspaces/{workspaceId}/ai/twins/behavioral-baseline	Behavioral baseline summary	JWT
GET	/workspaces/{workspaceId}/ai/twins/{twinId}/brain	Read the latest twin profile	JWT
GET	/workspaces/{workspaceId}/ai/twins/{twinId}/confidence	Per-field confidence values	JWT
GET	/workspaces/{workspaceId}/ai/twins/{twinId}/evidence	Provenance for the twin's claims	JWT
GET	/workspaces/{workspaceId}/ai/twins/{twinId}/timeline	History of twin profile versions	JWT
PATCH	/workspaces/{workspaceId}/ai/twins/{twinId}/preferences	Update behavioural preferences	JWT
POST	/workspaces/{workspaceId}/ai/twins/{twinId}/test	Run a sample prompt against the twin	JWT
DELETE	/workspaces/{workspaceId}/ai/twins/{entityTwinId}/contributions/{userId}	Admin: revoke a member's contributions to an entity twin	JWT, admin role
GET	/agents/twins/{twinId}/memories	List memories	JWT
DELETE	/agents/twins/{twinId}/memories/{id}	Forget a memory	JWT
POST	/agents/twins/{twinId}/memories/{id}/flag	Flag a memory as wrong	JWT

---

GET /workspaces/{workspaceId}/ai/twins/{twinId}/brain

Tanım

İkizlerin mevcut profilini verir: kişilik boyutları ve sizin hakkınızda oluşturduğu en çok desteklenen iddialar. İkiz hala ilk sinyallerini topluyorsa yanıt "durum: "başladı" ifadesini gösterir.

Rica etmek

• Başlıklar: Authorization: Bearer <token>
• Yol parametreleri:
• "çalışma alanı kimliği"
• "ikiz kimlik"

Cevap

• '200 Tamam'

  {
    "data": {
      "version": 12,
      "personality": {
        "threatSensitivity": 0.2,
        "rewardSensitivity": 0.6,
        "impulseControl": 0.7,
        "socialTrust": 0.5,
        "uncertaintyTolerance": 0.4,
        "emotionalRegulation": 0.65,
        "goalPersistence": 0.8
      },
      "topClaims": [
        { "fieldPath": "preference.terse_replies", "claim": "terse_replies", "confidence": 0.82, "evidenceCount": 14 }
      ]
    }
  }

Kod Örneği

curl -H "Authorization: Bearer $TOKEN" \
  https://api.chainabit.io/workspaces/$WORKSPACE/ai/twins/$TWIN/brain

---

GET /workspaces/{workspaceId}/ai/twins/{twinId}/confidence

Tanım

İkizlerin halihazırda sahip olduğu her iddia için düz bir "fieldPath → güven (0..1)" haritasını döndürür. Hangi iddiaların belirgin bir şekilde sergileneceğine ve hangilerinin geçici olarak ortaya çıkacağına karar vermek için bunu kullanın.

Rica etmek

• Yol parametreleri: workspaceId, twinId

Cevap

• '200 Tamam'

  { "data": { "preference.terse_replies": 0.82, "style.code_oriented": 0.61 } }

Kod Örneği

curl -H "Authorization: Bearer $TOKEN" \
  https://api.chainabit.io/workspaces/$WORKSPACE/ai/twins/$TWIN/confidence

---

GET /workspaces/{workspaceId}/ai/twins/{twinId}/evidence

Tanım

İkizlerin iddialarını destekleyen son kaynak satırlarını döndürür. Belirli bir iddiayı neyin desteklediğini görmek için isteğe bağlı olarak "fieldPath"e (ör. "preference.terse_replies") göre filtreleyin.

Rica etmek

• Yol parametreleri: workspaceId, twinId
• Sorgu: 'fieldPath' (isteğe bağlı), 'limit' (isteğe bağlı, varsayılan 50)

Cevap

• '200 OK' — 'iddia', 'kutupluluk', 'güven', 'çıkarıcı', 'kanal', 'createdAt' içeren kanıt girişleri dizisi.

Kod Örneği

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.chainabit.io/workspaces/$WORKSPACE/ai/twins/$TWIN/evidence?fieldPath=preference.terse_replies"

---

GET /workspaces/{workspaceId}/ai/twins/{twinId}/timeline

Tanım

İkiz profilin en son sürümlerini, en yenisi önce gelecek şekilde döndürür. İkizlerin zaman içinde nasıl geliştiğini görmek için bunu kullanın.

Rica etmek

• Yol parametreleri: workspaceId, twinId
• Sorgu: 'limit' (isteğe bağlı, varsayılan 20)

Cevap

• '200 OK' — 'sürüm' açıklamasına göre sıralanan profil anlık görüntüleri dizisi.

Kod Örneği

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.chainabit.io/workspaces/$WORKSPACE/ai/twins/$TWIN/timeline?limit=20"

---

PATCH /workspaces/{workspaceId}/ai/twins/{twinId}/preferences

Tanım

İkizlerin davranışsal tercihlerini güncelleyin. Bu, bir ikizin kimliğinin üzerine yazılabilen tek yüzeydir. Kimliğin kendisi sistem tarafından yönetilir.

İzin verilen alanlar:

Field	Type	Notes
paused	boolean	Pause background twin updates.
observationEnabled	boolean	Allow the system to observe signals for this twin.
aggregationCron	string	Cron expression.
memoryRetentionDays	integer (1–3650)	How long memories are retained.
sensitivityLevel	"low" | "med" | "high"	Privacy / sharing sensitivity.
publicBrainShowcase	boolean	Opt-in to the public brain showcase on your profile. Off by default.

Çalışma alanı ve kurumsal yönetici politikaları bu alanları geçersiz kılabilir veya kısıtlayabilir.

Rica etmek

• Başlıklar: Authorization: Bearer <token>, Content-Type: application/json
• Vücut:

  { "paused": false, "memoryRetentionDays": 180, "sensitivityLevel": "med" }

Cevap

• 200 OK — { "data": { "preferences": { ... } } }
• "400 Hatalı İstek" — geçersiz alan değerleri
• '403 Yasak' — arayan ikizin kapsamında değil

Kod Örneği

curl -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "paused": false, "memoryRetentionDays": 180, "sensitivityLevel": "med" }' \
  https://api.chainabit.io/workspaces/$WORKSPACE/ai/twins/$TWIN/preferences

---

DELETE /workspaces/{workspaceId}/ai/twins/{entityTwinId}/contributions/

Tanım

Yalnızca yönetici. Tek bir üyenin bir ekip/çalışma alanı/kurum ikizine yaptığı katkıları iptal eder. Üyenin kendi kullanıcı ikizi etkilenmez.

Kuruluş içindeki her ekipten de iptal etmek için kurumsal ikizi üzerinde ?cascade=teams komutunu kullanın.

Rica etmek

• Yol parametreleri: workspaceId, entityTwinId, userId
• Sorgu: cascade=teams (isteğe bağlı)

Cevap

• 200 OK — { "data": { "evidenceRowsDeleted": 42, "teamsCascaded": 3 } }
• '403 Yasak' — arayan, kapsamdaki bir yönetici değil.

Kod Örneği

curl -X DELETE \
  -H "Authorization: Bearer $TOKEN" \
  "https://api.chainabit.io/workspaces/$WORKSPACE/ai/twins/$ENTITY_TWIN/contributions/$USER_ID?cascade=teams"

---

DELETE /agents/twins/{twinId}/memories/

Tanım

Bir anıyı unut. Silme işlemi kalıcıdır; sistem kaldırıldı olarak işaretlenmiş bir öğeyi yeniden türetmeyecektir.

Rica etmek

• Yol parametreleri: twinId, id (Hafızaları listele'in GET /agents/twins/{twinId}/memories yanıtından bellek kimliği)

Cevap

• 200 OK — { "data": { "deleted": 1 } }

Kod Örneği

curl -X DELETE \
  -H "Authorization: Bearer $TOKEN" \
  https://api.chainabit.io/agents/twins/$TWIN/memories/$MEMORY_ID

---

POST /agents/twins/{twinId}/memories/{id}/flag

Tanım

Bir anıyı yanlış olarak işaretleyin. Sistem, ileriye dönük olarak hafızanın etkisini azaltır ve kısa bir pencere içinde başka işaretler biriktirirse onu mezar taşı haline getirebilir.

Rica etmek

• Yol parametreleri: twinId, id (Hafızaları listele'in GET /agents/twins/{twinId}/memories yanıtından bellek kimliği)

Cevap

• 200 OK — { "data": { "flaggedCount": 1 } }

Kod Örneği

curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  https://api.chainabit.io/agents/twins/$TWIN/memories/$MEMORY_ID/flag

---

POST /workspaces/{workspaceId}/ai/twins/{twinId}/test

Tanım

İkize karşı örnek bir istem çalıştırın ve ikizin üreteceği şeyi döndürün. QA ve ürün ayarlama için kullanışlıdır. İkizlerin kayıtlı durumunu etkilemez.

Rica etmek

• Başlıklar: Authorization: Bearer <token>, Content-Type: application/json
• Gövde: { "prompt": "string", "context": { ... } }

Cevap

• '200 OK' — örnek yanıt ve ikizin yapacağı herhangi bir araç çağrısı.

Kod Örneği

curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "How would you phrase a reminder for this user?" }' \
  https://api.chainabit.io/workspaces/$WORKSPACE/ai/twins/$TWIN/test

---

Notlar

• Hız sınırları ve sayfalandırma standart platform başlıklarına göre geçerlidir.
• Auth, çalışma alanı kapsamındaki yetkilere sahip JWT'dir; yönetici uç noktaları ayrıca kuruluşta bir yönetici rolü gerektirir.
• Aracı yürütme kayıtları (çalıştırma geçmişi, onaylar, otomasyon kuralları) için aracı eylemleri referansına bakın.
• Beyin Simülatörü (beyin grafiği, hafıza grafiği, canlı aktivite, anlatım) için bkz. İkiz Beyin.