基于 Rokid 灵珠 AI 平台的春节全能助手智能体开发实践

下面是成功创建好的界面。

四、核心工作流编排（无代码可视化 + 代码节点增强）

工作流是本次开发的核心，依托灵珠平台所见即所得的无代码编排工具，通过「添加节点、设置逻辑、配置入参/出参」实现业务处理，针对 12306 接口特殊数据格式，通过 Python 代码节点完成结构化数据解析，三个核心工作流编排逻辑如下：

4.1 12306 高铁票查询工作流（refer_12306）

核心功能

接收用户「出发地 + 目的地 + 出行时间」信息，调用平台预置 12306 插件，完成城市名→车站代码转换、数据解析、车次查询，返回对应车次、出发/到达时间、余票、票价信息。

编排节点（按执行顺序）

1. 用户意图提取节点：通过大模型提取出发地、目的地、确定出行日期；
2. 车站代码获取节点：调用 get-station-code-of-city 插件，这里我命名成了出发点和目的地，将城市名转换为车站编码；
3. Python 代码解析节点（from、to）：解析插件返回的嵌套 JSON 字符串，精准提取 station_code，解决接口数据格式不兼容问题；
4. 车票查询节点：调用 get-tickets 插件，传入出发站代码、到达站代码、标准格式日期，获取实时车次数据；
5. 车票中转查询：调用 get-interline-tickets 获取车票中转信息。
6. 结果格式化节点：按统一规范将结构化数据转为自然语言；
7. 结束节点：输出结果。

4.2 自驾路线规划工作流

核心功能

接收用户出发地、目的地、出行时间（春节），结合春节高速免费、易拥堵路段信息，返回最优自驾路线、全程耗时、拥堵提醒。

编排节点（按执行顺序）

1. 经纬度处理节点：提取出发地、目的地、出行时间，同时将出发地和目的地转化为经纬度；
2. 地图数据插件调用节点：入参为出发地、目的地、出参为多条路线规划、耗时等；
3. 结果整理与返回节点：将最优路线、耗时、提醒信息整理为自然语言，反馈至智能体。

测试结果

4.3 年货低价推荐工作流

核心功能

接收用户年货商品名称，调用平台「什么值得买/smzdm_haojia_articles」插件，返回价格最低的 1 条好价信息，含商品名称、实付价格、购买链接。

编排节点（按执行顺序）

1. 商品名称提取节点：提取用户输入的年货商品名称（如坚果、春联、酒水）；
2. 插件调用节点：入参为商品名称，出参为好物推荐列表（含价格、链接、描述）；
3. 规范输出节点：按「商品名称 + 实付价格 + 购买链接」格式整理；
4. 结果返回节点：将整理后的信息进行输出。

4.4 工作流通用设置

所有工作流均需要发布，通过设置智能体提示词，当智能体触发对应关键词/意图时执行；添加异常处理，当插件调用失败/数据返回异常时，返回「当前查询人数较多，请稍后再试」，提升系统稳定性。

五、关键代码实现（工作流代码节点 + 眼镜端伪代码）

本次开发依托灵珠平台无代码工具，核心代码为 12306 车站代码解析脚本（解决接口数据格式问题）与眼镜端 SDK 适配伪代码，具体如下：

5.1 12306 工作流核心代码（车站 JSON 解析）

用于解析 get-station-code-of-city 返回的嵌套字符串，提取标准车站代码，保证 get-tickets 接口正常调用：

import json
async def main(args: Args) -> Output:
    params = args.params # 直接解析 input 字符串，它本身就是数组
    data = json.loads(params['input'])
    station_code = None
    if data and isinstance(data, list) and len(data) > 0:
        text_data = data[0].get("text", {}) # 自动适配任意城市名
        for city in text_data:
            station_code = text_data[city].get("station_code")
            break
    # 输出到 key0
    ret: Output = { "key0": station_code }
    return ret

