@volcengine/chatkit

给 Agent 应用的
对话界面

适配器对接后端，配置与插槽定制界面，一个包装齐。右边就是它本身：一个用示例数据运行的真实实例，发一句话试试。

$npm install @volcengine/chatkit

npm 当前为 0.1.0-alpha.1 预览版；新功能请核对实际安装版本。

在线示例 · 示例数据查看源码新窗口打开

按后端协议选择适配器：Agent Development Kit A2A OpenAI 兼容接口 Hermes 自有协议本地开发和演示可以使用内置的 Mock 适配器

接入方只面对三件事

createXxxAdapter(...)适配器

对接后端。按后端实际能力接入历史、重新生成、编辑后重发，再用配置控制显示。

settings · features配置

settings 只填值；features 管内置功能，满足能力和配置条件时显示；部分控件支持调整位置。

slots · renderers插槽

slots 按位置放业务组件，聊天区 17 个固定位置；renderers 按类型决定业务卡片、工具、失败卡片怎么显示。

会话列表与后台运行

一个适配器服务所有会话；在页面内切换会话后，原会话继续接收回答；切回来可查看已收到的内容。

流式对话与执行流

思考和工具调用合并成一个可折叠的执行流，失败、停止都有明确的结束方式。

回答操作与划词追问

后端支持时可重新生成回答或编辑提问后重发；选中回答里的一段文字，带着它继续追问。

业务功能用插槽实现

没有插件机制。技能选择、知识库、收藏与分享，用插槽、onSend 和公开 hooks 实现。

事件与指标

SDK 不主动发送遥测；提供运行事件与首字延迟、完成率等计算口径，统计结果取决于接入方的采集、去重和归并。

主题与样式隔离

用 --chatkit-* 变量定制主题；包样式位于 @layer chatkit，接入时需检查页面全局样式的覆盖关系。