用途:构建生产级 AI 聊天界面,将聊天 UI 与 AI 智能体集成,并为聊天添加认证与上下文注入。
主要能力:前端基于 React 的 useChatKit(),后端基于 Python 的 ChatKitServer,通过 HTTP/SSE 通信。支持自定义 fetch 拦截器注入认证头与页面上下文;支持 JWT/JWKS 鉴权;支持数据库持久化与连接池预热;支持 Next.js httpOnly Cookie 代理与脚本加载检测;支持 MCP 工具认证(通过系统提示传递凭据)。
使用方式:后端安装 uv add chatkit-sdk agents httpx,前端安装 npm install @openai/chatkit-react。后端继承 ChatKitServer 实现 respond(),加载历史、提取元数据并流式返回智能体响应;前端用 useChatKit 配置 api.url、domainKey 与自定义 fetch。Next.js 中脚本需用 strategy="beforeInteractive" 加载。验证运行 python3 scripts/verify.py。
适用场景:需要将聊天界面接入自有后端与智能体的 Web 应用,尤其是涉及登录鉴权、页面上下文感知和流式响应的场景。
限制:资料未提供收费、价格、平台支持范围与效果数据;MCP 协议不转发认证头,需通过系统提示传递凭据;httpOnly Cookie 需服务端代理;首次请求可能因连接池未预热而变慢。