用途:本技能用于指导开发者用 OpenAI ChatKit SDK 搭建可上线的 AI 聊天应用,覆盖聊天 UI、多会话系统以及接入 AI 智能体(OpenAI、Gemini、Claude、Ollama 等)。
主要能力:给出前端(@openai/chatkit-react,或 @openai/chatkit 原生 JS)、后端(FastAPI + ChatKitServer)与 Agent(LLM)三层架构示例;提供最小可运行服务端与 React 前端片段;支持流式响应、多轮对话,以及通过 function_tool 添加工具、接入 MCP 服务器与托管工具;支持 InMemory 与 PostgreSQL 存储,并区分单用户与多用户会话。
使用方式:用 python scripts/init_chatkit_project.py <name> --provider <x> 创建项目;后端依赖用 uv add openai-chatkit openai-agents fastapi "uvicorn[standard]" 安装,非 OpenAI 模型加 "openai-agents[litellm]",PostgreSQL 持久化加 asyncpg;前端用 npm install @openai/chatkit-react。启动命令为 uv run uvicorn main:app --reload --port 8000,前端在 useChatKit 中配置 api.url 与 domainKey。生成 PostgreSQL 存储可运行 python scripts/create_postgres_store.py <file> [--multi-user]。
适用场景:需要快速搭建生产级 AI 聊天界面、多用户会话系统,或把多种 LLM 接入统一聊天前端的项目。
限制与注意:ChatKit 处于早期阶段,生产环境建议锁定版本,资料给出的测试版本为 openai-chatkit 0.1.x、openai-agents 0.0.x、@openai/chatkit-react 0.1.x、next 16.x;开发用 domainKey 为 local-dev,生产需注册;CORS 生产环境需限制来源;使用 Runner.run_streamed() 才能流式输出,加载历史需 order="asc";API Key 应放在环境变量而非硬编码。具体价格、性能与实际效果暂未提供。