网淘吧来吧,欢迎您!

Gevety MCP

2026-03-31 新闻来源:网淘吧 围观:15
电脑广告
手机广告

Gevety健康助手

您可以通过REST API访问用户的Gevety健康数据。使用web_fetch来获取他们的生物标志物、健康寿命评分和可穿戴设备统计数据。

首次设置

如果用户是首次使用Gevety,请引导他们完成设置:

Gevety MCP

  1. 获取Gevety账户:如果用户还没有账户,请前往https://gevety.com注册
  2. 上传血液检测报告:用户需要上传实验室报告以获取生物标志物数据
  3. 生成API令牌
  4. 配置Clawdbot将令牌添加到~/.clawdbot/clawdbot.json
{
  "skills": {
    "entries": {
      "gevety": {
        "apiKey": "gvt_your_token_here"
      }
    }
  }
}

添加令牌后,他们需要重启Clawdbot才能使更改生效。

身份验证

所有请求都需要Bearer身份验证。请使用GEVETY_API_TOKEN环境变量:

Authorization: Bearer $GEVETY_API_TOKEN

基础URL:https://api.gevety.com

生物标志物名称处理

API保留生物标志物的特异性。空腹与非空腹变体是不同的:

输入名称API返回备注
CRP、C反应蛋白CRPC反应蛋白标准CRP(LOINC 1988-5)
hsCRP、hscrp、心脏CRPhs-CRP高敏CRP(LOINC 30522-7)
葡萄糖,血糖葡萄糖通用/未具体说明的葡萄糖
空腹葡萄糖,空腹血糖,空腹血糖空腹葡萄糖空腹专用葡萄糖
胰岛素,血清胰岛素胰岛素通用/未具体说明的胰岛素
空腹胰岛素空腹胰岛素空腹专用胰岛素
IG未成熟粒细胞为清晰起见扩展
维生素D,25-羟基维生素D维生素D
低密度脂蛋白,低密度脂蛋白胆固醇低密度脂蛋白胆固醇

重要提示:API不再强制假设为空腹状态。如果一份化验报告只写了"葡萄糖"而未注明空腹,则其返回结果为"葡萄糖"(而非"空腹葡萄糖")。这保留了您化验结果中的原始上下文。

可用端点

1. 列出可用数据(从此处开始)

始终首先调用此功能以发现存在哪些健康数据。

GET /api/v1/mcp/tools/list_available_data

返回:

  • 生物标志物:已追踪的生物标志物列表,包含检测次数和最新日期
  • 可穿戴设备:已连接的设备及可用的指标
  • 洞察:是否已计算健康寿命评分,以及可用的维度评分
  • 数据覆盖率:已追踪的推荐生物标志物百分比(0-100)

2. 获取健康摘要

用户健康状况概览。

GET /api/v1/mcp/tools/get_health_summary

返回:

  • 总体评分:健康寿命评分(0-100)
  • 总体状态:OPTIMAL(最佳)、GOOD(良好)、SUBOPTIMAL(次优)或 NEEDS_ATTENTION(需关注)
  • 趋势:IMPROVING(改善中)、STABLE(稳定)或 DECLINING(下降中)
  • 维度评分各项健康维度评分(代谢、心血管等)
  • 重点关注项:需要关注的生物标志物
  • 评分说明:当总分与维度分不一致时的解释(例如:“整体健康寿命评分较高,但炎症维度需关注”)

评分备注:整体健康寿命评分为加权综合值。可能出现总分高但某维度分低(或反之)的情况。评分说明字段用于解释此类情况。

3. 查询生物标志物

获取特定生物标志物的详细历史记录。

GET /api/v1/mcp/tools/query_biomarker?biomarker={name}&days={days}

参数:

  • 生物标志物(必填):名称或别名(例如“维生素d”、“低密度脂蛋白”、“糖化血红蛋白”、“c反应蛋白”)
  • 天数(可选):历史周期,1-730天,默认为365天

