SuperAPI AI 工具集

polpo-channels

智能体与模型

查看项目

更新于 10-16 00:02

技能介绍

Polpo Channels 是一个与供应商无关的开源运行时,构建在 Vercel Chat SDK 官方适配器之上,将传输处理与智能体执行、托管式配置分离。它用于构建、配置和调试 Polpo 消息渠道,覆盖 WhatsApp、Telegram、Slack 和 Discord。

资源模型:Connection 保存项目范围内的供应商授权与凭据;Channel 表示一个已安装的供应商目标;Route 授予智能体访问该 Channel 的权限,并可收窄工具或目标;setup 是临时授权或供应商验证状态。在所需供应商验证成功前,不得将 Channel 标记为 active,也不得从未经验证的 webhook 正文中选择凭据或路由。

工作流:检查供应商能力及现有 Connection、Channel、Route;通过 CLI/API/MCP 以 Connection 引用进行幂等配置,绝不内联密钥;完成回调验证或安全 setup 并确认 active 状态;在需要将供应商身份映射到应用用户、租户、工作区、epoch 或授权时,于创建 Session 前配置可信身份解析器;按供应商能力配置媒体、响应分段、活动运行协调及可选的服务器端客户端工具;端到端测试入站验证、重复投递、附件处理、路由、模型执行、出站投递与重试行为。供应商接受、投递和已读回执应视为不同状态。

不变量:保留未经改动的请求以供官方适配器验证;在解析供应商身份前,将不透明路由键解析为唯一安装;生产状态必须在副本间共享且原子化,用于去重、排队和锁;可信解析器在 Session、Memory、模型或工具执行前运行并失败关闭;Channel 与 Route 的工具策略只能收窄智能体权限;供应商事件需及时确认,长执行在 webhook 生命周期之外协调;媒体字节使用限定范围的凭据惰性获取,并受明确限制约束。

参考资料包括 architecture.md、provisioning.md、conversation-and-media.md、trusted-identity-and-tools.md、whatsapp.md、operations-and-testing.md、contract-version.md。具体安装命令、收费与平台支持等细节暂未提供。