SuperAPI AI 工具集

building-chat-widgets

智能体与模型

查看项目

更新于 10-15 20:06

技能介绍

用途:构建交互式 AI 聊天组件,让聊天界面包含按钮、表单和双向操作,适合创建带可点击组件、实体标记(@提及)的智能体 UI。

主要能力:

  1. 组件模板:用 ListView、ListViewItem、Row、Col、Box、Text、Title、Image、Icon、Button 等组件定义可复用布局。
  2. 动作处理:动作分 client(前端 onAction 回调,用于导航、本地状态)与 server(后端 action() 方法,用于数据变更、组件替换)两类。
  3. 组件生命周期:智能体工具生成组件并 yield WidgetItem,组件在聊天中渲染按钮,用户点击后派发动作,由对应处理器处理,可选替换为更新后的组件。
  4. 实体标记:通过 entities.onTagSearch 与 onClick 支持 @提及实体。
  5. 输入框工具:通过 composer.tools 让用户选择不同 AI 模式,后端按 tool_choice 路由到不同智能体。

使用方式:前端用 useChatKit 配置 api(url、domainKey)、widgets.onAction、entities、composer;后端继承 ChatKitServer 并实现 action()。验证运行:python3 scripts/verify.py,预期输出 ✓ building-chat-widgets skill ready。

限制与注意:动作对象用 action.payload 而非 action.arguments;context 参数已是 RequestContext,不要再次包装;合成用户消息需包含 id、thread_id、created_at 等必填字段,内容类型用 type="input_text";同一动作不要同时在客户端和服务端处理。若验证失败,检查 references/ 下是否有 widget-patterns.md。

适用场景:需要可点击组件、表单交互、实体提及或模式选择的 AI 聊天界面。具体收费、平台支持等信息暂未提供。