用途:通过 HealthEx(OAuth + MCP 健康记录)连接个人健康档案,回答关于用药、化验结果、诊断和健康史的问题,也可为饮食计划、健身方案、就诊准备、旅行健康、睡眠与压力管理等提供个人健康背景。
主要能力:支持查询病情、用药、过敏、化验、生命体征、免疫接种、手术、就诊、临床笔记和健康摘要;提供跨数据交叉引用、护理缺口检测(如化验过期、就诊间隔过久、免疫或筛查缺失)、风险因素聚合和结合个人档案的上下文健康指导;记录读取保留原始临床时间戳,并在来源提供真实时刻时附加语义 UTC 与用户本地时间形式。
必要用法:工具命令为 $JARVIS_BIN_DIR/healthex <subcommand>。子命令包括 status(检查连接状态)、setup(写入启用 PKCE 的 OAuth 默认值)、disconnect、authorize-url [--state <state>](生成 PKCE 授权链接)、refresh、mcp-list(列出可用 MCP 工具)、mcp-call --tool <name> [--args '<json>']。任何数据访问前须先运行 healthex status 完成连接守卫;未连接时通过 authorize-url 生成的链接让用户授权,授权范围为由 HealthEx 聚合的医疗提供方记录的只读访问,访问持续到用户在 HealthEx 账户中撤销。数据检索先按问题相关类别拉取,再按需深入;需要其他工具时运行 healthex mcp-list 查看参数模式。
限制:get_health_summary 相对较慢且常被后台化,不能作为唯一上下文来源;遇到返回运行中句柄时须轮询至完成或回退到分类工具,绝不能把句柄当数据。分页时只有连续两个空窗口或达到 10 次调用上限才停止;停止在未穷尽处不得将未获取内容视为缺失。工具未返回真实数据时(空、占位、处理中、失败),必须明确说明数据不可用并给出下一步,严禁编造检验值、生命体征、诊断、剂量或日期,这是最高优先级安全规则。不得做出医学诊断、治疗建议或临床解释;不打印 access_token 或 refresh_token;健康数据敏感,不超出当前请求存储或保留;呈现洞察时须注明来源,如“Based on your HealthEx records...”。
适用场景:用户询问自身医疗数据、处方、化验结果、诊断或健康史时;回答需要个人健康背景时,如饮食或膳食计划、健身评估、就诊准备、旅行健康需求、睡眠或压力优化。