用途:构建生产级 AI 聊天界面,将 ChatKit 聊天 UI 与自定义后端、AI 智能体、认证和上下文注入集成。
主要能力:后端提供 ChatKitServer 自定义智能体(respond()、stream_agent_response、对话历史注入指令、store 持久化)、SQLModel/异步引擎与连接池预热、JWT/JWKS 认证。前端提供 useChatKit() 自定义 fetch 拦截器,注入认证头与 userId、userInfo、pageContext 元数据,并包含页面上下文提取与脚本加载检测。还涵盖 Next.js 集成(httpOnly Cookie 代理转发 SSE 流、beforeInteractive 脚本加载)及 MCP 工具鉴权(通过系统提示传递 user_id 与 access_token)。
使用方式:后端 Python 安装 uv add chatkit-sdk agents httpx;前端 React 安装 npm install @openai/chatkit-react。验证运行 python3 scripts/verify.py,预期输出 ✓ building-chat-interfaces skill ready;失败时检查 references/ 下的 chatkit-integration-patterns.md。
适用场景:需要为自有应用添加具备登录鉴权和页面感知的 AI 聊天助手,或对接智能体与 MCP 工具。
限制与常见问题:历史需手动拼入系统提示,否则智能体失忆;上下文需经请求元数据并在后端提取;web 组件脚本需等待加载后再渲染;认证头缺失会导致后端拒绝;httpOnly Cookie 需服务端代理;首次请求可能因连接池出现延迟,可预热缓解。MCP 协议不转发认证头,需通过提示传递凭据。资料未提供收费、平台兼容范围等细节。