最近真的明显能感觉到，这几年不管是深圳还是整个国内，人形机器人、具身智能这个赛道，直接就彻底火起来了。
我最近没事就刷视频、看各路博主的实测测评，真的发现一个特别有意思的变化。
现在的人形机器人，真的不再是以前那种呆呆的机械感了。它的整体形态、肢体动作，已经做得特别完善，尤其是跳舞、表演那些动作，流畅度、逼真度真的很高。

我们不妨和机器狗这类智能硬件做个对比：机器狗以四肢结构为主，更多承担物流搬运、户外勘探等工业体力作业；而人形机器人能够完成舞台演绎、高危特技等复杂动作，落地场景持续拓展。优必选、宇树科技等厂商的硬件技术已经十分成熟，但硬件方案短板同样突出：部署成本高、场景受限，难以适配门店、官网、商用大屏这类需要自由问答、全天候接待的高频交互场景，行业亟需轻量化软件底座补齐完整的具身交互能力。
无论线下实体机器人，还是线上网页、门店大屏，行业普遍面临同一瓶颈：仅有可视化载体，缺少标准化具身交互体系支撑自然双向沟通，这也是企业搭建智能接待、数据播报业务时最大难题。 很多企业不禁想问：如何低成本、轻量化落地交互方案？如果需要官网智能接待、大屏数据演示，或是 7×24 小时持续智能交互，该怎样搭建专属具身交互智能体？今天我们就来聊聊可行的落地路径。
在众多平台里，魔珐星云是极具代表性的方案。平台不仅拥有覆盖全行业的丰富 3D 形象资源，核心优势是一套完整原生具身交互能力。不仅可支持机器人，屏幕端它也支持实时双向对话，表情、肢体动作随对话同步联动，助力企业快速打造专属具身交互智能体。
企业无需从零自研、搭建庞大研发团队，接入 SDK 即可快速落地；形象、音色、交互逻辑都能按需自定义，有效压缩落地成本，快速上线全天候智能交互服务。
理论讲解终究不如实操直观，接下来我就手把手带大家从零完成魔珐星云具身交互智能体的搭建与接入，流程简洁易懂，零基础开发者也能快速上手。 其实它的整个引入过程是很简洁的。今天呢，我从0到1完整的去告诉大家怎么去搭建，小白也可以在很短的时间内去引入。
项目展示：

我提供的Gitee代码地址：https://gitee.com/xiaotietou/wangl-xingyun

项目技术栈与第三方服务配置文档

一、使用到的技术与第三方平台

1. TRAE AI 智能代码编辑器

• 官网地址：TRAE - Collaborate with Intelligence
• 核心定位：AI 驱动一站式开发工具，覆盖完整软件研发生命周期
• 核心技术/能力：
  • 双工作模式
    1. IDE 模式：AI 助手嵌入传统编码工作流，辅助日常开发
    2. SOLO 自主智能体模式：全流程自动化开发，从需求、编码、数据库对接至部署一站式完成
  • 多智能体架构：内置产品文档、Figma、Bug修复等专用Agent，支持自定义子智能体协同处理复杂任务
  • MCP（Model Context Protocol）工具协议：无缝对接 PostgreSQL、GitHub、Puppeteer、Figma AI Bridge 等外部工具
  • 前端开发支持：React / React Native、TS/JS、CSS 智能补全，Tab一键智能预测编辑
  • 多端覆盖：桌面端、Web端、移动端
  • 安全策略：本地优先存储代码，隐私模式、文件忽略机制，数据区域化部署

2. 魔珐星云（AI 具身交互智能开放平台）

• 官网地址：https://xingyun3d.com?utm_campaign=daily&utm_source=CSDNwanfen3&utm_medium=&utm_term=&utm_content=

• 配套资源地址：
  • Gitee 官方Demo：https://gitee.com/xmovmaster/XmovLiteAvatarJSDemo

• JS SDK 接入文档：具身驱动SDK（JS版本）接入说明

• 服务网关地址：https://nebula-agent.xingyun3d.com/user/v1/ttsa/session
• 核心定位：文本驱动3D数字人实时多模态交互平台，实现AI具身化表达
• 核心技术/能力：
  • 实时具身驱动：文本转语音、面部表情、肢体动作、口型同步，500ms低延迟交互，支持对话打断
  • 多端SDK支持
    1. JS Web SDK：兼容 Chrome / Safari / Edge / Firefox 全主流浏览器
    2. Android SDK：Android 11+，RK3588/RK3566 嵌入式芯片适配
  • SSML 富标记语言：自定义数字人动作、情绪、手势（KA动作指令）
  • 多状态生命周期：idle待机、interactive_idle互动待机、speak说话、listen聆听、离线/在线模式切换
  • 轻量化部署：百元级硬件即可运行，支持千万级并发设备接入
  • 行业场景：AI陪伴、数字客服、AI面试官、数据BI数字分析师、教育口语陪练、虚拟直播等

