需完成服务端接入、客户端配置与API参数适配三类操作：一、确认API服务运行并测试连通性；二、在application.yml中注册API端点；三、启用emoticon-recommender插件；四、配置关键词触发规则与匹配阈值；五、调试前端渲染逻辑。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在MuleRun聊天界面中调用表情包推荐API以增强交互趣味性，则需完成服务端接入、客户端配置与API参数适配三类操作。以下是具体实施步骤：
一、确认API服务已部署并可访问
表情包推荐功能依赖外部HTTP接口提供实时数据，必须确保该API服务处于运行状态且MuleRun后端具备调用权限。若API部署于内网，需检查网络策略是否放行对应端口与路径。
1、使用curl命令测试API连通性：curl -X GET "http://your-api-domain/v1/emoticon/recommend?user_id=123&limit=5"
2、验证响应头中包含Content-Type: application/json且HTTP状态码为200
3、检查返回JSON体中是否存在data字段及至少一个emoticon_url字段
二、在MuleRun配置文件中注册API端点
MuleRun通过application.yml或config.json统一管理外部服务引用，需在此处声明表情包推荐API的地址、超时时间与重试策略，供内部模块按需调用。
1、打开MuleRun主配置目录下的config/application.yml
2、在external-services:节点下新增子项：emoticon-recommender:
3、设置base-url值为API根路径，例如http://api.example.com/emoticon
4、指定connect-timeout-ms: 3000与read-timeout-ms: 5000
三、启用聊天界面表情包推荐插件模块
MuleRun采用插件化架构，表情包推荐需通过独立模块注入消息渲染流程，在用户输入关键词或触发特定动作时自动拉取并展示候选表情。
1、进入MuleRun安装路径的plugins/目录
2、确认存在已解压的emoticon-recommender-v2.1.0.jar文件
3、编辑plugins/enable.list，在末尾添加一行：emoticon-recommender
4、重启MuleRun服务使插件加载生效
四、配置关键词触发规则与匹配阈值
表情包推荐并非全量推送，而是依据用户输入文本的语义相似度或预设关键词进行条件激活，相关规则需在后台管理界面或配置文件中明确定义。
1、登录MuleRun管理后台，导航至插件 → 表情包推荐 → 触发设置
2、在关键词白名单栏输入逗号分隔的词组：开心,哈哈,太棒了,赞,牛
3、将语义匹配阈值设为0.65（范围0.0–1.0）
4、勾选仅在群聊中启用复选框（如需限制使用场景）
五、调试客户端表情渲染逻辑
前端需解析API返回的表情包列表，并以悬浮气泡或底部横滑栏形式嵌入聊天输入框上方，所有UI行为须与MuleRun默认样式一致且不阻塞主消息流。
1、在浏览器开发者工具中切换至Network标签，过滤请求关键词emoticon/recommend
2、发送一条含白名单关键词的消息，观察是否触发一次GET请求并返回非空JSON
3、检查DOM中是否存在class为emoticon-suggestion-bar的容器节点
4、确认每个表情图标元素均携带data-emoticon-id属性且值与API返回一致