5.2 智能体提示词配置（平台内直接输入）

# 角色 你是贴心的春节全能助手，语气简洁友好，精准解答抢票、自驾、年货相关问题。
# 核心能力与触发规则
## 1. 12306 车票查询（工作流 + 插件）
- 触发关键词：高铁票、抢票、车票、回家、返程、余票、车次、几点到、几点出发等。
- 处理逻辑：
  1. 模型自动识别用户意图，提取出发地、目的地、出行日期、座位类型等关键信息。
  2. 信息不完整时，主动友好追问补充。
  3. 调用工作流 `refer_12306`，流程如下：
     - 调用 `get-station-code-of-city` 获取出发地、目的地的车站代码。
     - 通过代码节点解析 JSON 结构，提取纯车站代码字符串。
     - 调用 `get-tickets` 接口，传入日期、出发站代码、到达站代码，获取车次、余票、票价、历时等数据。
  4. 模型将结构化数据整理为自然语言，严格按回复格式规范输出。
## 2. 春节自驾路线规划（工作流）
- 触发关键词：自驾、开车、路线、出行规划、回家路线、堵车、高速等。
- 处理逻辑：
  1. 自动触发工作流 `car`。
  2. 工作流根据出发地、目的地、出行时间，结合春节高速免费及拥堵信息，返回最优路线、耗时、拥堵提醒。
  3. 模型严格按格式规范排版输出，不返回原始数据。
## 3. 年货低价推荐（工作流）
- 触发关键词：年货、比价、好物、购买、便宜、推荐、坚果、酒水、春联等。
- 处理逻辑：
  1. 自动触发工作流 `buy`。
  2. 工作流根据商品名称，返回价格最低的 1 条好价信息，含商品名、价格、购买链接。
  3. 模型严格按格式规范输出，不返回原始数据。
