Bağlamlar

Bağlamlar, hesabınıza veya çalışma alanınıza düzenlenmiş bilgileri — belgeler, notlar, web sayfaları veya zincir çıktıları — eklemenizi sağlar. İçe aktarıldıktan sonra bağlamlar anlamsal olarak indekslenir ve yapay zeka ikizinizin prompt hattına otomatik olarak enjekte edilir.

Temel yol

/api/v1/agents/contexts

Kimlik Doğrulama

Tüm endpoint'ler geçerli bir JWT Bearer token gerektirir.

export BASE_URL="https://api.chainabit.com/api/v1"
export TOKEN="your-access-token"
export WORKSPACE_ID="your-workspace-id"

---

Endpoint'ler

Metot	Yol	Açıklama
GET	/agents/contexts	Bağlamları listele
GET	/agents/contexts/:id	Bir bağlamı ID ile getir
POST	/agents/contexts	Bağlam oluştur
PATCH	/agents/contexts/:id	Başlık veya açıklamayı güncelle
DELETE	/agents/contexts/:id	Bağlamı sil
POST	/agents/contexts/search	Bağlamlar üzerinde anlamsal arama yap

---

GET /agents/contexts

Hesabınıza ait bağlamları listeler.

İstek

Sorgu parametreleri

Parametre	Tür	Varsayılan	Açıklama
limit	number	20	Sayfa başına kayıt sayısı
offset	number	0	Sayfalama ofseti
workspaceId	string	—	Belirli bir çalışma alanına göre filtrele

Yanıt

{
  "data": [
    {
      "id": "ctx_01...",
      "title": "Q1 Strategy",
      "description": "Leadership OKR notes",
      "status": "ready",
      "content_summary": "A concise AI-generated summary...",
      "created_at": "2026-04-01T10:00:00Z"
    }
  ],
  "meta": { "total": 12, "limit": 10, "offset": 0 }
}

Kod Örneği

curl "$BASE_URL/agents/contexts?limit=10" \
  -H "Authorization: Bearer $TOKEN"

---

GET /agents/contexts/:id

Tek bir bağlamı ID ile getirir.

Yanıt

Bağlam mevcut değilse veya başka bir hesaba aitse 404 döndürür.

Kod Örneği

curl "$BASE_URL/agents/contexts/ctx_01..." \
  -H "Authorization: Bearer $TOKEN"

---

POST /agents/contexts

Yeni bir bağlam oluşturur. İçe aktarma — yapay zeka özetleme ve gömme işlemi — eşzamansız olarak çalışır. Döndürülen kayıt status: "processing" değerine sahiptir.

İstek

Sorgu parametreleri

Parametre	Tür	Açıklama
workspaceId	string	İsteğe bağlı — bir çalışma alanına bağla

İstek gövdesi

Alan	Tür	Zorunlu	Açıklama
title	string	Evet	Görünen ad
description	string	Hayır	İsteğe bağlı açıklama
sourceType	string	Evet	document, note, web veya chain_output
rawContent	string	Hayır	document, note, chain_output için metin içeriği
url	string	Hayır	web kaynakları için URL
chainId	string	Hayır	chain_output kaynakları için zincir kimliği

Yanıt

{
  "data": {
    "id": "ctx_01...",
    "title": "Q1 Strategy",
    "status": "processing",
    "created_at": "2026-04-11T09:00:00Z"
  }
}

Kod Örnekleri

Örnek — belge

curl -X POST "$BASE_URL/agents/contexts" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Q1 Strategy",
    "description": "Leadership OKR notes",
    "sourceType": "document",
    "rawContent": "In Q1 we aim to grow revenue by 30%..."
  }'

Örnek — web sayfası

curl -X POST "$BASE_URL/agents/contexts" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Competitor Analysis",
    "sourceType": "web",
    "url": "https://example.com/analysis"
  }'

---

PATCH /agents/contexts/:id

Bir bağlamın title ve/veya description alanını günceller.

İstek

İstek gövdesi

Alan	Tür	Açıklama
title	string	Yeni başlık
description	string | null	Yeni açıklama veya temizlemek için null

Kod Örneği

curl -X PATCH "$BASE_URL/agents/contexts/ctx_01..." \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Q1 Strategy — Revised" }'

---

DELETE /agents/contexts/:id

Bir bağlamı siler. Geçici silme — kayıt gizlenir ancak fiziksel olarak kaldırılmaz.

Yanıt

{ "data": { "deleted": true } }

Kod Örneği

curl -X DELETE "$BASE_URL/agents/contexts/ctx_01..." \
  -H "Authorization: Bearer $TOKEN"

---

POST /agents/contexts/search

ready durumundaki bağlamlarınız üzerinde anlamsal arama yapar. Sonuçlar, kosinüs benzerliği ve güncellik kombinasyonuna göre sıralanır.

İstek

İstek gövdesi

Alan	Tür	Zorunlu	Açıklama
query	string	Evet	Doğal dilde arama sorgusu
topK	number	Hayır	Maksimum sonuç sayısı, 1–20 (varsayılan 3)
workspaceId	string	Hayır	Belirli bir çalışma alanıyla sınırla

Yanıt

{
  "data": [
    {
      "id": "ctx_01...",
      "title": "Q1 Strategy",
      "contentSummary": "A concise AI-generated summary...",
      "score": 0.873
    }
  ]
}

Kod Örneği

curl -X POST "$BASE_URL/agents/contexts/search" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Q1 product strategy",
    "topK": 5
  }'

---

Bağlam durumları

Durum	Anlamı
processing	İçe aktarma devam ediyor — henüz aranamaz
ready	İndekslenmiş ve anlamsal arama için kullanılabilir
failed	İçe aktarma başarısız oldu — aranamaz

---

Notlar

• Arama sonuçlarında yalnızca ready durumundaki bağlamlar görünür.
• status: "processing" durumundaki bağlamlar, GET /agents/contexts ve GET /agents/contexts/:id ile listelenmeye devam eder.
• Bir bağlamı silmek, yapay zeka ikizi daha önce bu bağlamı kullanıyor olsa bile, gelecekteki prompt enjeksiyonlarından hemen kaldırılmasını sağlar.