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.

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.