SuperAPI AI 工具集

chatkit-botbuilder

编程与开发

查看项目

更新于 10-15 16:45

技能介绍

用途:指导开发者用 OpenAI ChatKit 框架搭建生产级聊天机器人,将 Agents SDK 的对话处理能力与 MCP 工具的真实任务执行、自定义后端结合。

主要能力:集成 OpenAI Agents SDK 处理对话;连接 MCP(Model Context Protocol)工具执行真实操作;构建支持完整协议的 FastAPI 后端;通过 JWT 实现多用户隔离;在机器人执行动作时实时刷新 UI;可部署到 Web、移动或桌面应用。

架构分层:前端(Next.js + ChatKit SDK)负责 UI、会话历史、localStorage 中的 JWT 令牌管理与带 Bearer 令牌的自定义 fetch;后端(FastAPI + ChatKit Server)提供协议端点,继承 ChatKitServer 的 MyChatKitServer 类,中间件解析 JWT 得到 user_id;Agent 层使用 Agents SDK 的任务管理智能体;工具层为自动注入 user_id 的包装函数;数据库使用 SQLModel,按用户过滤并持久化会话。

关键用法:后端定义 MyChatKitServer.respond 处理消息并流式返回;用包装函数注入 user_id,如 add_task_wrapper(title) 调用 mcp_add_task(user_id=user_id, title=title);FastAPI 暴露 POST /api/v1/chatkit 端点,返回 text/event-stream;前端配置 UseChatKitOptions,指定 api.url、domainKey 与 authenticatedFetch。用户隔离依赖中间件校验、工具包装注入、数据库按 user_id 过滤三层保障。

适用场景:任务管理聊天机器人;为现有应用加入 AI 对话;领域专用 AI 助手;多用户隔离的聊天系统;需要触发应用实际变更的实时对话。

限制:资料未提供收费、价格与平台支持范围;示例代码与模板仅供结构参考,实际部署需自行配置 API 地址、domainKey 与鉴权;实时方案可选 WebSocket 或轮询,资料未给出完整实现。