Chao Bağlamı

Chao Bağlam API'si için referans. Chao, Chainabit'in Chainy yerlisi davranış danışmanıdır; bu uç nokta, kişiselleştirilmiş koçluk oturumlarına güç veren çözümlenmiş bağlamı bir araya getirir.

Ayrıca bakın

• Nasıl Yapılır: Chao Oturumu Başlatın
• Açıklama: Chao Bağlam Modeli (EN)
• Referans: Oturumlar

Uç noktalar

Method	Path	Description	Auth	Rate Limit
GET	/ai/chao/context	Get resolved Chao context	JWT + Entitlement	30/min

---

GET /ai/chao/context

Tanım

Çözülmüş Chao bağlamını alın. Davranış "chainyId"nin sağlanıp sağlanmadığına bağlıdır:

• chainyId ile — söz konusu hedef sistem için Chainy kapsamlı anıları ve zincir üretkenlik verilerini döndürür.
• 'chainyId' olmadan - genel mod içeriğini döndürür: hesap çapındaki bellekler, kısa vadeli bitler (görevler) ve aktif zincirler (vizyonlarıyla birlikte hedef sistemleri).

Kimlik Doğrulama: JWT Taşıyıcı jetonu + aktif AI yetkisi gereklidir. Hız sınırı: 30/dak

Rica etmek

Sorgu Parametreleri

Parameter	Type	Required	Description
chainyId	string (UUID)	No	The Chainy to resolve context for. Must belong to the authenticated account. If omitted, general mode is returned.

Cevap

Yanıt – Zincirleme Modu

'ChainyId' sağlandığında döndürülür.

{
  "data": {
    "mode": "chainy",
    "chainyId": "550e8400-e29b-41d4-a716-446655440000",
    "memories": [
      {
        "content": "User prefers morning workouts before 8 AM.",
        "type": "preference",
        "scope": "chainy",
        "importance": 85,
        "origin": "inferred",
        "confidence": "high"
      }
    ],
    "productivitySnapshot": {
      "chains": [
        {
          "title": "Morning Run",
          "currentStreak": 12,
          "longestStreak": 30,
          "totalCompletions": 156,
          "status": "active"
        }
      ],
      "recentCompletions": [
        {
          "chainTitle": "Morning Run",
          "completedAt": "2026-03-20T07:30:00.000Z"
        }
      ]
    }
  }
}

Yanıt – Genel Mod

'ChainyId' atlandığında döndürülür. Chao, hesabın tamamında kısa vadeli görevleri ve aktif hedef sistemlerini ortaya çıkarıyor.

{
  "data": {
    "mode": "general",
    "memories": [
      {
        "content": "User prefers concise, action-oriented advice.",
        "type": "preference",
        "scope": "account",
        "importance": 70,
        "origin": "inferred",
        "confidence": "high"
      }
    ],
    "bits": [
      {
        "id": "a1b2c3d4-...",
        "title": "Write unit tests",
        "description": "Cover edge cases for the auth module.",
        "priority": "p2",
        "scheduledFor": "2026-03-31",
        "score": 47
      }
    ],
    "chainies": [
      {
        "id": "550e8400-...",
        "title": "Morning Athlete",
        "description": "Build a consistent morning exercise routine to feel energized daily.",
        "status": "active"
      }
    ]
  }
}

Yanıt Alanları — Zincirleme Mod

Field	Type	Description
mode	string	Always "chainy"
chainyId	string	The Chainy UUID this context was resolved for
memories	object[]	Chainy-scoped memory entries
memories[].content	string	Human-readable memory content
memories[].type	string	Memory type: preference, behavioral_pattern, goal, observation
memories[].scope	string	Memory scope: chainy, account, workspace
memories[].importance	number	Importance score (0–100)
memories[].origin	string	How the memory was created: inferred, explicit, system
memories[].confidence	string	Confidence level: high, medium, low
productivitySnapshot.chains[].title	string	Chain title
productivitySnapshot.chains[].currentStreak	number	Current active streak
productivitySnapshot.chains[].longestStreak	number	All-time longest streak
productivitySnapshot.chains[].totalCompletions	number	Total completions
productivitySnapshot.chains[].status	string	Chain status: active, paused, archived
productivitySnapshot.recentCompletions[].chainTitle	string	Title of the completed chain
productivitySnapshot.recentCompletions[].completedAt	string	ISO 8601 completion timestamp

Yanıt Alanları — Genel Mod

Field	Type	Description
mode	string	Always "general"
memories	object[]	Account-wide memory entries
bits	object[]	Near-term tasks scored by date proximity and priority
bits[].id	string	Bit UUID
bits[].title	string	Task title
bits[].description	string | null	Short task description
bits[].priority	string	Priority: p1, p2, p3, p4
bits[].scheduledFor	string | null	ISO date the bit is scheduled for
bits[].score	number	Computed relevance score (higher = more urgent)
chainies	object[]	Active goal systems
chainies[].id	string	Chainy UUID
chainies[].title	string	Goal system title
chainies[].description	string | null	Goal system vision or description
chainies[].status	string	Always "active" in this response

Hata Yanıtları

Status	Code	Description
400	BAD_REQUEST	chainyId was provided but is not a valid UUID
401	UNAUTHORIZED	Missing or invalid JWT token
403	FORBIDDEN	No active AI entitlement
404	NOT_FOUND	Chainy not found or does not belong to the authenticated account

Kod Örnekleri

Chainy modunda, "chainyId" mevcut bir Chainy'nin "kimliği" olmalıdır - ör. Aşağıda "$CHAINY_ID" olarak gösterilen Create Chainy adresinden.

cURL — Chainy mode

curl "https://api.chainabit.com/api/v1/ai/chao/context?chainyId=$CHAINY_ID" \
  -H "Authorization: Bearer $TOKEN"

cURL — General mode

curl "https://api.chainabit.com/api/v1/ai/chao/context" \
  -H "Authorization: Bearer $TOKEN"

JavaScript

const chainyId = process.env.CHAINY_ID; // id of the Chainy to resolve context for

// Chainy-scoped mode
const chainyRes = await fetch(
  `${BASE_URL}/ai/chao/context?chainyId=${chainyId}`,
  { headers: { Authorization: `Bearer ${TOKEN}` } },
);

// General mode
const generalRes = await fetch(
  `${BASE_URL}/ai/chao/context`,
  { headers: { Authorization: `Bearer ${TOKEN}` } },
);

Python

import os
import requests

chainy_id = os.environ["CHAINY_ID"]  # id of the Chainy to resolve context for

# Chainy-scoped mode
chainy_res = requests.get(
    f"{BASE_URL}/ai/chao/context",
    params={"chainyId": chainy_id},
    headers={"Authorization": f"Bearer {TOKEN}"},
)

# General mode
general_res = requests.get(
    f"{BASE_URL}/ai/chao/context",
    headers={"Authorization": f"Bearer {TOKEN}"},
)