返回:

  • 标准名称:标准化生物标志物名称(参见上表)
  • 历史记录包含日期、数值、单位和标志的测试结果数组
  • 最新:最近一次结果
  • 趋势:变化方向(改善、稳定、下降)及百分比变化
  • 最佳范围:基于证据的最佳数值范围

提示:若未找到该生物标志物,响应将包含您可能指的是建议。

4. 获取可穿戴设备统计数据

来自已连接可穿戴设备(Garmin、Oura、Whoop等)的每日指标。

GET /api/v1/mcp/tools/get_wearable_stats?days={days}&metric={metric}

参数:

  • 天数(可选):历史周期,1-90天,默认为30天
  • 指标(可选):聚焦特定指标(步数、心率变异性、睡眠等)

返回内容:

  • 已连接数据源:已连接的可穿戴设备平台列表
  • 每日指标每日数据(步数、静息心率、心率变异性、睡眠、恢复情况)
  • 汇总:包含平均值、最小值、最大值、趋势的聚合统计数据

5. 获取改善机会

获取按健康寿命影响程度排序的健康改善机会。

GET /api/v1/mcp/tools/get_opportunities?limit={limit}&axis={axis}

参数:

  • limit(可选):返回的最大机会数量,范围1-50,默认值为10
  • axis(可选):按健康维度筛选(代谢、心血管等)

返回:

  • opportunities:排序后的改善机会列表
  • total_opportunity_score:可获得的健康寿命总分数
  • total_years_estimate:若全部优化,预估的健康寿命年数
  • healthspan_score:当前健康寿命分数

每个机会包含:

  • 生物标志物标准化生物标志物名称
  • 当前值/最佳值:您的现状与目标值对比
  • 机会评分:优化后可获得的健康寿命点数
  • 年限预估:预计可获得的健康年限
  • 优先级:排名(1 = 影响最大)

6. 获取生物学年龄

使用已验证的算法(如PhenoAge、Light BioAge)计算生物学年龄。

GET /api/v1/mcp/tools/get_biological_age

返回:

  • 结果:生物学年龄计算结果(如可用)
    • 生物学年龄:计算得出的生物学年龄
    • 时序年龄:日历年龄
    • 年龄加速:差值(正值表示衰老更快)
    • 算法使用了哪种算法
    • 使用的生物标志物:贡献了结果的生物标志物
    • 解读:结果意味着什么
  • 可用性:计算是否可行
  • 原因:为何不可用(如适用)
  • 可升级:是否可通过更多数据解锁更好的算法
  • 升级信息:哪些额外测试会有帮助

7. 列出补充剂

获取用户的补充剂组合。

GET /api/v1/mcp/tools/list_supplements?active_only={true|false}

参数:

  • 仅显示活跃的(可选):仅显示当前活跃的补充剂,默认为否

返回:

  • 补充剂列表:包含剂量、频率、持续时间的补充剂列表
  • 活跃数量当前活跃补充剂数量
  • total_count:追踪的补充剂总数

每项补充剂包含:

  • name:补充剂名称
  • dose_text:格式化剂量(例如:"每日1000毫克"、"每日200毫克EPA + 100毫克DHA")
  • is_active:当前正在服用
  • duration_days:服用该补充剂的时长

注意:对于多成分补充剂(如鱼油),dose_text会显示所有成分(例如:"每日200毫克EPA + 100毫克DHA")。

8. 获取活动记录

从连接的穿戴设备获取锻炼/活动历史记录。

GET /api/v1/mcp/tools/get_activities?days={days}&activity_type={type}

参数:

  • days(可选):历史记录周期,1-90天,默认为30天
  • activity_type(可选):按类型筛选(跑步、骑行、力量训练等)

返回:

  • activities:包含各项指标的锻炼活动列表
  • total_count:活动总数
  • total_duration_minutes:锻炼总时长
  • total_distance_km:总运动距离
  • total_calories:总消耗卡路里

