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 等多种渠道的适配器。