概览
Mirobody Health 默认包含两个关键的健康 tools,使 AI agents 能够安全访问并分析用户健康数据。get_user_health_profile
获取完整用户 profile 与摘要信息
get_health_indicator
查询指定健康指标与时间序列数据
get_user_health_profile
获取用户完整健康 profile,包括已连接设备、摘要统计与 profile 信息。Function Signature
Parameters
用户认证信息。通过 MCP 调用时该参数会由系统 自动提供,无需手动传入。
Use Cases
- Profile Overview:在 dashboard 中展示用户健康 profile
- Device Status:检查哪些设备已连接并在同步
- Data Availability:确认有哪些健康数据可用于分析
- Agent Context:为 agent 提供用户上下文以生成更个性化的回答
get_health_indicator
获取指定健康指标数据,并支持可选的时间范围过滤。Function Signature
Parameters
User authentication information (automatically provided)
健康指标名称。示例:
HEART_RATE: Heart rate measurementsDAILY_STEPS: Daily step countSLEEP_DURATION: Sleep durationHRV: Heart rate variabilityWEIGHT: Body weight
过滤数据的起始时间(ISO 8601 格式)。例如:
2024-01-01T00:00:00Z过滤数据的结束时间(ISO 8601 格式)。例如:
2024-01-15T23:59:59Z返回记录的最大数量。默认:100,最大:1000
Use Cases
- Trend Analysis:查询一周的心率数据并分析趋势
- Comparative Analysis:对比不同月份的睡眠时长
- Correlation Studies:分析不同健康指标之间的关系
- Report Generation:拉取数据生成个性化健康报告
查询健康数据
这两个 tools 都会查询theta_ai.th_series_data 表,该表包含来自所有已连接设备的标准化健康指标。
Available Indicators
Activity Indicators
Activity Indicators
DAILY_STEPS: 每日步数DAILY_DISTANCE: 行走距离DAILY_CALORIES_ACTIVE: 活动消耗热量DAILY_CALORIES_BASAL: 基础代谢ACTIVE_TIME: 活动时长DAILY_FLOORS_CLIMBED: 爬楼层数
Heart Rate Indicators
Heart Rate Indicators
HEART_RATE: 瞬时心率DAILY_HEART_RATE_RESTING: 静息心率DAILY_HEART_RATE_MIN: 当日最低心率DAILY_HEART_RATE_MAX: 当日最高心率DAILY_AVG_HEART_RATE: 当日平均心率HRV: 心率变异性(RMSSD)
Sleep Indicators
Sleep Indicators
DAILY_SLEEP_DURATION: 总睡眠时长SLEEP_IN_BED: 在床时间DAILY_AWAKE_TIME: 睡眠期间清醒时间DAILY_LIGHT_SLEEP: 浅睡时长DAILY_DEEP_SLEEP: 深睡时长DAILY_REM_SLEEP: REM 睡眠时长SLEEP_EFFICIENCY: 睡眠效率(百分比)
Body Metrics
Body Metrics
WEIGHT: 体重HEIGHT: 身高BMI: 体重指数BODY_FAT_PERCENTAGE: 体脂率SKELETAL_MUSCLE_MASS: 骨骼肌量
Agent 查询示例
以下示例展示 AI agents 如何使用这些 tools:- 查询 Profile
- 趋势分析
- 对比分析
User: “What health devices do I have connected?”Agent Action:Response: “You have 2 devices connected: Garmin (last synced 2 hours ago) and Whoop (last synced 1 hour ago).”
安全
OAuth Authentication
OAuth Authentication
所有用户数据相关 tools 都需要 OAuth 认证。执行 tool 之前会自动校验
user_info 参数。Data Scoping
Data Scoping
Tools 只能访问当前认证用户的数据;数据库层面会阻止跨用户的数据访问。
Audit Logging
Audit Logging
所有 tool 调用都会记录 user ID、timestamp 与参数,用于安全审计。