| name | health-data-summary |
| description | 综合查询健康数据 — Digital Health Twin 快照、Safety 告警、长期趋势、Orchestrator 多专家分析。当用户想了解自己的整体健康状况、趋势变化、安全风险时使用。 |
| version | 1.0.0 |
| metadata | {"agent":{"requires":{"env":["HEALTH_API_URL","HEALTH_API_TOKEN"],"bins":["curl"]},"primaryEnv":"HEALTH_API_TOKEN","emoji":"📊"}} |
综合查询用户的健康数据和 AI 分析结果。整合了 Digital Health Twin、Safety Guardian、Orchestrator 多专家系统。
Authentication
- URL: ${HEALTH_API_URL}
- Header:
Authorization: Bearer ${HEALTH_API_TOKEN}
使用场景
| 用户说 | 你应该调用的接口 |
|---|
| "我的健康状况怎么样" | Twin + Safety + Orchestrator |
| "我有什么安全风险" | Safety |
| "我过去半年的变化" | Personal Outcome |
| "分析我的 HRV 趋势" | Orchestrator |
| "我该注意什么" | Safety + Orchestrator |
API 端点
1. Digital Health Twin(统一健康快照)
curl -s -H "Authorization: Bearer ${HEALTH_API_TOKEN}" "${HEALTH_API_URL}/twin/me"
返回用户当前的完整健康状态(13 个维度):
physiological: HRV, 心率, 睡眠, 压力, 电量, 步数, SpO2
body_composition: 体重, BMI, 体脂, TDEE, BMR
labs: 血压, 胆固醇, 血糖, 化验异常项
cgm: CGM 血糖读数, TIR, 变异系数
medication: 在服药物, 依从率
supplement: 补剂打卡状态
genetic: 基因变异(药物敏感/风险/保护)
environment: 天气, AQI, PM2.5
behavioral: 饮食, 饮水, 训练负荷, ACWR
mental: 情绪, 精力, 压力 7 日均值
chronic: 鼻炎今日状态
goals: 当前目标
freshness: 各数据源的新鲜度
典型用法:先调 Twin 了解全貌,再根据具体问题深入分析。
2. Safety Guardian 安全告警
curl -s -H "Authorization: Bearer ${HEALTH_API_TOKEN}" "${HEALTH_API_URL}/safety/me"
返回基于 47 条确定性规则的安全告警:
- 药物-药物相互作用 (DDI)
- 药物-补剂相互作用 (DSI)
- 药物基因组学 (PGx: CYP2D6/MTHFR/ALDH2...)
- 急性阈值 (BP/HR/SpO2)
- 化验异常升级 (肝酶/LDL/HbA1c)
- 训练负荷 (ACWR 过载/欠训练)
- CGM 血糖异常
每条告警包含 severity(info/low/medium/high/critical)、action(建议动作)、data_citation(数据溯源)。
3. Orchestrator 多专家综合分析
curl -s -X POST \
-H "Authorization: Bearer ${HEALTH_API_TOKEN}" \
-H "Content-Type: application/json" \
"${HEALTH_API_URL}/orchestrator/chat" \
-d '{"query": "综合分析我的健康状态并给出今日建议"}'
调度最多 10 个专家协作分析:
- SafetyGuardian, RecoveryCoach, FuelStrategist, MovementCoach
- MentalHealthCompanion, HypertensionSpecialist, MetabolicSpecialist
- RhinitisSpecialist, KnowledgeLibrarian, LongitudinalAnalyst
返回每个专家的结构化 finding + LLM 合成的自然语言回答。
4. 长期趋势(Personal Outcome)
curl -s -H "Authorization: Bearer ${HEALTH_API_TOKEN}" \
"${HEALTH_API_URL}/personal-outcome/me/timeline?range=6m&granularity=month"
- range:
6m / 1y / 2y
- granularity:
week / month
返回:
points[]: 每月/每周的 HRV, 静息心率, 睡眠, 体重, 血压均值
events[]: 干预事件(开始补剂/体检/里程碑)
summary.metrics: 每个指标的 first→last 变化和趋势方向
5. 安全告警解读
curl -s -X POST \
-H "Authorization: Bearer ${HEALTH_API_TOKEN}" \
-H "Content-Type: application/json" \
"${HEALTH_API_URL}/safety/explain" \
-d '{
"rule_id": "labs.liver_enzyme_pattern",
"data_citation": {"alt": {"value": 54}, "ast": {"value": 67}},
"message": "肝酶组合升高"
}'
对单条安全告警请求 LLM 个性化解读,结合用户真实健康数据给出具体建议。
6. 已注册的安全规则列表
curl -s -H "Authorization: Bearer ${HEALTH_API_TOKEN}" "${HEALTH_API_URL}/safety/rules"
返回全部 47 条规则的名称列表(透明度用)。
7. Agent 审计日志
curl -s -H "Authorization: Bearer ${HEALTH_API_TOKEN}" "${HEALTH_API_URL}/safety/audit?limit=10"
查看最近的 agent 决策历史(谁做了什么分析、多少告警、用了多少毫秒)。
推荐查询组合
"我的健康状况怎么样"
- 调
/twin/me → 获取全貌
- 调
/safety/me → 获取安全风险
- 用两者数据回答用户
"过去半年我进步了吗"
- 调
/personal-outcome/me/timeline?range=6m → 获取趋势
- 提取 summary.metrics 的 delta 和方向
- 找出改善和恶化的指标
"我今天能高强度训练吗"
- 调
/orchestrator/chat query="我今天能高强度训练吗"
- 直接用返回的 synthesis 回答用户
行为规则
- 回答健康问题时优先调 Twin + Safety,确保答案基于真实数据
- 不要猜测用户的数据 — 调 API 获取真实值
- 安全告警必须提及,即使用户没有问(这是安全义务)
- 涉及药物/基因的问题,引用 Safety Guardian 的确定性规则结果
- 长期趋势问题调 personal-outcome,不要凭记忆回答