跳转到内容
Ticos 文档
  • 浅色
  • 深色
  • 跟随系统
  • 简体中文
  • English

快速上岗

本指南将带你完成一台新机器人从注册到投产的完整流程。建议按顺序执行以下 6 步，确保设备在正式交付运营前完成所有配置与验证。

步骤 1：准备机型模板

Section titled “步骤 1：准备机型模板”

为什么需要机型？ 机型（Robot Model）是机器人硬件的”模板”。它定义了 3D 模型、传感器配置和默认参数。注册新机器人时选择机型即可自动继承这些配置，避免逐台重复设置。

机型管理页面
机型管理：统一管理不同硬件规格的模板

操作方法

Section titled “操作方法”
  1. 进入 平台管理 → 机型管理
  2. 点击 创建机型，填写基本信息：
    • 名称 — 如「巡逻犬 Pro」「前台接待 G1」
    • 制造商 — 硬件供应商信息
    • 描述 — 机型的功能定位与适用场景
  3. 上传 URDF/MJCF 模型文件（可选但推荐）：
    • 将 .urdf 文件和相关 mesh 资源打包为 .zip
    • 上传后系统自动解析并提供 3D 预览
    • 使用诊断功能检查模型完整性

参考文档：机型管理详解

步骤 2：注册机器人

Section titled “步骤 2：注册机器人”

在仪表盘或机器人列表页创建新设备。

添加机器人对话框
注册新设备：命名并选择机型模板

操作方法

Section titled “操作方法”
  1. 点击 添加机器人
  2. 填写设备信息：
    • 名称 — 建议遵循「地点 + 角色 + 序号」规范，如「建行丹桂路-导购-01」
  3. 点击 Show Advanced Options 展开高级选项，选择 机型（默认会自动选择第一个可用机型）
  4. 点击 创建机器人

命名规范建议

Section titled “命名规范建议”

好的命名能在舰队规模扩大时大幅降低管理成本：

规范示例说明
地点 + 角色 + 序号万象城-迎宾-01适合零售、酒店场景
项目 + 编号Apollo-Proto-03适合研发与测试环境
楼栋 + 楼层 + 编号A3-12F-Security-02适合物业与安防场景

步骤 3：在机器人端安装 Ticos Agent

Section titled “步骤 3：在机器人端安装 Ticos Agent”

在云端完成基本注册后，你需要在物理硬件侧安装并启动客户端程序。

机器人详情页
机器人详情页：顶部 Header 包含 Connect 与 Copilot 等工具
连接对话框
连接对话框：获取一键安装与连接命令

Ticos Agent 是部署在机器人设备上的核心接驳程序（开源仓库：tiwater/ticos-agent）。它作为连接物理设备与 Ticos 云端 Server (api.ticos.ai) 的桥梁负责：

  • 维持与云端中枢的持久连接，作为统一的数据汇聚点
  • 自动拉取最新的机型、智能体与场景配置
  • 实时处理本地感知输入并触发物理动作
  • 桥接硬件驱动与 Ticos 的远程操控及 Stardust 服务

操作方法

Section titled “操作方法”
  1. 登录到机器人的板载计算平台（如 Jetson、树莓派或 x86 工控机）。
  2. 在 Ticos Web 控制台顶部栏（Header）点击 Connect 图标按钮（插头图标），获取该机器人的专属一键安装命令。
  3. 在机器人终端中运行该安装脚本（形如 curl -sSL https://get.ticos.ai/install.sh | bash -s -- --token <Token>）。
  4. 等待终端提示连接成功后，返回 Ticos Web 仪表盘，确认该设备状态已变为 在线。

步骤 4：配置智能体

Section titled “步骤 4：配置智能体”

智能体是机器人的「AI 大脑」。注册完成后，进入机器人详情页的智能标签进行配置。

智能体配置页面
智能体配置：设置大模型、人格与技能

核心配置清单

Section titled “核心配置清单”
配置项优先级说明
模型选择必需选择 LLM（GPT-4o、Claude、DeepSeek 等）
个性/提示词必需定义角色、语气、行为准则与能力边界
音色推荐选择 TTS 音色，影响语音回复听感
技能（MCP 工具）推荐挂载需要的工具能力
知识库按需上传领域文档，启用 RAG 检索增强

参考文档：智能配置详解

步骤 5：绑定场景

Section titled “步骤 5：绑定场景”

场景（Scene） 定义了机器人执行任务的环境上下文 — 包括地图、导航路线和功能区域。

专长配置页面
专长配置：管理场景、知识与业务流程

操作方法

Section titled “操作方法”
  1. 进入机器人详情页的专长 → 场景
  2. 选择已有场景或创建新场景
  3. 配置场景要素：
    • 地图 — 环境的 2D/3D 地图数据
    • 路线 — 预定义的巡逻或服务路径
    • 区域 — 功能区域（充电区、禁入区、服务区等）

步骤 6：上线验收

Section titled “步骤 6：上线验收”

将机器人交给运营团队之前，完成一次端到端验收，确保所有链路正常。

验收检查清单

Section titled “验收检查清单”

基础连通性

Section titled “基础连通性”
  • 机器人在仪表盘中显示为在线
  • 健康指标（CPU、内存、网络）无异常告警

远程操控

Section titled “远程操控”
  • 进入 Teleops，视频流正常显示
  • 传感器面板数据正常刷新
  • 键盘发送运动指令，机器人正确响应

智能体对话

Section titled “智能体对话”
  • 触发一段测试对话，智能体正常回复
  • 回复风格符合个性配置（语气、角色）
  • 知识库问题能命中预期文档片段（如已配置 RAG）

场景与导航

Section titled “场景与导航”
  • 场景地图正确加载（如已配置）
  • 导航指令可执行（如适用）

常见问题

Section titled “常见问题”
现象排查方向
机器人显示离线检查设备网络、标识符是否与平台一致
Teleops 无视频确认媒体服务已配置，检查 WebRTC 通道
智能体不回复检查模型服务 API Key 是否有效
对话有幻觉完善系统提示词的能力边界，补充知识库

上岗完成

Section titled “上岗完成”

通过以上验收后，机器人即可正式交付运营团队。接下来建议了解：