「一路同行」智能体实践总结

一个基于智能体架构的出行同伴匹配系统，帮助用户找到志同道合的出行伙伴。

一、项目概述

「一路同行」 是一个面向出行社交场景的智能体（Agent）。用户只需用自然语言说出"某天想去哪里做什么"，智能体便会自动解析意图、匹配已有活动、推荐同行伙伴。如果已有同目的地同时间的活动，用户可以直接加入；如果没有，用户可以一键创建新活动，等待其他伙伴加入。

核心价值：让「一个人想去但不想一个人去」的出行需求，变成「找到组织、有人同行」的真实体验。

二、功能全景

用户输入 "明天想去紫金山"
         │
         ▼
┌─────────────────────────────────────┐
│  📍 意图解析                          │
│  日期→2026-07-24  地点→紫金山           │
│  城市→南京  标签→🏃爬山 🥾徒步 🌸观光    │
└─────────────────────────────────────┘
         │
         ▼
┌─────────────────────────────────────┐
│  🔍 四级智能匹配                       │
│  🔴 精确匹配  同天+同地点               │
│  🟠 标签匹配  同城+同标签               │
│  🟡 城市匹配  同城+不同地点+不同标签     │
│  🟢 日期临近  前后1天+同地点             │
└─────────────────────────────────────┘
         │
    ┌────┴────┐
    ▼         ▼
 加入活动   创建活动
    │         │
    ▼         ▼
┌─────────────────────────────────────┐
│  ⏰ 活动前1小时自动提醒                 │
│  优先短信 → 降级 Web 推送              │
└─────────────────────────────────────┘

2.1 已实现功能清单

三、技术架构

3.1 项目结构

skills/travel-companion/
├── SKILL.md              # 智能体技能定义（角色、工作流、模板）
├── data/
│   └── activities.json   # 活动数据库（11条测试数据）
├── scripts/
│   └── send_sms.py       # 阿里云短信发送脚本（纯标准库）
└── config/
    ├── sms_config.example.json   # 短信配置模板
    └── sms_config.json           # 实际短信配置（需用户填入凭证）

3.2 技术栈

3.3 数据模型

{
  "id": "act_20260724_nanjing_zhongshanling_001",
  "location": "中山陵",
  "city": "南京",
  "date": "2026-07-24",
  "time": "08:00",
  "meeting_point": "中山陵博爱坊前",
  "activity_desc": "中山陵徒步登顶",
  "tags": ["徒步", "观光"],
  "creator": {
    "name": "老周",
    "gender": "男",
    "contact": "13700003331"
  },
  "participants": [
    {
      "name": "老周",
      "gender": "男",
      "contact": "13700003331",
      "joined_at": "2026-07-20T16:00:00+08:00"
    }
  ],
  "status": "open",
  "max_participants": 10,
  "created_at": "2026-07-20T16:00:00+08:00",
  "reminder_job_id": "travel_reminder_xxx"
}

四、核心设计

4.1 智能标签体系（7大类 40+ 标签）

自动推断：用户说"想去爬山拍照"→ 自动标签 ["爬山", "拍照"]，创建时用户可以修改。

4.2 地点-城市自动映射

"迪士尼"     → 上海      "故宫"       → 北京
"西湖"       → 杭州      "兵马俑"     → 西安
"玄武湖"     → 南京      "洪崖洞"     → 重庆
"环球影城"   → 北京/多城（需确认）

覆盖全国 50+ 知名景点，确定性映射 16 条 + 模糊匹配（需向用户确认）。

4.3 四级匹配策略

五、工作流程

Step 1: 意图解析
   ├── 日期转换（"明天"→"2026-07-24"）
   ├── 地点提取 + 城市自动补全
   ├── 标签自动推断
   └── 回显确认

Step 2: 四级匹配
   ├── 读取 activities.json
   ├── 逐层匹配
   ├── 分组展示结果
   └── 等待用户选择

Step 3: 加入 / 创建
   ├── 收集：姓名 + 性别 + 联系方式 + 集合地点 + 标签
   ├── 确认信息
   └── 写入 activities.json

Step 4: 设置提醒
   ├── 创建 cron 定时任务（活动前1小时）
   ├── 触发时发送短信（如有配置）
   └── Web 推送作为兜底

六、实践演进过程

「一路同行」不是一蹴而就的，而是通过多轮迭代逐步完善的：

七、后续拓展方向

7.1 📱 短信提醒（优先）

当前状态：脚本已就绪（send_sms.py），支持阿里云 SMS API，纯 Python 标准库，dry-run 测试通过。

待完成：

技术实现：

# cron 触发时自动调用
python send_sms.py \
  --config sms_config.json \
  --recipients '[{"phone":"18888652356","name":"叮当"}]' \
  --activity "玄武湖散步" \
  --time "2026-07-24 14:00" \
  --location "南京玄武湖"

降级策略：未配置短信时自动降级为 Web 推送，不影响核心功能。

费用估算：0.045 元/条，100 条仅需 4.5 元。首次开通通常赠送试用额度。

7.2 📧 邮箱提醒

• 识别 @ 格式的联系方式，调用 SMTP 发送邮件
• 与短信互补，覆盖不同偏好的用户

7.3 🗺️ 活动地图可视化

• 将同城活动标注在地图上
• 一键查看"附近有哪些活动"

7.4 ⭐ 用户信用与评价系统

• 参与者互评机制
• 发起人信用分
• 降低鸽子率

7.5 💬 活动内聊天

• 加入活动后自动建群（飞书/微信/系统内置）
• 活动前讨论具体安排

7.6 📊 活动热度与推荐算法

• 基于历史数据推荐热门活动
• 个性化推荐（根据用户偏好标签）

7.7 🔗 外部平台对接

• 飞书机器人集成
• 微信小程序
• Telegram Bot

八、测试数据一览

当前系统共有 11 个活动，覆盖 2026-07-24 至 07-26：

九、关键经验总结

9.1 设计原则

1. 渐进式增强：从核心匹配 → 标签推荐 → 短信提醒，每次迭代增加一层价值
2. 优雅降级：短信不可用 → 自动走 Web 推送，功能核心不受影响
3. 数据驱动：所有活动数据集中管理（JSON），Agent 无状态、可重启
4. 自然语言优先：用户说人话，系统做翻译，零学习成本

9.2 踩过的坑

9.3 方法论

“智能体不是一次性建设，而是持续演进的服务。”

从 V1 到 V7，每一版都解决一个真实的用户痛点，而不是一次性设计完美系统。快速上线 → 收集反馈 → 迭代增强，是智能体实践的核心节奏。

十、文件清单

📅 创建日期：2026-07-24
👤 智能体：一路同行（travel-companion）
🛠️ 框架：JiuwenSwarm