数据源与能力

数据侧：树洞 · 教务 · PDF · 外部网页 | 工具侧：Search · Fetch · Web · Weather

模块总览

RUC百事通的数据层采用“统一封装”策略：无论底层是数据库、API 还是 PDF 文档，最终都通过标准化的工具接口暴露给 Agent。

🧩
已接入能力矩阵
  • 树洞检索：search_treehole
    话题/情绪/正文混合检索
  • 公众号搜索：remote_*
    校内数十个公众号信息聚合
  • 学院公告：search_academy_news
    商学院/财金/经院通知
  • 教务搜索：search_ruc_cms
    教务处/档案馆/国学院站内搜
  • 课程评价：search_course_reviews
    选课指南与红黑榜
  • 全网检索：web_search
    基于 Metaso 的联网搜索
  • 生活服务：weather_*
    万维天气接口

树洞与评论

核心数据源

这是 RUC 最大的非结构化信息来源。我们不仅采集内容，还引入了 LLM 对帖子进行“打标”，从而支持按情绪和潜在风险进行过滤。

数据采集与清洗架构

采集端 Client API 网关 / 队列 计算 Worker (LLM) 存储 DB 树洞客户端 模拟抓包 / 去重上传 接收网关 鉴权 -> 写入 raw_data raw_data 表 Status: Pending 初步清洗 任务调度 API 打标 Worker 调用 LLM 识别情绪 Post 主表 Structured Data 去重合并
图 1: 树洞数据的分布式采集、打标与落库流程

工具接口详情

🔍
帖子检索
search_treehole

支持多维度混合检索。Agent 可指定 q_scope 来决定是只搜正文，还是连同评论、情绪标签一起搜。

JSON Payload 
{
  "tool": "search_treehole",
  "args": {
    "text": "推免 保研",
    "limit": 5,
    "date_from": "2024-09-01",
    "q_scope": "both"
  }
}

学院公告

针对商学院、财金、经济学院的官方通知进行了结构化提取。

📢
学院新闻检索
search_academy_news

先关键词匹配，再语义重排。支持跨学院检索，用于回答“XX学院最近有什么通知”。

JSON Payload 
{
  "tool": "search_academy_news",
  "args": {
    "text": "期末考试",
    "academy": "经济学院",
    "date_from": "2024-01-01"
  }
}

微信公众号信息聚合

基于 WECHAT2RSS 项目，自动聚合学校数十个微信公众号信息来源

📢
微信公众号检索
remote_*

相关服务和数据库部署于独立服务器，目前注册的校内公众号共57个，具体名单如下。

账号分为三类：官号、校级学生号、院级学生号。官号是指主要由全职工作人员运营的账号，学生号指主要由学生组织发文的账号。

