可通过四种方式实现有言数字人手势按需响应：一、TTS文本嵌入XML标记；二、JS SDK动态调用playAction；三、知识库问答节点绑定关键词触发；四、RAG上下文注入action_hint字段控制动画。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用有言数字人时希望其肢体动作（尤其是手势）能按需响应特定内容或指令，而非仅依赖语音驱动的默认KA动作，则需介入其动作控制机制。以下是实现该目标的具体方法：
一、通过TTS文本标记嵌入手势指令
有言平台支持在输入的口播稿文本中插入特定XML标记，用于在指定语句位置触发预设手势动作。该方式无需编程，适用于静态脚本类内容（如微课、宣讲视频），且与语音节奏强同步。
1、在需要触发手势的语句前后添加
2、确保所用gesture name值来自有言官方手势库列表，常见值包括：wave_hand（挥手）、point_forward（前指）、open_palm（摊手）、thumbs_up（竖大拇指）、fold_arms（抱臂）。
3、在“AI创作”页面导入含标记的文本后，点击“生成视频”前勾选“启用动作标记解析”选项。
二、调用JavaScript SDK动态注入动作参数
当需在网页端实时控制数字人肢体动作（如响应按钮点击、鼠标悬停或API事件），可利用有言提供的Web SDK，在运行时向数字人实例发送动作指令包。该方式要求前端具备基础JS开发能力，且必须在HTTPS或localhost环境下执行。
1、在HTML中引入有言SDK脚本：<script src="https://sdk.xingyun3d.com/youyan-sdk-v2.4.min.js"></script>
2、初始化数字人实例后，调用playAction方法传入动作ID与持续时间，例如：digitalHuman.playAction("wave_hand", 1500)；其中1500为毫秒级持续时间。
3、动作ID须与平台后台“动作管理”中已发布的自定义动作ID完全一致；若使用系统内置动作，ID可直接采用wave_hand等标准命名。
使用四维度框架评估任意 GitLab MR 或 GitHub PR 的复杂度：规模（20%），认知负荷（30%），审查工作量（30%），风险/影响（20%）...
三、绑定知识库问答关键词自动触发手势
在配置“智能交互”模块时，可将特定手势动作与知识库中的高频问答节点进行强关联。当用户提问命中该节点时，数字人不仅输出答案，同时同步执行对应肢体动作，增强表达可信度与情绪张力。
1、进入“对话流程设计”界面，在目标问答节点右侧点击“+动作”按钮。
2、从下拉菜单中选择一个预设手势动作，或上传自定义动作文件（FBX格式，需符合有言骨骼绑定规范）。
3、设置触发条件为“匹配问题关键词”，例如输入“谢谢”、“感谢”、“辛苦了”，并设定动作播放时机为“回答开始时”。
四、使用RAG上下文注入动态动作策略
对于需依据对话语义深度判断动作类型的场景（如识别用户情绪后调整手势幅度），可通过RAG检索结果动态拼接动作参数，并在认知决策层输出时附加动作控制字段。该方式依赖后端逻辑接入，适用于企业级定制部署。
1、在知识库文档元数据中为每条条目添加action_hint字段，例如：{"action_hint": "nod_slowly", "confidence": 0.92}
2、在RAG检索返回结构中提取action_hint值，将其作为附加参数传入表达生成层。
3、在服务端调用有言API时，在request body的animation字段中写入：{"type": "gesture", "id": "nod_slowly", "loop": false}。
