caspian-sdk
代理通訊 SDK。開放原始碼的 AI 代理通訊層 — 電子郵件、WhatsApp、Slack、Discord、Telegram、SMS。支援 Python 與 TypeScript。
caspian-sdk 是什麼?
代理通訊 SDK。開放原始碼的 AI 代理通訊層 — 電子郵件、WhatsApp、Slack、Discord、Telegram、SMS。支援 Python 與 TypeScript。
caspian-sdk 概覽
這是什麼
Caspian 是一個代理通訊 SDK。它提供開源的代理通訊層,讓 AI 代理能透過電子郵件、WhatsApp、Slack、Discord、Telegram、SMS 等管道進行通訊。支援 Python 與 TypeScript。
主要功能
- 宣告式規則:
@cx.on_message()可依頻道、聊天類型、指令、重疊策略與即時確認進行過濾。機器人的規則為可檢查的資料。 - Webhook 驗證:處理 Slack 簽章密鑰、Meta X-Hub-Signature-256、Telegram 密鑰標頭、X CRC 以及簽署的電子郵件 webhook。不符者會遭拒絕。
- 託管或自架:
via=hosted使用 Caspian 閘道;via=self-host在您的程序中執行適配器,使用您自己的平台令牌。無需改寫處理器即可切換模式。 - 單一處理器支援多個頻道:使用
cx.channels.add()新增頻道,並以單一@cx.on_message()裝飾器處理訊息。 - 標準化的 Thread/Message 模型:無論傳輸方式為何,訊息都以核心事件的形式送達,並支援重疊策略(queue、debounce、drop、parallel)以及
thread.post()/thread.reply()方法。
使用情境
- 將 AI 代理連接到人類使用的通訊管道,例如 Slack、Discord、Telegram、電子郵件、WhatsApp、X 與 Linear。
- 以單一 SDK 整合取代每個頻道的適配器程式碼。
- 讓代理能根據情境決定使用哪個頻道進行通訊。
快速開始
bashpip install caspian-sdk # Python 3.10+npm install caspian-sdk # TypeScript / Node 18+ / Bun從 dashboard.trycaspianai.com 取得 API 金鑰,然後依照 README 中的範例使用 SDK。
授權與價格
採用 AGPL-3.0 授權。開放原始碼(免費)。
內容整理自該專案公開的 README 與儲存庫資訊。