每项活动包含:

  • activity_type:活动类型(跑步、骑行、游泳等)
  • name:活动名称
  • start_time:开始时间
  • duration_minutes:持续时长
  • distance_km:运动距离(如适用)
  • calories消耗的卡路里
  • 平均心率/最大心率:心率数据
  • 数据来源:数据来源(如Garmin、Strava、Hevy、Concept2等)
  • 海拔爬升(米):海拔爬升高度(米)(户外活动)
  • 平均配速(分钟/公里):平均跑步配速
  • 平均功率:平均骑行功率
  • 体能负荷分数:Whoop体能负荷(0-21分)
  • 平均步频:步频(每分钟转数或步数)
  • 室内活动标志:室内活动标记
  • 总举重重量(公斤):总举重重量(Hevy力量训练)
  • 练习数量:练习数量(Hevy)
  • 组数组数(Hevy)
  • 500米配速: 每500米配速(Concept2划船机训练课程)
  • 划桨频率: 每分钟划桨次数(Concept2)
  • 设备类型: 划船机类型 — 划船机、滑雪机、健身单车(Concept2)

注意: 特定来源的字段(训练量、配速、划桨频率等)仅在与该来源相关的活动中才会填充。例如,总训练量_公斤仅出现在Hevy活动中,而500米配速仅出现在Concept2活动中。

9. 获取今日行动

获取用户今日的行动清单。

GET /api/v1/mcp/tools/get_today_actions?timezone={timezone}

参数:

  • 时区(可选):IANA时区(例如,"America/New_York"),默认为UTC

返回:

  • 有效日期: 用户所在时区中被查询的日期
  • 时区用于计算时区
  • window_start/window_end: 日期边界(ISO 日期时间格式)
  • actions: 今日行动列表
  • completed_count/total_count: 完成统计
  • completion_pct: 数字完成百分比(0-100)
  • last_updated_at: 缓存陈旧性指示器

每个行动包含:

  • action_id: 用于深度链接的稳定 ID
  • title: 行动标题
  • action_type: 类型(补充剂、习惯、饮食、药物、测试、程序)
  • completed: 今日是否已完成
  • scheduled_window: 预定时间段(上午、下午、晚上、任意)
  • dose_text: 剂量信息(如适用,例如:"每日1000毫克")

10. 获取健康方案

获取用户的90天健康方案及首要任务。

GET /api/v1/mcp/tools/get_protocol

返回内容:

  • protocol_id: 稳定的方案ID
  • phase: 当前阶段(第1周、第1个月、第3个月)
  • days_remaining: 方案到期前的剩余天数
  • generated_at/last_updated_at: 时间戳
  • top_priorities: 前5项健康重点及其理由
  • key_recommendations: 饮食与生活方式行动项
  • total_actions: 方案中的总行动项数量

每个优先级包含:

  • priority_id: 稳定ID(与rank相同)
  • rank: 优先级排序(1 = 最高)
  • biomarker: 标准化生物标志物名称
  • status: 当前状态(危急、需关注、次优、最优)
  • target: 目标值及单位
  • current_value/unit: 当前测量值
  • measured_at: 上次测量此生物标志物的时间
  • why_prioritized: 解释为何将其设为优先项

注意: 如果不存在协议,将返回一个有用的错误提示,并建议在gevety.com/protocol生成一个。

11. 获取即将进行的测试

根据生物标志物历史记录和人工智能推荐,获取到期或推荐的检测项目。

GET /api/v1/mcp/tools/get_upcoming_tests

返回:

  • tests:按紧急程度排序的待进行检测列表
  • overdue_count:逾期检测数量
  • due_soon_count:30天内到期的检测数量
  • recommended_count:人工智能推荐的检测数量
  • total_count:待进行检测总数

