【免费下载链接】channels-sdkThe open-source SDK for bringing any agent into any chat platform: Slack, Microsoft Teams, Discord, Telegram - with native, Interactive UI.项目地址https://gitcode.com/gh_mirrors/ch/channels-sdk点击查看免费下载本文将逐行解读 Channels SDK 官方示例 minimal-channel带你理解如何用不到 100 行代码把一个 AI Agent 接入 Slack 等聊天平台搭建出一个最小可行的 AI 频道。Channels SDK 的定位是把任何 AI Agent 带到任何聊天平台Slack、Microsoft Teams、Discord、Telegram 等并支持原生交互式 UI。minimal-channel就是这条理念的最小落地形态——一个常驻 Node 进程完成「注册 Channel → 等待上线 → 收到 提及后回复」的完整闭环。一张图看懂架构Agent、Channels 与聊天平台在动手之前先建立全局认知。Channels 充当「结构化交互层」把 Agent通过 AG-UI 协议通信与各个聊天平台连接起来每一轮对话的路径都是用户在 Slack 中 机器人CopilotKit Intelligence 收到平台事件投递到你的 Channels 进程Channels 通过 AG-UI 运行你的 Agent 并执行工具Intelligence 把原生平台 UI 送回对话示例文件结构4 个文件各司其职minimal-channel的 package.json 里只有 4 个核心依赖copilotkit/channels、copilotkit/runtime、ag-ui/client和dotenv。源码结构如下文件职责lib/channel.ts用createChannel创建频道 一个onMention处理函数lib/runtime.ts组装CopilotRuntime接入CopilotKitIntelligence并挂载 Channellib/env.ts加载.env缺失变量时快速失败server.ts等待channels.ready()启动生命周期 HTTP 服务器下面按执行顺序逐文件解读。第一步环境校验 lib/env.tslib/env.ts 只有 9 行但体现了生产级代码的好习惯——快速失败fail fastexport const required (name: string) { const value process.env[name]; if (!value) throw new Error(Missing ${name}); return value; };它从环境变量中读取值一旦缺失就立刻抛出Missing ${name}错误而不是让程序带着空配置悄悄跑飞。后续文件都会通过required(XXX)来取配置。需要准备的.env变量包括AGENT_URL你的 AG-UI Agent 地址、INTELLIGENCE_API_URL、INTELLIGENCE_GATEWAY_WS_URL和INTELLIGENCE_API_KEY。第二步创建 Channel 与消息处理 lib/channel.tslib/channel.ts 是示例的灵魂核心代码不到 15 行const channel createChannel({ name: scratch, agent: new HttpAgent({ url: required(AGENT_URL) }), });这里做了两件关键的事createChannel用name频道名需与 Intelligence 后台创建的 Channel 对应和agent创建一个频道对象new HttpAgent({ url })通过 AG-UI 的HttpAgent接入一个「通过 HTTP 可达的现成 Agent」。你的模型、工具、业务逻辑全部留在自己的基础设施里Channels 只负责「传话」然后是两个事件处理器channel.onMention(async ({ thread, message }) { await thread.subscribe(); await thread.runAgent(); }); channel.onMessage(async ({ thread, message }) { if (await thread.isSubscribed()) await thread.runAgent(); });onMention当有人在频道中 机器人 时触发先subscribe()订阅这个对话线程再runAgent()让 Agent 开始响应onMessage线程内后续每条新消息都会触发只有当线程「已订阅」时才运行 Agent——这意味着 Agent 会自动跟进对话上下文而不必每次都被 这个「订阅制」设计正是最小示例的精髓一次 整线程接管。第三步组装 Runtime lib/runtime.tslib/runtime.ts 把各部分串成一条流水线const intelligence new CopilotKitIntelligence({ apiUrl: required(INTELLIGENCE_API_URL), wsUrl: required(INTELLIGENCE_GATEWAY_WS_URL), apiKey: required(INTELLIGENCE_API_KEY), }); const runtime new CopilotRuntime({ agents: {}, intelligence, identifyUser: () ({ id: scratch-user, name: Scratch User }), channels: [channel], }); export const listener createCopilotNodeListener({ runtime, basePath: /api/copilotkit, });三层结构一目了然CopilotKitIntelligence负责平台连接凭据、消息入站、断线重连你不需要自己处理 Slack 的 webhookCopilotRuntime运行时核心挂载intelligence连接与channels列表identifyUser决定以什么身份运行createCopilotNodeListener把 runtime 包装成 Node HTTP 监听器basePath: /api/copilotkit暴露生命周期控制端点第四步启动与优雅退出 server.tsserver.ts 只有 15 行却覆盖了一个常驻服务的全部要点await listener.channels?.ready({ timeoutMs: 15_000 });先等待channels.ready()再监听端口——这是很多教程会漏掉的关键一步。它确保 Channel 真正与 Intelligence 握手上线后HTTP 服务才开始接流量。const server createServer(listener); server.listen(3000, () { console.log(\nServer listening on port 3000...); }); process.on(SIGINT, async () { await listener.channels?.stop(); server.close(); });收到SIGINTCtrlC时先channels.stop()断开频道连接、再关闭 HTTP 服务器实现优雅退出避免连接悬挂。最快运行方法3 条命令验证链路按照 examples/minimal-channel/README.md 的步骤需 Node.js 22并在 CopilotKit Intelligence 中创建好连接了 Slack 的 Channelpnpm install cp .env.example .env # 填入 AGENT_URL 与 INTELLIGENCE_* 四个变量 pnpm dev看到Server listening on port 3000...且 Intelligence 后台显示Online后把应用拉进 Slack 频道并 它——Agent 就会在对话线程中回复。链路打通后只需把onMention里的逻辑换成带prompt的thread.runAgent()就能让真正的模型参与对话。从最小示例到生产级应用minimal-channel的价值在于用最短路径验证「连接 → 订阅 → 响应」这条主干。当你需要文件感知、交互审批、多平台支持时可以直接研读仓库内的完整应用 OpenTag——一个用 Python LangGraph Agent 构建的自托管 on-call 分诊助手是 Channels SDK 组件如何组合成生产应用的参考样板详见 examples/README.md。你的目标从这里开始理解最小实现本文 minimal-channel看完整应用examples/OpenTag/官方许可协议LICENSE一句话总结Channels SDK 把「Agent 与聊天平台的通信」变成了一次createChannel的调用而 minimal-channel 证明了这条链路只需要 4 个文件。赞分享【免费下载链接】channels-sdkThe open-source SDK for bringing any agent into any chat platform: Slack, Microsoft Teams, Discord, Telegram - with native, Interactive UI.项目地址https://gitcode.com/gh_mirrors/ch/channels-sdk点击查看免费下载相关推荐基于 RunAnywhere Swift SDK 源码本地调试的最小可运行 LLM 示例runanywhere-minimal 全解析基于 RunAnywhere Swift SDK 源码本地调试的最小可运行 LLM 示例runanywhere minimal 全解析 这是一份针对 RunAAI模型推理服务推理引擎本地部署多模态Caspian examples目录导读用最小可运行示例搭建11个渠道的AI机器人Caspian examples目录导读用最小可运行示例搭建11个渠道的AI机器人 Caspian 是一个 AI Agent 通信 SDKagent comRunAnywhere Swift SDK 最小可执行示例runanywhere-minimal完全指南本地源码消费、构建运行与已知限制RunAnywhere Swift SDK 最小可执行示例runanywhere minimal完全指南本地源码消费、构建运行与已知限制 runanywhAI模型推理服务推理引擎本地部署多模态上一篇探索编程之美Category Theory for Programmers下一篇微信公众号 RSS 私有化部署3 条命令跑起来公众号文章进你的阅读器创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
