SuperAPI AI 工具集

chatkit-actions

通用与其它

查看项目

更新于 10-16 06:48

技能介绍

用途:为 ChatKit 的智能体界面实现交互式小组件与双向通信,让 AI 渲染可点击组件,用户操作触发前端或后端动作。

主要能力:动作处理器分 client(前端 onAction 处理导航、本地状态、发送后续消息)与 server(后端 action() 处理方法处理数据变更、替换小组件)。支持小组件模板(.widget 文件,含 version、name、template、jsonSchema)、客户端动作、服务端动作、客户端到服务端动作转发、实体 @提及、编辑器工具模式选择、消息反馈/重试/分享、工具流式输出小组件。可用组件包括布局(ListView、ListViewItem、Row、Col、Box)、内容(Text、Title、Image、Icon)、交互(Button)。

使用方式:前端用 @openai/chatkit-react 的 useChatKit 配置 widgets.onAction、entities、composer.tools、threadItemActions;后端继承 ChatKitServer 实现 action(),用 WidgetTemplate.from_file 加载模板并 build,通过 ThreadItemReplacedEvent、ThreadItemDoneEvent、ClientEffectEvent 等事件流式返回。

限制与注意:Action 对象用 payload 而非 arguments;服务端 action() 的 context 运行时是 RequestContext,勿再包装;构造 UserMessageItem 需提供 id、thread_id、created_at、content、inference_options 等必填字段。具体平台、收费与效果资料暂未提供。