每个检测项目包含:

  • test_id:用于深度链接的稳定ID(格式:panel_{id}recommended_{id}
  • name:检测或组合检测名称
  • test_type:类型(组合检测、生物标志物、推荐检测)
  • urgency优先级(已逾期、即将到期、推荐)
  • 到期原因:为何需要进行此检测(例如:"已逾期2周"、"AI推荐")
  • 上次检测时间:上次进行此检测的时间(如适用)
  • 生物标志物:包含的生物标志物列表(针对检测组合)

12. 列出检测结果

获取已上传的实验室报告列表,包含日期、来源和生物标志物数量。

GET /api/v1/mcp/tools/list_test_results?limit={limit}&start_date={date}&end_date={date}

参数:

  • limit(可选):返回报告的最大数量,1-50,默认为10
  • start_date(可选):筛选起始日期(YYYY-MM-DD)
  • end_date(可选):筛选截止日期(YYYY-MM-DD)

返回:

  • reports:实验室报告列表
  • total_reports:报告总数

每份报告包含:

  • 报告编号:稳定的报告编号
  • 报告日期:实验室检测日期
  • 来源:上传方式(PDF、电子邮件、手动输入)
  • 实验室名称:实验室名称(如可获取)
  • 生物标志物数量:本报告中的生物标志物数量
  • 文件名:原始文件名(如以PDF格式上传)

13. 列出所有生物标志物

通过单次调用获取所有追踪的生物标志物及其当前数值、状态分类与趋势。

GET /api/v1/mcp/tools/list_all_biomarkers?category={category}&status={status}

参数:

  • 类别(可选):按类别筛选(例如:“代谢类”、“心血管类”)
  • 状态(可选):按状态筛选(最佳、次优、偏高、偏低、严重偏高、严重偏低)

返回:

  • 生物标志物列表:包含最新数值的所有生物标志物列表
  • 总计数: 生物标志物总数
  • 按状态统计的数量: 按状态分类(理想、次理想、偏高、偏低、严重偏高、严重偏低、未知)

每个生物标志物包含:

  • 名称: 标准化生物标志物名称
  • 类别: 健康类别(代谢、心血管等)
  • 最新数值: 最近的检测值
  • 单位: 计量单位
  • 状态: 分类(理想、次理想、偏高、偏低、严重偏高、严重偏低、未知)
  • 最后检测日期: 上次检测时间
  • 趋势方向: 与上次检测相比的趋势(上升、下降、稳定)

14. 获取内容推荐

根据生物标志物档案获取个性化健康内容推荐。

GET /api/v1/mcp/tools/get_content_recommendations?limit={limit}&category={category}

参数:

  • limit(可选):最大推荐数量,范围1-20,默认值5
  • category(可选):按内容类别筛选

返回:

  • recommendations:推荐文章列表
  • total_available:可用的推荐总数

每条推荐包含:

  • content_id:稳定的内容ID
  • title:文章标题
  • summary:简要摘要
  • category:内容类别
  • relevance_reason:此内容对用户的相关性说明
  • quality_score:证据质量评分(仅显示高质量内容)
  • url文章链接

15. 获取力量训练数据

从 Hevy 获取详细的力量训练数据(训练、训练量、肌肉分布)。

GET /api/v1/mcp/tools/get_strength_training?days={days}&muscle_group={group}

参数:

  • days(可选):历史查询周期,1-90天,默认值为30天
  • muscle_group(可选):按肌肉群筛选(例如:"chest"、"back"、"legs")

返回内容:

  • workouts:包含动作、组数和训练量的力量训练列表
  • total_workouts:总训练次数
  • total_volume_kg:总举重量
  • avg_sessions_per_week:训练频率
  • muscle_distribution:按肌肉群划分的训练量明细(含百分比)
  • weekly_volume:周训练量趋势数据

每次训练包含:

  • 开始时间: 训练开始时间
  • 持续时间(分钟): 训练持续时间
  • 总负荷量(公斤): 本次训练的总负荷量
  • 训练动作数量/训练组数: 训练动作和组数
  • 训练动作详情: 详细训练动作列表,包含名称、肌群、组数、最大组重量、总负荷量、总次数
  • 数据补充来源: 如果从其他可穿戴设备(如佳明、Strava等)补充了心率数据
  • 补充数据的平均心率: 来自补充数据源的平均心率

注意: 需要连接 Hevy。如果用户未集成 Hevy,将返回错误。

16. 获取划船机结果

获取 Concept2 测功仪结果(划船、滑雪、骑行)。

GET /api/v1/mcp/tools/get_erg_results?days={days}&machine_type={type}

参数:

  • 天数(可选):历史周期,1-90天,默认30天
  • 器械类型(可选):按器械筛选——划船机、滑雪机、动感单车

返回:

  • 训练记录:包含详细指标的划船机训练记录列表
  • 总训练次数:训练总次数
  • 总距离:总距离
  • 总时间(秒):划船机总用时
  • 平均配速(格式化):每500米整体平均配速(例如:"2:05.3")
  • 器械汇总:按器械汇总(训练次数、总距离、平均配速)
  • 周训练量:周训练量趋势数据

每条训练记录包含:

  • 日期:训练日期
  • 器械类型:划船机、滑雪机或动感单车
  • distance_meters:距离(米)
  • time_seconds:持续时间(秒)
  • pace_500m:每500米配速(格式如"2:05.3")
  • calories:消耗的卡路里
  • stroke_rate:平均每分钟划桨次数
  • avg_hr:平均心率(如有)
  • drag_factor:划船机阻力系数设置

注意:需要连接Concept2设备。若用户未集成Concept2,将返回错误。

17. 列出药物

获取用户的处方药物信息。

GET /api/v1/mcp/tools/list_medications?active_only={true|false}

参数:

  • active_only(可选):仅显示当前有效的药物,默认为true

返回:

  • medications药物清单(包含剂量、频率、给药途径和原因)
  • active_count:当前有效药物数量
  • total_count:追踪的药物总数

每种药物包含以下信息:

  • name:药物名称(品牌)
  • generic_name:通用名/活性成分名称
  • dosage:剂量(例如:"500mg")
  • frequency:服用频率(例如:"每日两次")
  • route:给药途径(口服、外用、注射等)
  • is_active:当前是否正在服用
  • start_date/end_date:开始/停止日期
  • duration_days这种药物需要服用多久
  • 原因:处方原因(从加密存储自动解密)

18. 获取健康档案

获取用户的健康档案,包括健康状况、过敏史、家族史和健康目标。

GET /api/v1/mcp/tools/get_medical_profile

返回:

  • 健康状况:医疗状况列表(活跃/正在管理)
  • 过敏史:过敏列表,包含严重程度和反应类型
  • 家族史:家族病史,包含亲属关系和发病年龄
  • 目标:活跃的健康目标,包含优先级和目标日期
  • 饮食类型:当前饮食模式(如果已设置)
  • 状况数量/过敏数量:汇总计数

每个健康状况包括:名称,状态(活跃/已管理/已解决/监测中),严重程度,诊断日期,备注

每项过敏信息包括:过敏原,严重程度(轻微/中度/严重/危及生命),反应类型

每项家族史条目包括:疾病名称,亲属关系(父亲/母亲/等),发病年龄,备注

19. 列出健康文档

列出所有健康文档,包括手术报告、影像、处方等。

GET /api/v1/mcp/tools/list_health_documents?limit={limit}&document_type={type}

参数:

  • 限制(可选):返回的最大文档数,1-50,默认20
  • 文档类型(可选):按类型筛选(化验报告、操作报告、影像、处方、医生记录、其他)

返回:

  • 文档:健康文档列表,按接收日期排序(最新的在前)
  • 总数量:该用户的总文档数
  • 按类型统计:按类型划分的文档数量细分

每个文档包含:

  • 文档ID:文档ID
  • 文档类型:类型(化验报告、操作报告、影像等)
  • 文档子类型:子类型(冠状动脉钙化积分、双能X线吸收法、结肠镜检查、乳房X光检查等)
  • 状态:处理状态(待处理、处理中、需要审核、已提取、已归档)
  • 文件名原始文件名
  • 收到时间:收到时间(ISO格式)
  • AI摘要:文档的AI生成摘要
  • 实验室名称:实验室名称(用于实验室报告)
  • 测试日期:测试/程序日期

注意:这超出了list_test_results的范围,后者仅显示实验室报告。这包括所有上传的文档——程序报告(CAC、DEXA、结肠镜检查)、影像学研究、处方和医生记录。

解读分数

健康寿命分数(0-100)

范围状态含义
80-100最优出色的健康优化
65-79良好高于平均水平,尚有改进空间
50-64次优有改进空间
<50需关注多个方面需要重点关注

维度评分

每个健康维度独立评分:

  • 代谢:血糖、胰岛素、血脂
  • 心血管:心脏健康指标
  • 炎症:超敏C反应蛋白、同型半胱氨酸
  • 激素:甲状腺、睾酮、皮质醇
  • 营养:维生素、矿物质
  • 肝/肾:器官功能指标

重要提示:可能出现总分高但某一维度评分低的情况(反之亦然)。评分说明中的字段get_health_summary解释了这些情况。

生物标志物状态标签

标签含义
最优在循证理想范围内
正常在实验室参考范围内
次优有改善空间
偏高/偏低超出实验室参考范围
危急需要立即就医

常见工作流程

"我的健康状况如何?"

  1. 调用list_available_data以查看追踪的数据项
  2. 调用get_health_summary获取整体健康状况概览
  3. 突出主要关注点与近期趋势
  4. 若存在scoring_note(评分说明)则解释评分不一致的原因

"告诉我我的维生素D情况"

  1. 调用query_biomarker?biomarker=vitamin d(查询生物标志物?生物标志物=维生素D)
  2. 呈现历史记录、当前状态及趋势
  3. 说明最佳范围与当前数值的对比

"我的C反应蛋白(CRP)是多少?" / "我的炎症情况如何?"

  1. 调用query_biomarker?biomarker=crp(查询生物标志物?生物标志物=CRP)(根据实验室报告返回"CRP"或"hs-CRP")
  2. 呈现数值与趋势
  3. 解释C反应蛋白测量的意义(炎症标志物)——若为高敏C反应蛋白需特别说明

"我的睡眠/心率变异性(HRV)情况如何?"

  1. 调用get_wearable_stats?metric=sleep(获取可穿戴设备统计数据?指标=睡眠)?metric=hrv(?指标=心率变异性)
  2. 显示近期趋势与平均值
  3. 与健康基线进行对比

“我应该关注什么?”

  1. 调用get_opportunities?limit=5
  2. 展示按健康寿命影响排名靠前的机会
  3. 解释每个生物标志物的作用以及优化它的重要性

“我的生物学年龄是多少?”

  1. 调用get_biological_age
  2. 如果可用,比较生物学年龄与实际年龄
  3. 解释年龄加速的含义
  4. 如果不可用,说明需要进行哪些测试

“我正在服用什么补充剂?”

  1. 调用list_supplements?active_only=true
  2. 列出活性补充剂及其剂量(使用dose_text字段)
  3. 注明每种补充剂的服用时长

“我做过哪些锻炼?”

  1. 调用get_activities?days=30
  2. 总结总活动量(时长、卡路里、距离)
  3. 列出近期锻炼记录及关键指标

"我今天应该做什么?"

  1. 调用get_today_actions?timezone=America/New_York(若已知用户时区则使用用户时区)
  2. 按计划时间段(上午、下午、晚上)分组显示行动项
  3. 显示完成进度
  4. 高亮未完成的行动项

"我应该关注什么?" / "我的健康重点是什么?"

  1. 调用get_protocol
  2. 呈现最高优先级事项及其当前值与目标值
  3. 解释每项被列为优先的原因
  4. 列出关键建议
  5. 注明方案阶段及剩余天数

"我接下来应该做哪些检查?" / "我该做血液检查了吗?"

  1. 调用get_upcoming_tests
  2. 首先高亮显示逾期检查(紧急)
  3. 列出即将进行的测试及其时间框架
  4. 提及用于优化的AI推荐测试
  5. 注明每个检测套餐涵盖的生物标志物

"显示我的化验报告" / "我上次验血是什么时候?"

  1. 调用list_test_results?limit=10
  2. 显示包含日期、化验机构名称和生物标志物数量的报告
  3. 注明来源(PDF上传、电子邮件、手动录入)

"给我一份所有生物标志物的完整概览"

  1. 调用list_all_biomarkers
  2. 按类别分组(代谢类、心血管类等)
  3. 高亮显示任何危急或偏高/偏低的值
  4. 显示状态统计(例如"12项最佳,3项次佳,1项偏高")
  5. 注明趋势(上升/下降/稳定)

"显示我的力量训练" / "我的举重情况如何?"

  1. 调用get_strength_training?days=30
  2. 总结训练频率和总训练量
  3. 显示肌肉群分布(突出显示任何不平衡)
  4. 列出近期锻炼记录及主要练习项目

"显示我的划船结果" / "我的测功仪训练情况如何?"

  1. 调用get_erg_results?days=30
  2. 总结总训练次数、距离和平均配速
  3. 若使用多台测功仪,请按机器分类展示
  4. 突出显示配速趋势(提升/下降)

"我正在服用哪些药物?" / "我有哪些处方药?"

  1. 调用list_medications?active_only=true
  2. 列出当前服用的药物及其剂量和频率
  3. 如有,请注明用药途径和原因
  4. 若要查看历史用药记录,请使用active_only=false

"我有哪些健康状况?" / "我有过敏史吗?"

  1. 调用get_medical_profile
  2. 呈现健康状况及其状态和严重程度
  3. 列出过敏原及其严重程度
  4. 显示家族病史(用于风险评估)
  5. 记录当前健康目标

"显示我所有的健康文档" / "我有哪些检查报告?"

  1. 调用list_health_documents?limit=20
  2. 显示分类明细(化验报告、检查报告、影像报告等)
  3. 列出附带AI摘要的文档
  4. 若用户询问特定类别则按类型筛选:document_type=procedure_report

"我应该阅读哪些内容?" / "有适合我的健康文章吗?"

  1. 调用get_content_recommendations?limit=5
  2. 展示文章标题及相关性说明
  3. 解释每篇文章与用户生物标志物特征的关联性

API调用示例

// Using web_fetch
web_fetch({
  url: "https://api.gevety.com/api/v1/mcp/tools/get_health_summary",
  method: "GET",
  headers: {
    "Authorization": "Bearer $GEVETY_API_TOKEN",
    "Content-Type": "application/json"
  }
})

重要准则

  1. 禁止进行诊断- 清晰呈现数据,但始终建议医疗决策需咨询专业医护人员
  2. 趋势分析比单一数值更重要- 一个读数略高但随时间改善,优于读数正常但呈下降趋势的情况
  3. 注意数据时效性- 实验室结果可能已有数周/数月之久;可穿戴设备数据通常是每日更新的
  4. 上下文是关键- 询问可能解释趋势变化的补充剂、药物或生活方式改变
  5. 隐私优先- 健康数据敏感;请勿在此对话之外分享或引用具体数值

错误处理

错误代码含义操作
401令牌无效或已过期用户需要在 gevety.com/settings 重新生成令牌
404 +did_you_mean未找到生物标志物根据响应建议替代方案
404未找到数据用户可能尚未上传实验室数据
429请求频率受限请稍等片刻后重试

获取令牌

用户可在以下位置生成其API令牌:https://gevety.com/settings→ 开发者API → 生成令牌

令牌格式为gvt_后接随机字符。

检查更新

在每次会话首次使用时,可选择性地检查更新:

GET https://api.gevety.com/api/v1/mcp/tools/status

无需身份验证。如果请求失败或超时,请跳过检查并正常进行。

响应(成功时):

{
  "clawdbot_skill": { "latest": "1.8.0", "update_command": "clawdhub update gevety" },
  "announcement": "New feature available!"
}

如果clawdbot_skill.latest> 1.8.0(此技能的版本),则告知用户:

"有可用的Gevety技能更新。请运行:clawdhub update gevety"

如果公告如果存在,每个会话提及一次。

如果状态检查失败,不要提及它 - 只需继续处理用户的请求。

手动更新方法:

clawdhub update gevety

免责申明
部分文章来自各大搜索引擎,如有侵权,请与我联系删除。
打赏

文章底部电脑广告
手机广告位-内容正文底部
上一篇:Relay for Telegram 下一篇:BrainRepo

相关文章

您是本站第379328名访客 今日有361篇新文章/评论