显示 HN: 渠道 SDK – 将任何代理引入任何渠道 (Slack, MS Teams)
channels-sdk-demo.mp4 你的代理保持其工具、模型和业务逻辑。渠道提供了一个原生的地方,与人们合作。你的代理属于工作发生的地方。渠道将一个兼容 AG-UI 的代理连接到你团队已经使用的通信平台。代理可以理解对话,流式响应,调用工具,处理文件,渲染互动 UI,并等待人类的批准。带上你的代理 渲染原生 UI 保持人们在控制之中 使用 CopilotKit 的内置代理或连接 LangGraph、CrewAI、Mastra、Pydantic AI、Google ADK 和其他 AG-UI 代理。只需描述一次消息,并将其渲染为原生 Slack 区块工具、Teams 自适应卡和特定平台的 UI。在代理采取行动之前,直接将按钮、选择和批准门嵌入对话中。一次交互,适用于每个渠道 Slack Microsoft Teams Discord 渠道是为一个同一代理可以在每个通信表面与用户会面而构建的世界。通过 CopilotKit Intelligence 提供的受管连接,可以使用 Slack 和 Microsoft Teams,更多渠道将在路上。尝试它,先于构建 体验一个真正的渠道代理在 Slack 或 Microsoft Teams 中,无需配置应用、运行时或提供商凭据。尝试渠道 → 选择一个平台,加入体验,看看一个代理如何处理上下文、工具使用和原生渠道 UI。构建你的第一个渠道 你的代理和应用逻辑在你的基础设施中运行。CopilotKit Intelligence 管理平台连接,并将每次转发到你长期运行的渠道过程。最快路径:让你的编码代理驱动 构建一个渠道代理涉及一个项目、一个代理、一个受管渠道、一个提供商应用和一个长期运行的运行时。一个指南引导你的代理完成这一切。npx copilotkit@latest channels setup 这会安装 channels-setup 技能,打印一个提示,并复制到你的剪贴板。将其粘贴到你的编码代理中。该技能是一个指针 — 当你的代理需要时会从 copilotkit.ai/channels-guide.md 获取工作流程,因此即使安装的技能已经有几个月的历史,这些步骤仍然是最新的。该指南询问你希望使用哪个平台,Slack 还是 Microsoft Teams,以及哪个代理框架。你的代理会在你自己的已登录会话中自己驱动 Slack 和 Intelligence 控制台。如果它还没有浏览器或计算机使用工具,它会首先要求你添加一个 — 这是预期的路径,而非后备路径。你输入秘密;它来点击。或者在磁盘上安装 Slack 设置技能 跳过托管指南,将 Slack 工作流直接放入你已经在运行的编码代理中:npx copilotkit@latest skills install --skill setup-slack-channel -y -y 安装该技能而无需打开选择器。该技能仅限于 Slack — 对于 Microsoft Teams,请使用上面的指南。CLI 覆盖 Intelligence 侧: copilotkit channels add --adapter slack 声明该渠道并附加适配器, copilotkit channels status 比较你的配置、你的代码和服务器。浏览器中保留的内容是提供商侧 — 创建 Slack 应用并将其安装到工作区中 — 以及发出项目 API 密钥。没有 CLI 标志接受凭据值,因此 bot 令牌和签名密钥保留在你的 .env 和你那里。未知选项 '--skill'?一个旧版的 copilotkit — 全局安装或保留在 npx 缓存中 — 正在干扰当前 CLI。保持 @latest;这是迫使 npx 获取当前版本而不是重用已有版本的指标。以下步骤是相同的路径,手动完成。 1. 配置连接 在 CopilotKit Intelligence 中创建一个渠道并连接 Slack。保留渠道代码和项目范围的 Intelligence API 密钥以供后续步骤使用。你需要 Node.js 22 或更高版本和一个长运行的 Node 进程或容器。 2. 安装 SDK npm install @copilotkit/channels @copilotkit/runtime npm install --save-dev tsx typescript @types/node npm pkg set type=module 渠道和运行时一起提供作为一个经过测试的对。一起升级这两个包。 3. 创建监听器 下面的示例使用 CopilotKit 的内置代理。用任何 AG-UI 兼容的代理工厂替换 makeAgent,而无需更改渠道生命周期。 // channel.ts import { createServer } from "node:http" ; import { createChannel } from "@copilotkit/channels" ; import { BuiltInAgent , CopilotKitIntelligence , CopilotRuntime , } from "@copilotkit/runtime/v2" ; import { createCopilotNodeListener } from "@copilotkit/runtime/v2/node" ; function required ( name : string ) : string { const value = process . env [ name ] ; if ( ! value ) throw new Error ( `缺少必需的环境变量: ${ name } ` ) ; return value ; } function makeAgent ( threadId : string ) { const agent = new BuiltInAgent ( { model : "openai:gpt-5.4-mini" } ) ; agent . threadId = threadId ; return agent ; } const channel = createChannel ( { name : required ( "CHANNEL_CODE" ) , identifyUser : "platform" , agent : makeAgent , } ) ; channel . onMessage
本站免费、广告极少。如果觉得有帮助,可以请我们喝杯咖啡 —— 任何金额都对持续运营有实际帮助。
☕请我喝杯咖啡