Temel Kavramlar

Chainabit'in alan modeli iki katman etrafında inşa edilmiştir: ajanları, oturumları ve araç çağrılarını çalıştırmak için bir yapay zeka yürütme katmanı ve görevleri düzenlemek için bir üretkenlik katmanı. Her kavram, ona sahip olan hesaba ve çalışma alanına bağlanır.

Alan Modeli

Hesap ve Çalışma Alanı

Bir Hesap (Account), bireysel bir geliştirici veya kurumsal bir organizasyondur. Her hesabın işleri organize etmek için yalıtılmış ortamlar olan bir veya daha fazla Çalışma Alanı (Workspaces) vardır. Bireysel hesaplar varsayılan bir çalışma alanı alırken, kurumsal firmalar ayrı üyeler ve izinlerle birden fazla çalışma alanı oluşturabilir.

Chainer

Bir Chainer, platformu kullanan kişidir (veya hizmet hesabıdır). Kimliği doğrulanmış her kullanıcı bir Chainer'dır. Bir Chainer ajanlara sahiptir, oturumları çalıştırır ve çalışma alanlarını yönetir.

Yapay Zeka Ajanı

Bir Yapay Zeka Ajanı; sohbet edebilen, araçları yürütebilen ve bilgiyi sorgulayabilen, yapılandırılabilir özerk bir varlıktır. Ajanlar iki biçimde gelir:

• Twin (İkiz) — uzun vadeli hafızaya sahip kalıcı bir yapay zeka kimliğidir. Bir Twin, oturumlar boyunca bağlam biriktirir ve kullanımla birlikte gelişir. Onu bir yapay zeka iş arkadaşı olarak düşünün.
• Tanım (Definition) — belirli görevler için isteğe bağlı olarak örneklendirilebilen yeniden kullanılabilir bir ajan yapılandırmasıdır (model, sistem istemi, araçlar, yetenekler).

Bkz. Agents API ve Twins API.

Oturum ve Mesajlar

Bir Oturum (Session), bir kullanıcı ile bir yapay zeka ajanı arasındaki kalıcı bir konuşma dizisidir. Oturumlar; mesaj geçmişini, araç çağrısı sonuçlarını ve yürütme durumunu tutar.

Mesajlar, bir oturum içindeki değişim birimidir:

• Kullanıcı mesajı — ajana gönderilen girdi
• Asistan mesajı — araç çağrısı sonuçlarını içerebilen ajanın yanıtı
• Sistem mesajı — enjekte edilen bağlam (genellikle ajan tanımından gelir)

Yanıtlar sunucu tarafından gönderilen etkinlikler aracılığıyla akış olarak iletilir. Bkz. Streaming (Akış) ve Sessions API.

Bağlam / Bilgi

Bir Bağlam (Context), bir ajanın geri alma artırılmış üretim için sorgulayabileceği kapsamlı bir bilgi deposudur. Bağlamlar; belgeleri, yerleştirmeleri ve anlamsal arama için dizine eklenmiş yapılandırılmış verileri tutar.

Ajanlar, kendi alanlarındaki soruları yanıtlarken otomatik olarak veya contexts:read API kapsamı aracılığıyla açıkça bağlamları sorgular. Bkz. Contexts API.

Bağlayıcılar (Connectors)

Bağlayıcılar (Connectors), ajanları harici hizmetlere bağlar — Slack, Notion, GitHub, Stripe, Airtable, Linear ve daha fazlası. Her bağlayıcı, ajanların bir oturum sırasında çağırabileceği (örneğin, "bir Notion sayfası oluştur", "açık GitHub sorunlarını listele") bir Araçlar (Tools) seti sunar.

Bağlayıcıların kimlik doğrulaması OAuth veya kimlik bilgisi depolaması aracılığıyla yapılır ve bir çalışma alanına kapsanır. Bkz. Connectors API.

Chainy ve Bits (Üretkenlik / Productivity)

Üretkenlik katmanı, bir çalışma alanı içindeki görevleri düzenler:

• Chainy — hedef kapsamlı bir mikro çalışma alanıdır. Belirli bir proje veya hedef için doğrudan görevler ve bir kanban panosu içerir. Onu hafif bir proje kabı olarak düşünün.
• Bit — atomik bir görev olayıdır. Bir Bit, bekleyen bir görev olarak başlar (başlık, öncelik ve aşama ile) ve bittiğinde tamamlanmış bir kayda dönüşür.

Bkz. Chainies API ve Bits API.

API Anahtarları ve Geliştirici Erişimi

Hizmetten hizmete entegrasyonlar API anahtarlarını (chb_sk_*) kullanarak kimlik doğrulaması yapar. Anahtarlar, gerekli olan minimum izinlerle sınırlandırılır:

Kapsam (Scope)	Erişim
contexts:read / contexts:write	Bilgi bağlamı işlemleri
agents:read / agents:execute	Ajan okumaları ve oturum yürütme
analytics:read	Analitik ve denetim verileri
members:read	Çalışma alanı üyesi okumaları

API anahtarları, Chainer abonelik katmanı veya üstünü gerektirir. Bkz. Developer Access (Geliştirici Erişimi).