JSON Payload 
[
  {
    "biz_id": 3927253328,
    "biz_name": "人大商学院本硕博",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3923326601,
    "biz_name": "中国人民大学青年志愿者协会",
    "account_type": "student_univ",
    "college_name": null
  },
  {
    "biz_id": 3082149721,
    "biz_name": "商苑经纬",
    "account_type": "student_college",
    "college_name": "商学院"
  },
  {
    "biz_id": 3099050815,
    "biz_name": "SARDER",
    "account_type": "student_college",
    "college_name": "农业与农村发展学院"
  },
  {
    "biz_id": 3071081031,
    "biz_name": "RUC新闻一家人",
    "account_type": "student_college",
    "college_name": "新闻学院"
  },
  {
    "biz_id": 3558876356,
    "biz_name": "智乎哲也",
    "account_type": "student_college",
    "college_name": "哲学院"
  },
  {
    "biz_id": 3095414331,
    "biz_name": "RUC外院",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3910612248,
    "biz_name": "中国人民大学艺术学院",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3091876010,
    "biz_name": "壹号国学生",
    "account_type": "student_college",
    "college_name": "国学院"
  },
  {
    "biz_id": 3520335643,
    "biz_name": "中国人民大学历史学院",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3284977568,
    "biz_name": "RUC文曰",
    "account_type": "student_college",
    "college_name": "文学院"
  },
  {
    "biz_id": 3082088869,
    "biz_name": "中国人民大学综合服务中心",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3255170166,
    "biz_name": "健康RUC",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 2398317203,
    "biz_name": "RMBS微职场",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3201343874,
    "biz_name": "人大商学院党建",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3071248021,
    "biz_name": "中国人民大学商学院",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3078583578,
    "biz_name": "中国人民大学",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3083451921,
    "biz_name": "人大阳光招生",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3236602980,
    "biz_name": "高礼Fintech",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3096549914,
    "biz_name": "RUC悦辅",
    "account_type": "student_univ",
    "college_name": null
  },
  {
    "biz_id": 3592636811,
    "biz_name": "RUC阳光公益",
    "account_type": "student_univ",
    "college_name": null
  },
  {
    "biz_id": 3519072885,
    "biz_name": "人大学生学术实践",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 2394941561,
    "biz_name": "中国人民大学青年启航发展中心",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 2393065191,
    "biz_name": "中国人民大学学生社团服务中心",
    "account_type": "student_univ",
    "college_name": null
  },
  {
    "biz_id": 3253327050,
    "biz_name": "RUC学生艺术团",
    "account_type": "student_univ",
    "college_name": null
  },
  {
    "biz_id": 3900670551,
    "biz_name": "运动RUC",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3087505024,
    "biz_name": "人大数智",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3016452725,
    "biz_name": "中国人民大学图书馆",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3552982823,
    "biz_name": "RUC国际暨港澳台交流",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 2390163413,
    "biz_name": "青年人大",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3575069602,
    "biz_name": "人大研小团",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 2395889802,
    "biz_name": "中国人民大学学生会",
    "account_type": "student_univ",
    "college_name": null
  },
  {
    "biz_id": 3579865096,
    "biz_name": "中国人民大学研究生会",
    "account_type": "student_univ",
    "college_name": null
  },
  {
    "biz_id": 3867865164,
    "biz_name": "RUC学生社区",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 2393857094,
    "biz_name": "平安人大",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3542902201,
    "biz_name": "人大学术",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 2391191683,
    "biz_name": "人大就业",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3589360060,
    "biz_name": "中国人民大学发展规划",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3083513117,
    "biz_name": "中国人民大学教务处",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3583667434,
    "biz_name": "中国人民大学数学学院",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3017011409,
    "biz_name": "RUC环境我家",
    "account_type": "student_college",
    "college_name": "生态环境学院"
  },
  {
    "biz_id": 3089042039,
    "biz_name": "缘来物院",
    "account_type": "student_college",
    "college_name": "物理学院"
  },
  {
    "biz_id": 2393011467,
    "biz_name": "信火相传",
    "account_type": "student_college",
    "college_name": "信息学院"
  },
  {
    "biz_id": 3098195133,
    "biz_name": "人大马院",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3011533548,
    "biz_name": "国关党建之窗",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 3909698812,
    "biz_name": "温馨国关",
    "account_type": "student_college",
    "college_name": "国际关系学院"
  },
  {
    "biz_id": 3072036901,
    "biz_name": "中国人民大学国际关系学院",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 2396789174,
    "biz_name": "RUC法学院学生会",
    "account_type": "student_college",
    "college_name": "法学院"
  },
  {
    "biz_id": 2394917473,
    "biz_name": "RUC中法学子",
    "account_type": "student_college",
    "college_name": "法学院"
  },
  {
    "biz_id": 3910732186,
    "biz_name": "爱在劳人",
    "account_type": "student_college",
    "college_name": "劳动人事学院"
  },
  {
    "biz_id": 3273063981,
    "biz_name": "中国人民大学统计学院",
    "account_type": "official",
    "college_name": null
  },
  {
    "biz_id": 2396368202,
    "biz_name": "财金学子",
    "account_type": "student_college",
    "college_name": "财政金融学院"
  },
  {
    "biz_id": 3623674761,
    "biz_name": "应像经彩",
    "account_type": "student_college",
    "college_name": "应用经济学院"
  },
  {
    "biz_id": 2391759501,
    "biz_name": "经院一家人",
    "account_type": "student_college",
    "college_name": "经济学院"
  },
  {
    "biz_id": 3091084908,
    "biz_name": "IRM信青年",
    "account_type": "student_college",
    "college_name": "信息资源管理学院"
  },
  {
    "biz_id": 3070046205,
    "biz_name": "爱公管",
    "account_type": "student_college",
    "college_name": "公共管理学院"
  },
  {
    "biz_id": 3902637152,
    "biz_name": "RUC社院青春",
    "account_type": "student_college",
    "college_name": "社会学院"
  }
]

教务处与政策文档

🏛️
教务站内搜
search_ruc_cms

封装 jiaowu.ruc.edu.cn 的搜索接口，获取通知公告。

Example 
{
  "text": "转专业 办法",
  "site": "jiaowu"
}
📄
Metaso KB 检索
metaso_kb_search

针对培养方案、学生手册 PDF 的向量检索。

由于自建数据库实现向量化难度过大，此工具的实现通过metaso提供的知识库服务

智能体协作 此工具由实际上是让秘塔的智能体组织答案，将信息告诉RUC百事通。

外部能力

🌐
联网与天气
Web Search

基于 Metaso API 的通用网页检索与阅读。用于补充校内没有的信息（如校外竞赛官网）。

tool: "web_search"
Weather

万维天气接口。支持实时天气 weather_now 和未来15天预报 weather_forecast。

tool: "weather_forecast"