SuperAPI AI 工具集

messaging

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:AiTer 的消息与 IM 网关,负责把即时通讯渠道与项目终端、AI CLI 会话打通,支持消息收发、路由与双向通信。

渠道类型:telegram 为双向,可收发消息、机器人命令与内联回复;webhook 仅出站,可向 Slack、钉钉、企业微信或接受 POST JSON 的自定义端点发送消息。双向渠道在用户发消息时可触发 AI CLI 会话,仅出站渠道不能触发会话。

主要命令:用 aiter message add-channel 添加渠道,telegram 需 --type telegram --name --token,webhook 需 --type webhook --name --url;用 aiter message channels 列出渠道;aiter message connect/disconnect --id 启停监听;aiter message remove-channel --id 删除渠道;aiter message send --channel --text 发送,可加 --format markdown;aiter message reply --text 回复由 IM 触发会话,并保留对话上下文,回复时应使用 reply 而非 send。Telegram token 可通过 @BotFather 的 /newbot 获取。

消息路由:aiter message add-route 将渠道消息转发到项目终端,支持 --channelId、--projectId、--terminalId 与 --commandPrefix(如仅处理 /ask 前缀)。路由匹配后去除前缀写入终端,并设置 AITER_REPLY_CHANNEL 与 AITER_REPLY_CONTEXT,AI CLI 处理后经 reply 返回结果。用 aiter message routes 查看,aiter message remove-route --id 删除。

适用场景:把构建状态、告警、维护通知推送到 IM;在 IM 中向项目终端发起问答或状态查询;多渠道路由与广播(循环调用 send)。

限制:单条消息 4096 字符,每渠道每分钟 20 条,每项目最多 10 个渠道,并发连接 5 个,每渠道仅保存最近 1000 条消息;超长消息需拆分或经 tunnel URL 分享。其他收费、平台等细节暂未提供。