先选择你的工作方式
文档会根据你的目标,显示最适合的快速开始路径。之后也可以随时切换。
当前路径:泛开发者工作流
共同基础 · 文档 / 快速开始
第一次使用共情具身
先完成一个小任务:做一段表达,或准备一份实验数据。你不需要先连接机器人才能浏览和编辑。
从你的目标开始
泛开发者路径适合先做出一段可播放的机器人表达,再把它接入互动规则。你可以从表情和语音开始,整个过程不要求先写代码。
- 打开表情工作室,选择一个表情资产,或创建自己的表情。
- 把表情拖到时间线,调节顺序和时长,再播放预览。
- 在表达编排中加入语音,保存并发布序列。
- 到自动化规则中选择这段序列,设置触发条件并测试分支。
打开创作工作台
专业开发者路径适合从采样开始,建立可追溯的数据集版本,再配置训练实验。每一步都保留检查结果和来源。
- 创建一个采集会话,选择相机或麦克风并确认浏览器授权。
- 检查图片和语音样本,补充标签、来源,排除不适合训练的内容。
- 创建训练数据版本,按采集会话划分训练集和验证集。
- 配置模型训练实验,记录参数、入口代码、随机种子和结果快照。
打开专业工作台
了解保存的位置
当前版本使用本机工作空间,作品保存在运行网站的电脑上。登录账号不会把数据自动同步到云端。导出的训练文件会显示完整的 D 盘路径。
泛开发者 · 文档 / 表情与语音
制作并发布一段表达
把表情和声音分别制作,再放到表达编排中组合。
创建表情资产
- 进入表情工作室,选择现有表情或创建新表情。
- 编辑名称、参数和持续时间,保存到资产库。
- 把资产拖到时间线;放置位置决定先后顺序。
- 拖动片段边缘调整时长,或点击秒数用键盘输入。
加入声音
在语音工作室上传自己的音频,或配置语音合成接口后生成声音。返回表达编排,从语音资产中选择要使用的声音,与表情序列组合。
保存与复用
已发布的表情序列可重新命名和编辑更新,也可以作为自动化规则中的播放动作。AI 时间对齐目前保留接口,需要接入相应服务后才能自动处理。
泛开发者 · 文档 / 自动化规则
用条件连接动作
用开始节点、条件连接线和动作节点组织一个完整的互动。
建立流程
- 在规则库新建或复制一条规则,填写容易辨认的名称。
- 添加开始、动作和结束节点,可按需要设置多个开始或结束。
- 进入连接模式,将箭头连接到节点上、下、左、右的连接点。
- 设置触发条件和动作,使用对齐工具整理画布;画布缩放独立于网页缩放。
测试每个分支
条件测试按照实际条件推进。想检查后续节点时,可以手动下一步,并在分支处选择要进入的路径。测试路径只验证流程逻辑,设备执行需连接硬件服务。
保存、启停与分享
保存后在规则库启用或关闭规则,也可以复制、重新编辑和删除。规则分享码可用于导入;日志用于检查执行过程和节点回滚。
打开规则库专业开发者 · 文档 / 数据采集
从采样到数据集版本
将设备设置、样本检查和数据版本分开处理,让每一步都有明确结果。
采集设备
在专业开发者模式打开数据采集。设置会话名称,选择相机或麦克风。浏览器会要求相应权限;拒绝授权时可在浏览器站点设置中调整,或导入已有素材。
样本检查
- 切换到样本检查,浏览图片或试听语音。
- 核对标签、来源和采集会话,处理待检查样本。
- 把不适合训练的内容排除,再创建数据集版本。
数据集划分
优先按采集会话分组,避免同一场景的相近样本同时落入训练集与验证集。在训练数据中查看图片、语音、数据版本和采集会话。
开始整理采集专业开发者 · 文档 / 模型训练
准备一份可复现的实验
先确定数据与目标,再配置训练参数、入口代码和结果记录。
数据与目标
选择图像表情分类、语音意图分类或 22 通道姿态回归,并选择对应数据集版本。保存实验时会保留不可变的数据快照。
训练配置
记录架构、归一化、数据增强、优化器、学习率策略、损失函数、批大小、随机种子和目标设备。参数需要与训练脚本实际读取的字段对应。
导入入口代码
- 切换到代码与依赖,导入 Python、Notebook 或配置文件。
- 检查内容,并选择 Python 训练入口。
- 内置 train.py 只提供 MobileNet 图像分类模板。音频、姿态回归和其他架构应导入匹配的入口。
- 保存实验,再导出配置、数据快照与源文件。
文件限制与保存
源文件使用 UTF-8 文本,单文件最多 128 KB,总量最多 256 KB、20 个文件。恢复旧实验会使用独立代码副本,不覆盖共享代码库的新内容。
配置训练实验专业开发者 · 文档 / 训练数据与预设
复用、导入和分享训练配置
预设保存可复用的训练参数,实验则保存某一次具体配置及其数据、代码快照。
保存自己的预设
在模型训练中设置参数,点击保存为预设,填写名称和用途说明。预设不捆绑某个数据集或源文件,应用之后仍需检查这两项。
导入文件或社区预设
使用导入 JSON 预设选择从 共情具身 导出的文件;也可以在社区资源或训练预设库中导入并应用。系统会检查参数格式,并提示不兼容或尚未指定的入口代码。
导出与共享
导出预设时,本地服务会将文件写入 D 盘并显示可复制的路径。将这个 JSON 文件交给别人,即可在其工作台导入。
进入训练预设库共同基础 · 文档 / 设备与能力
连接机器人之前
Valenbot 仿生头有 22 个自由度,包括颈部。先确认设备型号、通信协议和通道定义,再进行实际控制。
当前可操作的内容
可以编辑表情、语音资产、时间线、自动化规则和训练配置。摄像头、麦克风是否可用取决于浏览器授权及本机设备。
配置设备与开发服务
按设备型号设置通信协议与通道映射,在专业开发工作台中配置模型服务、训练环境与效果评估。
设备检查
- 在机器人资产中核对型号和自由度。
- 在设备概览检查连接状态及通道映射。
- 接入真实控制服务后,在安全范围内逐通道验证,再运行组合动作。
查看设备概览