---
# 回复格式规范
## 车票查询结果
> 🚄 **车次信息**：GXXX 次高铁
> 🕒 **出发/到达**：YYYY 年 MM 月 DD 日 HH:MM（出发站）→ HH:MM（到达站）
> ⏱️ **历时**：X 小时 XX 分钟
> 💺 **余票与票价**：二等座/硬座有票，票价 XXX 元
> 💡 **温馨提示**：建议提前在 12306 官方渠道购票。
## 自驾路线结果
> 🚗 **最优路线**：京沪高速（G2）
> 📍 **全程**：约 XX 公里
> ⏱️ **预计耗时**：X 小时 XX 分钟
> ⚠️ **拥堵提醒**：春节期间 XX:XX-XX:XX 为拥堵高峰，建议错峰出行。
> 🎟️ **高速政策**：春节期间（X 月 X 日-X 月 X 日）全国高速免费通行。
## 年货推荐结果
> 🛒 **商品名称**：三只松鼠坚果大礼包混合装
> 💰 **好价**：实付低至 58.9 元
> 🔗 **购买链接**：[点击查看](https://www.smzdm.com/p/168975421/?utm_source=zijie)
> 💡 **温馨提示**：价格可能随活动变动，请以页面为准。
---
# 通用回复规则
- 禁止直接输出工具代码、工作流原始数据，所有结果必须整理为自然语言。
- 参数缺失时，清晰提示用户补充关键信息。
- 插件/工作流调用失败时，统一返回：
  > 当前查询人数较多，请稍后再试。
- 所有回复使用清晰 Markdown 排版，便于用户快速阅读。

5.3 Rokid Glasses 适配伪代码（Java）

// 导入 Rokid Glasses 灵珠平台对接 SDK（伪包名，实际以官方为准）
import com.rokid.lingzhu.sdk.LingzhuAgent;
import com.rokid.lingzhu.sdk.listener.AgentResultListener;
import com.rokid.glasses.hardware.VoiceWakeup;
import com.rokid.glasses.hardware.ScreenDisplay;

// 初始化春节出行助手智能体
public class SpringFestivalAgent {
    private LingzhuAgent springFestivalAgent;
    private VoiceWakeup voiceWakeup;
    private ScreenDisplay screenDisplay;

    // 构造方法：初始化智能体与眼镜硬件能力
    public SpringFestivalAgent() {
        // 初始化灵珠平台智能体
        springFestivalAgent = new LingzhuAgent.Builder()
                .agentId("spring_festival_agent_001")
                .lowPower(true)
                .build();
        // 初始化语音唤醒与屏幕展示
        voiceWakeup = new VoiceWakeup("春节全能助手");
        screenDisplay = new ScreenDisplay();
    }

    // 语音唤醒监听
    public void setVoiceWakeupListener() {
        voiceWakeup.setOnWakeupListener(voiceText -> {
            queryAgent(voiceText);
        });
    }

    // 调用灵珠平台智能体
    private void queryAgent(String userInput) {
        springFestivalAgent.query(userInput, new AgentResultListener() {
            @Override
            public void onSuccess(String result) {
                screenDisplay.showText(result);
                voiceBroadcast(result);
            }

            @Override
            public void onError(String errorMsg) {
                screenDisplay.showText("查询失败，请稍后再试");
                voiceBroadcast("查询失败，请稍后再试");
            }
        });
    }

    // 语音播报
    private void voiceBroadcast(String text) {}

    // 启动智能体
    public static void main(String[] args) {
        SpringFestivalAgent agent = new SpringFestivalAgent();
        agent.setVoiceWakeupListener();
    }
}

六、测试验证（灵珠平台内对话测试）

因无 Rokid Glasses 实物，本次测试仅在灵珠平台智能体对话测试界面完成，通过输入模拟用户问题，验证智能体与工作流的联动效果，测试用例与结果如下：

6.1 测试用例 1：12306 高铁票查询

用户输入：3 月 11 日从武汉到上海

智能体回复：

6.2 测试用例 2：年货低价推荐

用户输入：年货想买坚果礼包

查看链接

6.3 测试用例 3：自驾路线规划

用户输入：春节自驾从北京出发去西安，有哪些避开拥堵的路线建议？

6.4 异常测试

用户输入：查高铁票

七、开发总结与后续优化

7.1 开发总结

本次基于 Rokid 灵珠 AI 平台的春节出行助手智能体开发，充分利用了平台零门槛、无代码、全栈化的核心优势：

1. 全程以可视化编排为主，仅在 12306 数据解析环节使用轻量 Python 代码，解决真实接口适配问题；
2. 依托平台预置组件与自开发插件，快速实现 12306 车票查询、自驾规划、年货比价三大核心能力；
3. 工作流 refer_12306 通过代码节点 + 插件调用的组合方案，完美解决车站编码解析、接口参数不兼容等实际开发问题；
4. 无硬件条件下仍可完成全功能验证，伪代码方案为后续眼镜端落地提供极低成本的扩展路径。

7.2 后续优化方向

1. 硬件端真机适配：获取 Rokid Glasses 后，完成语音唤醒、屏幕展示、多模态交互落地；
2. 功能增强：支持往返车票查询、座位类型筛选、实时余票动态刷新、自驾油量/充电提醒；
3. 体验优化：强化对话记忆，自动保存常用出发地/目的地，减少重复输入；
4. 多模态扩展：支持图片比价、语音快捷查询、AR 路线预览。

八、开发心得

该模式降低了 AI 应用开发门槛，无代码编排 + 轻量代码增强的模式，让开发者可以聚焦业务场景而非底层技术。在本次开发中，12306 车票查询工作流从接口调用、数据解析到结果格式化的全流程落地，充分体现了平台在处理复杂第三方接口时的灵活性与实用性。

本次春节出行助手的开发实践证明：基于灵珠平台，开发者可快速构建稳定、可用、可扩展的场景化 AI 智能体，真正实现从创意到落地的高效转化。