用途:构建生产级 AI 聊天界面,将聊天 UI 与 AI 智能体集成,并为聊天添加认证与上下文注入。
主要能力:提供前后端架构模式。前端使用 React 的 useChatKit(),通过 HTTP/SSE 与后端 ChatKitServer 通信;后端可扩展自定义 Agent、加载会话历史、从元数据提取用户与页面上下文,并以流式方式返回响应。支持数据库持久化(SQLModel/AsyncSession、异步引擎与连接池预热)、JWT/JWKS 认证、前端自定义 fetch 拦截器注入认证头与元数据、页面上下文提取、脚本加载检测,以及 Next.js 的 httpOnly Cookie 代理与脚本加载策略。还说明 MCP 工具认证需通过系统提示传递凭据。
使用方式:后端安装 uv add chatkit-sdk agents httpx,前端安装 npm install @openai/chatkit-react。验证运行 python3 scripts/verify.py,预期输出 ✓ building-chat-interfaces skill ready。
适用场景:需要将聊天界面接入自有后端与 AI 智能体、加入登录认证、注入用户或页面上下文、处理 httpOnly Cookie 或 SSE 流式响应的项目。
限制:资料未提供收费、价格、平台支持范围与效果数据;部分实现依赖 ChatKit、agents 等特定库,需按文档配置。若验证失败,检查 references/ 目录是否包含 chatkit-integration-patterns.md。