xIPnexxIPnex

channel-sdk

一句话

平台已经内置飞书 / 企业微信 / Slack / 邮件 / SCM Webhook 等通道。 如果你用的是自研 IM、客户专属工单系统、或者其他平台没接的入口,自己写一个 channel SKILL 接进来。

安装

发邮件要包

info@nox-lumen.com 申请 ragbase-channel-sdk

pip install ragbase-channel-sdk

五分钟例子

ragbase-cli init channel my-im
cd my-im
vi src/my_im/adapter.py
from ragbase.channel_sdk import Channel, on_inbound, OutboundMessage
 
class MyIMChannel(Channel):
    @on_inbound
    def receive(self, ctx, raw_event):
        # 你家 IM 的消息格式 → 平台标准 inbound message
        return ctx.normalize(
            sender=raw_event["user_id"],
            text=raw_event["body"],
            session_key=raw_event["thread_id"],
        )
 
    def send(self, ctx, msg: OutboundMessage):
        # 平台标准 outbound → 你家 IM 的发送 API
        token = ctx.credentials["im_bot_token"]
        ctx.http.post(
            "https://my-im.internal/send",
            json={"to": msg.recipient, "body": msg.text},
            headers={"Authorization": f"Bearer {token}"},
        )

平台帮你接管:会话路由、debounce、消息去重、断线重连、审计。你只写"格式翻译"

跟 source-sdk 的边界

  • channel = 双向(用户发消息 → AI 回消息)
  • source = 单向(系统里有数据 → 拉进 KB)

行业例子

行业channel 点子
汽车OEM 内部协同平台(自研 chat)
制造产线工单系统 / 现场扫码工位机
办公自研 IM / 客户支持系统

相关

On this page