TryCaspian/caspian-sdk

何を解決するか

Caspian は AI エージェントのための統合通信レイヤーを提供し、開発者が各メッセージングプラットフォーム用に別々のアダプタを構築・維持する必要をなくします。Slack、Discord、Telegram などのサービスにおける Webhook の管理、認証、プラットフォーム固有のペイロード形式といった「チャネル接続の煩雑さ」を解消し、開発者がエージェントの推論に集中できるようにします。

動作方法

Caspian は AI エージェントとさまざまな通信チャネルの間で正規化されたインターフェースとして機能します。任意の対応チャネルからのメッセージは、標準の Thread と Message 形式に変換されます。開発者は、チャネル、コマンド、チャットタイプに基づいてメッセージをフィルタリング・処理する宣言的ルールを使用できます。SDK は以下の2つのデプロイモードをサポートしています：

• ホスティング済み：Caspian ゲートウェイがインバウンドメッセージを処理し、エージェントがイベントをポーリングします。
• セルフホスティング：開発者が自身のプラットフォームトークンとWebhookを使用して、アダプタをエージェントプロセス内で直接実行します。

対象ユーザー

複数のプラットフォームで人間とやり取りする必要がある AI エージェントを開発している開発者向けです。カスタマーサポートボット、営業リードフォローアップエージェント、パーソナルアシスタント、コミュニティ管理ボットなどに適しています。

特徴

• 統合 API：各チャネルごとに channels.add() を1回呼び出すだけで、単一のハンドラで複数のプラットフォームにエージェントを展開可能。
• クロスポイントID：チャネルをアイデンティティではなくトランスポートとして扱い、異なるプラットフォーム間で単一のエージェントIDを維持可能。
• 豊富なメッセージ機能：ボタン、ブロック、ストリーミング返信などのネイティブなリッチ要素をサポート。テキストのみのチャネルでは滑らかに降格（フォールバック）。
• 包括的なセキュリティ：Slack、Meta、Telegram などのプラットフォーム向けに組み込みのWebhook検証を提供。
• 柔軟なデプロイ：ゲートウェイ管理（ホスティング）とセルフ管理（セルフホスティング）の両方をサポート。
• 広範なチャネル対応：Telegram、Discord、Slack、メール、WhatsApp、X など、多数のアダプタを提供。