CopilotKit channels-slack 架构深度解析从 Bolt 入口到 Block Kit 出站的 PlatformAdapter 设计【免费下载链接】CopilotKitThe Frontend Stack for Agents Generative UI. React, Angular, Mobile, Slack, and more. Makers of the AG-UI Protocol项目地址: https://gitcode.com/GitHub_Trending/co/CopilotKitcopilotkit/channels-slack是 CopilotKit 通道体系copilotkit/channelsumbrella中连接 Slack 工作区与任意 AG-UI Agent 的适配器。它通过 BoltSocket Mode完成入口ingress、以 Block Kit 完成出站egress并实现文本流式输出、不透明 ID 交互opaque-id interactions与人工介入HITL。读完本文你将理解该包的分层边界、PlatformAdapter接口的每个成员、一次 Slack 消息从监听到工具调用再到回复流式的完整生命周期以及原生流式 API、Assistant 面板等 Agent 原生能力在架构中的落点。架构总览谁负责什么copilotkit/channels-slack的定位非常明确——它只负责「Slack 相关的一切」其余全部交给通道引擎。其依赖关系如下应用作者通过产品级 umbrella 包copilotkit/channels使用本包SlackAdapter导入并实现来自copilotkit/channels-core的PlatformAdapter接口通道引擎拥有与平台无关的编排逻辑事件处理器handlers、run/tool/interrupt 循环、JSX 动作绑定与ActionStore本包拥有全部 Slack 专属逻辑Bolt 入口、Block Kit 出站、流式输出与不透明 ID 交互。这条边界的核心目标是让Agent 完全感知不到 Slack 的存在它接收普通的 AG-UI 输入发出普通的 AG-UI 事件而chat.update节流、mrkdwn 翻译、消息分块、中断捕获、block_actions路由等 Slack 机制全部封在PlatformAdapter接口背后。设计目标五个边界原则ARCHITECTURE.md 明确了五个设计目标理解它们是读懂整个包源码的钥匙Agent 不感知 SlackAgent 只与 AG-UI 协议交互收到标准输入、发出标准事件Slack 机制不渗入引擎所有 Slack 细节都在PlatformAdapter接口之后一文件一职责每个源文件只做一件事见下文「SDK 文件一览」故障被隔离一次失败的chat.update不会让整个 run 崩溃不持有 Slack 侧持久状态Slack 自身是事实来源conversations.replies/conversations.history会话存储conversation store在每次回复时从 Slack 现场重建该轮agent.messages。这意味着重启对会话历史是天然安全的。核心边界PlatformAdapterSlackAdapter通过工厂函数slack(opts)构造实现PlatformAdapter。该接口定义于 packages/channels-core/src/platform-adapter.ts是整个通道生态的契约层。SlackAdapter (copilotkit/channels-slack) └── imports / implements ──► copilotkit/channels-core: PlatformAdapter copilotkit/channels 是产品级 umbrella不是适配器依赖。SlackAdapter实现的成员对应 adapter.ts 源码platform、capabilities、ackDeadlineMs声明平台标识与能力面。源码中可见supportsStreaming: true、maxBlocksPerMessage: 50与 Slack 每条消息 50 block 上限一致、modal/typing/reactions 为falsesupportsSuggestedPrompts/supportsThreadTitle由是否启用 Assistant 面板计算得出ackDeadlineMs 3000对应 Slack 交互回调 3 秒 ack 时限start(sink)/stop()启动/停止 Bolt 应用把归一化后的事件推入引擎的IngressSinkonTurn/onInteraction/onCommand/onThreadStarted。IngressSink的完整接口定义在platform-adapter.ts中还包含onWelcome、onReaction、onModalSubmit、onModalClose等事件口setSuggestedPrompts/setThreadTitle支撑能力门控的thread.setSuggestedPrompts/thread.setTitle底层走assistant.threads.*APIrender(ir)IR → Block Kit调用renderBlockKitpost/update/stream/delete经 Slack Web client 的出站操作createRunRenderer(target)为一次 run 创建 AG-UIRunRendererdecodeInteraction(raw)原生block_actions载荷 →InteractionEventlookupUser(query)目录搜索用于提及解析支撑thread.lookupUsergetMessages(target)经conversations.replies读取线程消息支撑thread.getMessagespostFile(target, args)经files.uploadV2上传文件支撑thread.postFileconversationStoreSlack 支撑的getOrCreate→AgentSession负责为每个会话解析或创建Agent 会话。引擎通过start时交给适配器的IngressSink驱动入口sink.onTurn/sink.onInteraction并通过上述方法驱动出口。请求生命周期一条 Slack 消息如何变成一次 Agent runSlack event ──► attachSlackListener ──► IngressSink.onTurn(IncomingTurn) │ ▼ copilotkit/channels-core: Thread │ thread.runAgent() ▼ runAgentLoop ┌──────────────────────────────────────┴──────────────────────────────┐ │ agent.runAgent(..., RunRenderer.subscriber) │ │ • event-renderer streams TEXT_MESSAGE_* → chat.update (Block Kit) │ │ • captures frontend tool calls on_interrupt custom events │ └──────────────────────────────────────┬──────────────────────────────┘ │ ┌─────────────────────────────────┼─────────────────────────────┐ ▼ (captured tool call) ▼ (captured interrupt) ▼ (done) tool.handler(args, ctx) onInterrupt handler finish renders JSX via thread.post posts picker via thread.post → renderSlackMessage/renderBlockKit → awaitChoice / thread.resume(value) → Block Kit posted to Slack re-enters runAgentLoop with forwardedProps.command on resume入口IngressattachSlackListenerslack-listener.ts 是 Slack 事件模型与引擎领域之间的翻译层。它会过滤subtype事件编辑、加入、频道重命名等、bot 消息任何bot_id包括机器人自己的帖子、未跟踪线程的消息、以及伴随每次app_mention同时到达的message.channels事件通过文本中是否含botUserId识别去重。随后发出归一化的 turn适配器把发送者解析为ProviderActor按 id 缓存并以conversationKey经conversationKeyOf、replyTarget、userText、user调用sink.onTurn。入口的触发面与默认行为总结如下Surface默认行为选项私信message.im回复respondTo.directMessagesApp 提及app_mention线程内回复respondTo.appMentions/appMentions.reply频道/私密频道普通回复除非被提及否则忽略respondTo.threadReplies: afterBotReply旧版续接Assistant 面板独立的默认开启 APIassistant不受respondTo控制斜杠命令、表情回应、交互显式触发路径不受respondTo控制运行与渲染Run / RendercreateRunRendererthread.runAgent从conversationStore解析该会话的AgentSession创建createRunRenderer(target)然后运行runAgentLoop。渲染器event-renderer.ts订阅 AG-UI 事件在首个TEXT_MESSAGE_CONTENT时惰性创建流累积增量可选地显示:wrench:/:white_check_mark:工具状态行showToolStatus捕获前端工具调用与on_interrupt自定义事件供循环在每次runAgent之后读取。RunRenderer接口定义于platform-adapter.ts暴露subscriber、markInterrupted()、getCapturedToolCalls()、getPendingInterrupt()、clearPendingInterrupt()以及可选的finish()钩子——finish()让跨runAgent迭代保持打开的 turn 级资源例如单条原生流式消息在 turn 结束时被最终确定。工具Tools无 Slack 专属上下文当 Agent 调用注册的前端工具时循环先用 Standard Schema 校验参数然后调用tool.handler(args, ctx)。ctx是共享的ChannelToolContext{ thread, message?, user?, signal?, platform }——没有 Slack 专属上下文。工具要触达 Slack 能力只能通过适配器支撑的、能力门控的thread方法getMessagesconversations.replies、lookupUser、postFilefiles.uploadV2。渲染类工具用thread.post(Card .../)渲染 JSX经由引擎的动作绑定后走renderSlackMessage/renderBlockKit→ Block Kit。postFile的签名{ bytes, filename, title?, altText? }与返回类型都在PlatformAdapter接口中定义能力门控保证不支持上传的适配器返回{ ok: false, error }而不是抛错。人工介入HITL与中断thread.awaitChoice(Picker .../)发布一个选择器并阻塞引擎的等待器直到该会话中一次点击将其解析被捕获的 Agent 中断分发给注册的onInterrupt处理器处理器发布选择器其按钮onClick调用thread.resume(value)循环以forwardedProps.command重新进入runAgentLoop。每次block_actions点击都会先被立即 ack在ackDeadlineMs 3000的 ≤3s 时限内避免 Slack 判定超时。交互Interactions不透明 ID 与冷路径重渲染app.action(/.*/)在 ≤3s 内 ack 每次点击随后decodeInteraction从block_actions载荷中取出不透明铸造 idck:…、可选的微小bind()值与消息引用构建InteractionEvent。令牌只携带不透明 id不含 props 或密钥。引擎解析它命中的可能是等待中的 HITL 等待器或走ActionRegistry.dispatch——热缓存命中或走冷路径重渲染再水合加载快照、以冻结的 props 重渲染命名组件、重走到处理器路径。重启后未命中则降级为「此动作已过期」。这与引擎侧ActionStore在 v1 中仅为内存态直接相关详见copilotkit/channelsREADME。Agent 原生 Slack API面板与原生流式默认开启安全降级有两族 Agent 级 Slack API 被接入默认开启且各自安全降级。原生流式Native streamingNativeMessageStreamnative-stream.ts 中的NativeMessageStream实现了与MessageStream相同的append(fullText)/finish()契约因此 event-renderer 的文本流与adapter.stream()对传输层不敏感。它驱动chat.startStream/appendStream原始markdown_text不做 mrkdwn 翻译/stopStream约 600ms 节流源码注释说明chat.appendStream属于 Tier 4 限速100/min600ms≈100/min在明显比旧版chat.update路径约 1 次/秒更流畅的同时保留舒适余量整轮输出进单条消息每步产生的文本都累积进同一条消息APPEND_CHAR_LIMIT 12000即 Slack 对单次 append 的 12k 字符上限无累计上限因此不做多消息拆分结构化块交错appendChunk()在冲刷完待发文本后交错插入结构化AnyChunk如工具进度用的task_update保证顺序不乱finish(blocks)收尾最终确定消息可选附带尾部 Block Kit 行如反馈按钮。附带说明DEFAULT_MESSAGE_BYTE_LIMIT 11000以UTF-8 字节计——因为 Slack 的每条消息累计上限未公开且生产环境观察到msg_too_long在约 11.6k 字符时出现按字节计在 CJK3 字节/字符场景更安全turn 作用域event-renderer 让流跨runAgent迭代保持并通过引擎的RunRenderer.finish()钩子关闭。使用条件凡存在threadTs的地方都会用原生流式平面 DM 与首次startStream失败的场景自动回退到旧版chat.update传输工作区在内存中被标记为 legacy后续流跳过原生路径结构化块失败则把工具进度降级为:wrench:行显式传streaming: legacy强制走旧传输。回退是透明的——「选择开启永不弄坏机器人」首次startStream失败即标记工作区为 legacy 并用旧方式重做该流。反馈行Feedback rowopt-in传入feedback时流式回复在最终确定时附带原生feedback_buttons行context_actions构建于 render/block-kit.ts含FEEDBACK_ACTION_ID常量通过stopStream附加它是唯一接受blocks的流式调用因此反馈行只出现在原生路径旧版回退不显示。适配器在app.action中按FEEDBACK_ACTION_ID拦截这些点击并直接路由到onFeedback绕过引擎的交互分发。Assistant 面板Assistant paneattachAssistantassistant.ts 中的attachAssistant注册 Bolt 的Assistant中间件是面板事件的唯一所有者收到assistant_thread_started时先应用静态默认问候语 建议提示词再发出sink.onThreadStarted引擎处理器在其上叠加永不相争面板用户消息恰好变成一次sink.onTurn作用域限定在面板线程channelId::threadTs并自动用第一条消息起标题面板线程在内存中被跟踪使slack-listener.ts中一行代码的守卫跳过Assistant中间件已拥有的线程化message.im事件——每条面板消息恰好一轮普通线程化私信不受影响面板线程中run 生命周期驱动原生 composer 状态assistant.threads.setStatus而不是占位消息 /:wrench:消息。值得注意的设计决策状态不是Thread方法——它由渲染器从 run/tool 生命周期管理只有提示词与标题只有作者知道才获得Thread方法。保留机制Preserved mechanics以下文件从重构前的包中延续而来仅做轻度适配文件职责slack-listener.tsSlack 事件 → 归一化 turn入口过滤conversation-store.tsSlack 支撑的历史重建折叠分块的 bot 回复message-stream.ts每条消息的chat.update队列 ≥800ms 节流无更新竞态chunked-message-stream.ts多消息分块保持围栏块完整逐块转换auto-close-streaming.ts流中自动闭合悬空 markdown 括号幂等markdown-to-mrkdwn.tsGFM Markdown → Slack mrkdwn围栏内表格列对齐download-files.ts入站文件下载 → AG-UI 多模态内容部件sanitizing-http-agent.ts清理出站请求的 HTTP agentChannels 默认已做清理此导出已标记 deprecatedSDK 文件一览src/ ├── index.ts # public exports ├── adapter.ts # slack() factory SlackAdapter (PlatformAdapter impl) Bolt wiring ├── assistant.ts # attachAssistant: Bolt Assistant middleware ⇄ engine sink (pane events) ├── native-stream.ts # NativeMessageStream: chat.startStream/appendStream/stopStream ( legacy fallback) ├── event-renderer.ts # createRunRenderer: AG-UI subscriber → stream tool/interrupt capture pane status ├── interaction.ts # decodeInteraction (opaque id) conversationKeyOf ├── render/ │ ├── block-kit.ts # renderBlockKit / renderSlackMessage (IR → Block Kit) │ └── budget.ts # SLACK_LIMITS truncate/clamp degradation ├── slack-listener.ts # Slack events → IncomingTurn (filters) ├── conversation-store.ts # Slack-backed conversation reconstruction ├── chunked-message-stream.ts # multi-message chunking mrkdwn transform ├── message-stream.ts # per-message chat.update queue throttle ├── markdown-to-mrkdwn.ts # md → Slack mrkdwn ├── auto-close-streaming.ts # mid-stream bracket closer ├── download-files.ts # inbound file → multimodal content parts ├── sanitizing-http-agent.ts # sanitizing AG-UI HTTP agent ├── built-in-tools.ts # lookup_slack_user defaultSlackTools (as ChannelTools) ├── built-in-context.ts # tagging / mrkdwn / convo-model context entries └── types.ts # IncomingTurn, ReplyTarget, ConversationKey, DM_SCOPE, SlackAssistantOptions其中render/budget.ts维护SLACK_LIMITS——每元素预算表blocksPerMessage: 50、sectionText: 3000、headerText: 150、fieldsPerSection: 10、fieldText: 2000、actionsElements: 25、contextElements: 10、buttonText: 75、actionId: 255、buttonValue: 2000、selectOptions: 100。渲染器对超限内容采取「截断带溢出标记 / 夹紧」的降级策略绝不静默丢弃内容。刻意不抽象的部分不抽象 Bolt如果使用本包你就是在直接与 Slack 对话无 Slack 侧持久状态下一轮从 Slack 历史重建上下文重启对会话历史天然安全。但引擎的ActionStore在 v1 中独立为内存态因此内联交互处理器在重启后会过期——这是copilotkit/channelsREADME产品级 umbrella 文档中明确说明的已知边界。这两条边界之外从slack(opts)工厂、respondTo路由策略到defaultSlackTools/defaultSlackContext内置工具与上下文再到示例运行可运行的端到端 demo 见 examples/slack完整的配置与使用方式可进一步阅读 packages/channels-slack/README.md。【免费下载链接】CopilotKitThe Frontend Stack for Agents Generative UI. React, Angular, Mobile, Slack, and more. Makers of the AG-UI Protocol项目地址: https://gitcode.com/GitHub_Trending/co/CopilotKit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CopilotKit channels-slack 架构深度解析：从 Bolt 入口到 Block Kit 出站的 PlatformAdapter 设计
CopilotKit channels-slack 架构深度解析从 Bolt 入口到 Block Kit 出站的 PlatformAdapter 设计【免费下载链接】CopilotKitThe Frontend Stack for Agents Generative UI. React, Angular, Mobile, Slack, and more. Makers of the AG-UI Protocol项目地址: https://gitcode.com/GitHub_Trending/co/CopilotKitcopilotkit/channels-slack是 CopilotKit 通道体系copilotkit/channelsumbrella中连接 Slack 工作区与任意 AG-UI Agent 的适配器。它通过 BoltSocket Mode完成入口ingress、以 Block Kit 完成出站egress并实现文本流式输出、不透明 ID 交互opaque-id interactions与人工介入HITL。读完本文你将理解该包的分层边界、PlatformAdapter接口的每个成员、一次 Slack 消息从监听到工具调用再到回复流式的完整生命周期以及原生流式 API、Assistant 面板等 Agent 原生能力在架构中的落点。架构总览谁负责什么copilotkit/channels-slack的定位非常明确——它只负责「Slack 相关的一切」其余全部交给通道引擎。其依赖关系如下应用作者通过产品级 umbrella 包copilotkit/channels使用本包SlackAdapter导入并实现来自copilotkit/channels-core的PlatformAdapter接口通道引擎拥有与平台无关的编排逻辑事件处理器handlers、run/tool/interrupt 循环、JSX 动作绑定与ActionStore本包拥有全部 Slack 专属逻辑Bolt 入口、Block Kit 出站、流式输出与不透明 ID 交互。这条边界的核心目标是让Agent 完全感知不到 Slack 的存在它接收普通的 AG-UI 输入发出普通的 AG-UI 事件而chat.update节流、mrkdwn 翻译、消息分块、中断捕获、block_actions路由等 Slack 机制全部封在PlatformAdapter接口背后。设计目标五个边界原则ARCHITECTURE.md 明确了五个设计目标理解它们是读懂整个包源码的钥匙Agent 不感知 SlackAgent 只与 AG-UI 协议交互收到标准输入、发出标准事件Slack 机制不渗入引擎所有 Slack 细节都在PlatformAdapter接口之后一文件一职责每个源文件只做一件事见下文「SDK 文件一览」故障被隔离一次失败的chat.update不会让整个 run 崩溃不持有 Slack 侧持久状态Slack 自身是事实来源conversations.replies/conversations.history会话存储conversation store在每次回复时从 Slack 现场重建该轮agent.messages。这意味着重启对会话历史是天然安全的。核心边界PlatformAdapterSlackAdapter通过工厂函数slack(opts)构造实现PlatformAdapter。该接口定义于 packages/channels-core/src/platform-adapter.ts是整个通道生态的契约层。SlackAdapter (copilotkit/channels-slack) └── imports / implements ──► copilotkit/channels-core: PlatformAdapter copilotkit/channels 是产品级 umbrella不是适配器依赖。SlackAdapter实现的成员对应 adapter.ts 源码platform、capabilities、ackDeadlineMs声明平台标识与能力面。源码中可见supportsStreaming: true、maxBlocksPerMessage: 50与 Slack 每条消息 50 block 上限一致、modal/typing/reactions 为falsesupportsSuggestedPrompts/supportsThreadTitle由是否启用 Assistant 面板计算得出ackDeadlineMs 3000对应 Slack 交互回调 3 秒 ack 时限start(sink)/stop()启动/停止 Bolt 应用把归一化后的事件推入引擎的IngressSinkonTurn/onInteraction/onCommand/onThreadStarted。IngressSink的完整接口定义在platform-adapter.ts中还包含onWelcome、onReaction、onModalSubmit、onModalClose等事件口setSuggestedPrompts/setThreadTitle支撑能力门控的thread.setSuggestedPrompts/thread.setTitle底层走assistant.threads.*APIrender(ir)IR → Block Kit调用renderBlockKitpost/update/stream/delete经 Slack Web client 的出站操作createRunRenderer(target)为一次 run 创建 AG-UIRunRendererdecodeInteraction(raw)原生block_actions载荷 →InteractionEventlookupUser(query)目录搜索用于提及解析支撑thread.lookupUsergetMessages(target)经conversations.replies读取线程消息支撑thread.getMessagespostFile(target, args)经files.uploadV2上传文件支撑thread.postFileconversationStoreSlack 支撑的getOrCreate→AgentSession负责为每个会话解析或创建Agent 会话。引擎通过start时交给适配器的IngressSink驱动入口sink.onTurn/sink.onInteraction并通过上述方法驱动出口。请求生命周期一条 Slack 消息如何变成一次 Agent runSlack event ──► attachSlackListener ──► IngressSink.onTurn(IncomingTurn) │ ▼ copilotkit/channels-core: Thread │ thread.runAgent() ▼ runAgentLoop ┌──────────────────────────────────────┴──────────────────────────────┐ │ agent.runAgent(..., RunRenderer.subscriber) │ │ • event-renderer streams TEXT_MESSAGE_* → chat.update (Block Kit) │ │ • captures frontend tool calls on_interrupt custom events │ └──────────────────────────────────────┬──────────────────────────────┘ │ ┌─────────────────────────────────┼─────────────────────────────┐ ▼ (captured tool call) ▼ (captured interrupt) ▼ (done) tool.handler(args, ctx) onInterrupt handler finish renders JSX via thread.post posts picker via thread.post → renderSlackMessage/renderBlockKit → awaitChoice / thread.resume(value) → Block Kit posted to Slack re-enters runAgentLoop with forwardedProps.command on resume入口IngressattachSlackListenerslack-listener.ts 是 Slack 事件模型与引擎领域之间的翻译层。它会过滤subtype事件编辑、加入、频道重命名等、bot 消息任何bot_id包括机器人自己的帖子、未跟踪线程的消息、以及伴随每次app_mention同时到达的message.channels事件通过文本中是否含botUserId识别去重。随后发出归一化的 turn适配器把发送者解析为ProviderActor按 id 缓存并以conversationKey经conversationKeyOf、replyTarget、userText、user调用sink.onTurn。入口的触发面与默认行为总结如下Surface默认行为选项私信message.im回复respondTo.directMessagesApp 提及app_mention线程内回复respondTo.appMentions/appMentions.reply频道/私密频道普通回复除非被提及否则忽略respondTo.threadReplies: afterBotReply旧版续接Assistant 面板独立的默认开启 APIassistant不受respondTo控制斜杠命令、表情回应、交互显式触发路径不受respondTo控制运行与渲染Run / RendercreateRunRendererthread.runAgent从conversationStore解析该会话的AgentSession创建createRunRenderer(target)然后运行runAgentLoop。渲染器event-renderer.ts订阅 AG-UI 事件在首个TEXT_MESSAGE_CONTENT时惰性创建流累积增量可选地显示:wrench:/:white_check_mark:工具状态行showToolStatus捕获前端工具调用与on_interrupt自定义事件供循环在每次runAgent之后读取。RunRenderer接口定义于platform-adapter.ts暴露subscriber、markInterrupted()、getCapturedToolCalls()、getPendingInterrupt()、clearPendingInterrupt()以及可选的finish()钩子——finish()让跨runAgent迭代保持打开的 turn 级资源例如单条原生流式消息在 turn 结束时被最终确定。工具Tools无 Slack 专属上下文当 Agent 调用注册的前端工具时循环先用 Standard Schema 校验参数然后调用tool.handler(args, ctx)。ctx是共享的ChannelToolContext{ thread, message?, user?, signal?, platform }——没有 Slack 专属上下文。工具要触达 Slack 能力只能通过适配器支撑的、能力门控的thread方法getMessagesconversations.replies、lookupUser、postFilefiles.uploadV2。渲染类工具用thread.post(Card .../)渲染 JSX经由引擎的动作绑定后走renderSlackMessage/renderBlockKit→ Block Kit。postFile的签名{ bytes, filename, title?, altText? }与返回类型都在PlatformAdapter接口中定义能力门控保证不支持上传的适配器返回{ ok: false, error }而不是抛错。人工介入HITL与中断thread.awaitChoice(Picker .../)发布一个选择器并阻塞引擎的等待器直到该会话中一次点击将其解析被捕获的 Agent 中断分发给注册的onInterrupt处理器处理器发布选择器其按钮onClick调用thread.resume(value)循环以forwardedProps.command重新进入runAgentLoop。每次block_actions点击都会先被立即 ack在ackDeadlineMs 3000的 ≤3s 时限内避免 Slack 判定超时。交互Interactions不透明 ID 与冷路径重渲染app.action(/.*/)在 ≤3s 内 ack 每次点击随后decodeInteraction从block_actions载荷中取出不透明铸造 idck:…、可选的微小bind()值与消息引用构建InteractionEvent。令牌只携带不透明 id不含 props 或密钥。引擎解析它命中的可能是等待中的 HITL 等待器或走ActionRegistry.dispatch——热缓存命中或走冷路径重渲染再水合加载快照、以冻结的 props 重渲染命名组件、重走到处理器路径。重启后未命中则降级为「此动作已过期」。这与引擎侧ActionStore在 v1 中仅为内存态直接相关详见copilotkit/channelsREADME。Agent 原生 Slack API面板与原生流式默认开启安全降级有两族 Agent 级 Slack API 被接入默认开启且各自安全降级。原生流式Native streamingNativeMessageStreamnative-stream.ts 中的NativeMessageStream实现了与MessageStream相同的append(fullText)/finish()契约因此 event-renderer 的文本流与adapter.stream()对传输层不敏感。它驱动chat.startStream/appendStream原始markdown_text不做 mrkdwn 翻译/stopStream约 600ms 节流源码注释说明chat.appendStream属于 Tier 4 限速100/min600ms≈100/min在明显比旧版chat.update路径约 1 次/秒更流畅的同时保留舒适余量整轮输出进单条消息每步产生的文本都累积进同一条消息APPEND_CHAR_LIMIT 12000即 Slack 对单次 append 的 12k 字符上限无累计上限因此不做多消息拆分结构化块交错appendChunk()在冲刷完待发文本后交错插入结构化AnyChunk如工具进度用的task_update保证顺序不乱finish(blocks)收尾最终确定消息可选附带尾部 Block Kit 行如反馈按钮。附带说明DEFAULT_MESSAGE_BYTE_LIMIT 11000以UTF-8 字节计——因为 Slack 的每条消息累计上限未公开且生产环境观察到msg_too_long在约 11.6k 字符时出现按字节计在 CJK3 字节/字符场景更安全turn 作用域event-renderer 让流跨runAgent迭代保持并通过引擎的RunRenderer.finish()钩子关闭。使用条件凡存在threadTs的地方都会用原生流式平面 DM 与首次startStream失败的场景自动回退到旧版chat.update传输工作区在内存中被标记为 legacy后续流跳过原生路径结构化块失败则把工具进度降级为:wrench:行显式传streaming: legacy强制走旧传输。回退是透明的——「选择开启永不弄坏机器人」首次startStream失败即标记工作区为 legacy 并用旧方式重做该流。反馈行Feedback rowopt-in传入feedback时流式回复在最终确定时附带原生feedback_buttons行context_actions构建于 render/block-kit.ts含FEEDBACK_ACTION_ID常量通过stopStream附加它是唯一接受blocks的流式调用因此反馈行只出现在原生路径旧版回退不显示。适配器在app.action中按FEEDBACK_ACTION_ID拦截这些点击并直接路由到onFeedback绕过引擎的交互分发。Assistant 面板Assistant paneattachAssistantassistant.ts 中的attachAssistant注册 Bolt 的Assistant中间件是面板事件的唯一所有者收到assistant_thread_started时先应用静态默认问候语 建议提示词再发出sink.onThreadStarted引擎处理器在其上叠加永不相争面板用户消息恰好变成一次sink.onTurn作用域限定在面板线程channelId::threadTs并自动用第一条消息起标题面板线程在内存中被跟踪使slack-listener.ts中一行代码的守卫跳过Assistant中间件已拥有的线程化message.im事件——每条面板消息恰好一轮普通线程化私信不受影响面板线程中run 生命周期驱动原生 composer 状态assistant.threads.setStatus而不是占位消息 /:wrench:消息。值得注意的设计决策状态不是Thread方法——它由渲染器从 run/tool 生命周期管理只有提示词与标题只有作者知道才获得Thread方法。保留机制Preserved mechanics以下文件从重构前的包中延续而来仅做轻度适配文件职责slack-listener.tsSlack 事件 → 归一化 turn入口过滤conversation-store.tsSlack 支撑的历史重建折叠分块的 bot 回复message-stream.ts每条消息的chat.update队列 ≥800ms 节流无更新竞态chunked-message-stream.ts多消息分块保持围栏块完整逐块转换auto-close-streaming.ts流中自动闭合悬空 markdown 括号幂等markdown-to-mrkdwn.tsGFM Markdown → Slack mrkdwn围栏内表格列对齐download-files.ts入站文件下载 → AG-UI 多模态内容部件sanitizing-http-agent.ts清理出站请求的 HTTP agentChannels 默认已做清理此导出已标记 deprecatedSDK 文件一览src/ ├── index.ts # public exports ├── adapter.ts # slack() factory SlackAdapter (PlatformAdapter impl) Bolt wiring ├── assistant.ts # attachAssistant: Bolt Assistant middleware ⇄ engine sink (pane events) ├── native-stream.ts # NativeMessageStream: chat.startStream/appendStream/stopStream ( legacy fallback) ├── event-renderer.ts # createRunRenderer: AG-UI subscriber → stream tool/interrupt capture pane status ├── interaction.ts # decodeInteraction (opaque id) conversationKeyOf ├── render/ │ ├── block-kit.ts # renderBlockKit / renderSlackMessage (IR → Block Kit) │ └── budget.ts # SLACK_LIMITS truncate/clamp degradation ├── slack-listener.ts # Slack events → IncomingTurn (filters) ├── conversation-store.ts # Slack-backed conversation reconstruction ├── chunked-message-stream.ts # multi-message chunking mrkdwn transform ├── message-stream.ts # per-message chat.update queue throttle ├── markdown-to-mrkdwn.ts # md → Slack mrkdwn ├── auto-close-streaming.ts # mid-stream bracket closer ├── download-files.ts # inbound file → multimodal content parts ├── sanitizing-http-agent.ts # sanitizing AG-UI HTTP agent ├── built-in-tools.ts # lookup_slack_user defaultSlackTools (as ChannelTools) ├── built-in-context.ts # tagging / mrkdwn / convo-model context entries └── types.ts # IncomingTurn, ReplyTarget, ConversationKey, DM_SCOPE, SlackAssistantOptions其中render/budget.ts维护SLACK_LIMITS——每元素预算表blocksPerMessage: 50、sectionText: 3000、headerText: 150、fieldsPerSection: 10、fieldText: 2000、actionsElements: 25、contextElements: 10、buttonText: 75、actionId: 255、buttonValue: 2000、selectOptions: 100。渲染器对超限内容采取「截断带溢出标记 / 夹紧」的降级策略绝不静默丢弃内容。刻意不抽象的部分不抽象 Bolt如果使用本包你就是在直接与 Slack 对话无 Slack 侧持久状态下一轮从 Slack 历史重建上下文重启对会话历史天然安全。但引擎的ActionStore在 v1 中独立为内存态因此内联交互处理器在重启后会过期——这是copilotkit/channelsREADME产品级 umbrella 文档中明确说明的已知边界。这两条边界之外从slack(opts)工厂、respondTo路由策略到defaultSlackTools/defaultSlackContext内置工具与上下文再到示例运行可运行的端到端 demo 见 examples/slack完整的配置与使用方式可进一步阅读 packages/channels-slack/README.md。【免费下载链接】CopilotKitThe Frontend Stack for Agents Generative UI. React, Angular, Mobile, Slack, and more. Makers of the AG-UI Protocol项目地址: https://gitcode.com/GitHub_Trending/co/CopilotKit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考