Konuşma Katılımcıları ve Lens'ler

Bir konuşma "odasına" bir veya daha fazla yapay zeka ajanı davet edin, belirli birine @mention ile hitap edin, herkese açık LenserFight ajanlarını içe aktarın ve bir mesaj içinde Lens çağrısı yapın.

Endpoint'ler

Yöntem	Yol	Açıklama	Yetkilendirme
GET	/workspaces/:workspaceId/ai/sessions/:sessionId/participants	Davet edilen ajanları listele	JWT + Yetki
POST	/workspaces/:workspaceId/ai/sessions/:sessionId/participants	Bir ajanı davet et	JWT + Yetki
DELETE	/workspaces/:workspaceId/ai/sessions/:sessionId/participants/:participantId	Bir ajanı kaldır	JWT + Yetki
GET	/workspaces/:workspaceId/ai/agents/discover?q=	Chainabit + LenserFight ajanlarını keşfet	JWT + Yetki

Bir ajanı davet etme

Yerel bir agentId ya da herkese açık bir LenserFight ajanını yansılayarak içe aktarıp tek çağrıda davet etmek için bir lenserfightAgentId sağlayın. mentionHandle isteğe bağlıdır — varsayılan olarak ajanın adından türetilen bir slug kullanılır.

Davet edilen ilk ajan varsayılan yanıtlayıcı olur. Daha önce kaldırılmış bir ajanı yeniden davet etmek, ajanı tekrar etkinleştirir.

Ajan, oturumun çalışma alanında kullanılabilir olmalıdır: o çalışma alanının bir ajanı ya da tüm hesapla paylaşılan bir ajan. Hesabın başka bir çalışma alanına özel bir ajan, başka bir hesabın ajanı ve silinmiş bir ajan, var olmayan bir ajanla aynı yanıtla 404 (Agent not found) olarak reddedilir.

Kod Örnekleri

cURL

curl -X POST https://api.chainabit.com/api/v1/workspaces/$WORKSPACE_ID/ai/sessions/$SESSION_ID/participants \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "agentId": "a1b2c3", "mentionHandle": "researcher" }'

LenserFight içe aktarma

curl -X POST https://api.chainabit.com/api/v1/workspaces/$WORKSPACE_ID/ai/sessions/$SESSION_ID/participants \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "lenserfightAgentId": "lf_agent_123" }'

@mention ile bir ajana hitap etme

Odada birden fazla ajan bulunduğunda, yalnızca belirli bir ajanın yanıt vermesi için ona mention ile hitap edin:

@researcher summarize the latest findings

• @handle ile hitap edilen bir mesaj yalnızca o ajanı tetikler.
• Hitap edilmemiş mesajlar varsayılan katılımcıya yönlendirilir.
• Her mesaj başına tam olarak bir ajan yanıt verir — fan-out (dağıtım) yapılmaz.

LenserFight ajanlarını keşfetme ve içe aktarma

Yanıt

{ local: [...], lenserfight: [...] } döndürür. Bir lenserfight sonucunu davet etmek için lenserfightAgentId değerini yukarıdaki davet endpoint'ine iletin.

Kod Örneği

curl "https://api.chainabit.com/api/v1/workspaces/$WORKSPACE_ID/ai/agents/discover?q=research" \
  -H "Authorization: Bearer $TOKEN"

Bir mesaj içinde Lens çağrısı yapma

Bir LenserFight Lens'ini doğrudan mesaj içinde /lens komutuyla çağırın:

/lens summarize topic=AI tone=formal

• Lens'in eksik zorunlu parametreleri varsa ajan sizden bunları ister. Değeri yanıt olarak gönderin; Lens otomatik olarak çalıştırılır.
• Tamamlandığında, çözümlenen Lens şablonu yalnızca o tek turda uygulanır — Lens'ler mesaj başına uygulanır ve asla konuşma katılımcısı olarak eklenmez.

Siz:   /lens summarize
Ajan:  Hangi konuyu özetlememizi istersiniz?
Siz:   AI agents
Ajan:  <çözümlenen Lens üzerinden yanıt verir>

Desteklenen token'lar: version=<versionId> belirli bir Lens sürümünü seçer; diğer tüm key=value çiftleri (tırnak içindeki değerler desteklenir) Lens parametreleridir.

İnsan Katılımcılar

Bir çalışma alanı üyesini bir oturuma tam okuma+yazma yetkisine sahip katılımcı olarak ekleyin — bu, yukarıdaki yapay zeka ajanı davetinden ve salt okunur ve kimlik doğrulaması gerektirmeyen herkese açık paylaşım bağlantısından farklıdır.

Endpoint'ler

Yöntem	Yol	Açıklama	Yetkilendirme
POST	/workspaces/:workspaceId/ai/sessions/:sessionId/participants/humans	Bir insan katılımcı davet et	JWT + Yetki

Bir insan katılımcı davet etme

Oturumun çalışma alanındaki mevcut bir üyenin chainerId değerini sağlayın. Kabul adımı yoktur — hedef, Chainy İş Birlikçileri davet akışının aksine anında tam katılımcı olur. Hedefin, oturumun ait olduğu çalışma alanının etkin bir üyesi olması gerekir; aksi hâlde istek başarısız olur.

İstek

Alan	Tür	Zorunlu	Açıklama
chainerId	string	Evet	Katılımcı olarak eklenecek çalışma alanı üyesinin kimliği

Kod Örnekleri

curl -X POST https://api.chainabit.com/api/v1/workspaces/$WORKSPACE_ID/ai/sessions/$SESSION_ID/participants/humans \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "chainerId": "b2c3d4e5-f6a7-8901-bcde-f12345678901" }'

Notlar

• Tüm endpoint'ler hedef çalışma alanında üyelik gerektirir.
• Yalnızca herkese açık LenserFight ajanları içe aktarılabilir.
• Sohbetten bir LenserFight iş akışı çalıştırmak, harici kredi harcadığı için onay gerektirir.

Mevcut Sınırlamalar

• Hesabın başka bir çalışma alanı aynı LenserFight ajanını daha önce içe aktardıysa ya da içe aktarılan kopya silindiyse, lenserfightAgentId ile davet aynı 404 (Agent not found) yanıtıyla reddedilir.