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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/trycaspiancaspian-sdk.svg)](https://yunodb.com/tools/trycaspiancaspian-sdk?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/trycaspiancaspian-sdk?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/trycaspiancaspian-sdk.svg" alt="Featured on YunoDB" height="20"></a>