3. DeepSeek 大语言模型

• 官网地址：DeepSeek | 深度求索
• API 接口地址：https://api.deepseek.com/v1
• 核心定位：通用高性能对话大模型，提供流式输出能力，用于对话逻辑、文本生成、意图识别
• 核心能力：流式文本输出，可对接魔珐星云数字人speak接口实现实时对话播报；强Agent任务拆解能力

1.打开DeepSeek官网地址

2.创建 API key 查看密钥

二、第三方服务配置参数

1. 魔珐星云 数字人SDK配置

// 网关服务地址
GATEWAY_URL: "https://nebula-agent.xingyun3d.com/user/v1/ttsa/session",
// 平台创建应用凭证
APP_ID: "xxx",
APP_SECRET: "xxx",

查看App ID、APP_SECRET复制到项目里进行调用

2. DeepSeek 大模型API配置

// API基础地址
BASE_URL: "https://api.deepseek.com/v1",
// 默认调用模型
DEFAULT_MODEL: "deepseek-chat",
// 接口密钥
NORMAL_KEY: "xxx",

完整Demo
项目开发：
我们先打开魔珐星云的官网地址->应用管理-驱动应用

• 配置驱动应用名称、备注

• 人物配置-场景配置

• 人物配置-场景配置

• 人物配置-音色配置

你是灵活就业维权服务平台数字人，专注自由职业、兼职、外包、网约车等灵活就业场景薪资拖欠、社保缴纳、劳务协议纠纷等法律咨询、问题解答、维权方案出具。 你的回答需要符合以下要求： 1. 语言通俗易懂，表述客观严谨，贴合专业维权服务形象； 2. 全部内容依据现行劳动法规、社保相关政策作答，信息真实准确，不虚构内容； 3. 重点区分劳动关系与劳务关系、薪资讨要途径、参保方式、合同签署要点、投诉实操建议； 4. 行文简洁凝练，杜绝冗余表述，核心内容控制在300字以内； 5. 用户咨询非灵活就业维权相关问题时，礼貌引导对方咨询灵活就业维权相关问题。

修改我们的LLM提示词

让AI去帮我生成

代码结构

执行命令 npm run dev 
打开浏览器 http://localhost:5173/ 
就可以预览我们的数字人形象 已经能够很完美的展示出来了

查看我们的console日志，我们可以看到500ms以内就已经将数字人调用成功了。
在这里我提供了最小实例，大家可以直接复制到html中，或者拉取Gitee我提供的代码。
https://gitee.com/xiaotietou/wangl-xingyun

  APP_ID: "a76fc9d7f3ca495eXXXXXX",
  APP_SECRET: "1e5b810434dd413c9842c3e7XXXXXXX",
  const constructorOptions = {
  containerId: `#${this.containerId}`,
  appId: APP_ID,
  appSecret: APP_SECRET,
  enableDebugger: false,
  gatewayServer: url.toString(),
  onWidgetEvent: (event: any) => {
    console.log('SDK事件:', event)
    if (event.type === 'subtitle_on') {
      onSubtitleOn(event.text)
    } else if (event.type === 'subtitle_off') {
      onSubtitleOff()
    }
  },
  onStateChange,
  onMessage: async (error: any) => {
    const state = await getPromiseState(connectPromise)
    const plainError = new Error(error.message)
    if (state === 'pending') {
      reject(plainError)
    }
  }
}

// 创建SDK实例
const avatar = new window.XmovAvatar(constructorOptions)
// 初始化SDK
await avatar.init({
  onDownloadProgress: (progress: number) => {
    console.log(`初始化进度: ${progress}%`)
    if (progress >= 100) {
      resolve(true) // 数字人已经渲染出来了
    }
  },
  onClose: () => {
    onStateChange('')
    console.log('SDK连接关闭')
  }
})
调用SDK很简单，这些就能实现我们的SDK调用。

魔珐星云官网：https://xingyun3d.com?utm_campaign=daily&utm_source=CSDNwanfen3&utm_medium=&utm_term=&utm_content=