TryCaspian/caspian-sdk

解決的問題

Caspian 為 AI 代理提供統一的通訊層，消除開發者為每個訊息平台建立和維護獨立適配器的需要。它解決了「渠道接線」問題——即管理 Slack、Discord、Telegram 等服務的 Webhook、驗證和平台特定的資料格式等繁瑣工作，讓開發者能專注於代理的推理能力，而非其連接性。

工作原理

Caspian 作為 AI 代理與各種通訊渠道之間的標準化介面。它採用單一處理器模型，將來自任何支援渠道的訊息轉換為標準的 Thread 和 Message 格式。開發者可使用宣告式規則，根據渠道、指令或聊天類型來過濾和處理訊息。該 SDK 支援兩種部署模式：

• 託管模式：使用 Caspian 網關處理入站訊息，代理隨後輪詢事件。
• 自託管模式：在代理程序中直接運行適配器，使用開發者自己的平台金鑰和 Webhook。

適用對象

適用於需要在多個平台與人類互動的 AI 代理開發者，例如客戶支援機器人、銷售線索追蹤代理、個人助理和社群管理機器人。

主要亮點

• 統一 API：每個渠道只需呼叫一次 channels.add()，即可透過單一處理器在多個平台部署代理。
• 跨點身分：將渠道視為傳輸方式而非身分，實現跨不同平台的單一代理身分。
• 豐富訊息功能：支援原生富媒體元素，如按鈕、區塊和串流回覆，並在純文字渠道中優雅降級。
• 全面安全：為 Slack、Meta、Telegram 等平台提供內建 Webhook 驗證。
• 靈活部署：支援網關管理（託管）和自管理（自託管）兩種基礎設施。
• 廣泛渠道支援：支援 Telegram、Discord、Slack、電子郵件、WhatsApp、X 等多種渠道的適配器。