Garmin Skill

使用 AI 与您的 Garmin Connect 数据进行对话。可询问关于跑步、骑行、游泳、训练负荷、VO₂ Max、心率区间以及表现趋势等问题。本功能由 Transition 提供支持，Transition 与 Garmin Connect 同步，使 AI 智能体能够访问您的训练数据。

设置

1. 下载 Transition 并连接您的 Garmin 账户
2. 进入 Settings > API Keys，点击 Generate New Key
3. 设置环境变量：

export TRANSITION_API_KEY="tr_live_xxxxxxxxxxxxxxxxxxxxx"

无需认证

每日训练（Workout of the Day）

生成一个随机的结构化训练计划 —— 无需账户即可使用。

curl "https://api.transition.fun/api/v1/wod?sport=run&duration=45"

参数说明：

• sport — 可选值：run、bike、swim 或 strength（默认为 run）
• duration — 时长（单位：分钟），取值范围为 10–300（默认为 45）

需认证的接口

基础 URL： https://api.transition.fun
认证方式： 每次请求均需在请求头中携带 X-API-Key。

AI 教练对话（AI Coach Chat）

就您的 Garmin 数据提出问题。AI 教练全面掌握您的运动记录、训练负荷及表现数据。

curl -X POST -H "X-API-Key: $TRANSITION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "How has my running volume changed this month compared to last?"}' \
  "https://api.transition.fun/api/v1/coach/chat"

示例问题：

• “我本周最长的一次跑步距离是多少？”
• “我的 VO₂ Max 近期趋势如何？”
• “根据我最近的 Garmin 数据，我是否处于过度训练状态？”
• “对比我本月与上月的骑行功率数据”
• “我的心率数据反映了哪些体能状况？”

获取训练计划（Get Workouts）

获取指定日期范围内的已排定训练计划。

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/workouts?start=2026-02-09&end=2026-02-15"

参数说明：

• start — 起始日期（格式：YYYY-MM-DD，必填）
• end — 结束日期（格式：YYYY-MM-DD，必填）
• start 与 end 之间的最大时间跨度为 90 天。

表现管理图表（Performance Management Chart, PMC）

获取基于您的 Garmin 运动数据计算得出的 CTL（体能）、ATL（疲劳度）和 TSB（状态）指标。

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/performance/pmc"

表现统计数据（Performance Stats）

获取 FTP、阈值配速、心率区间以及其他从 Garmin 数据推导出的关键指标。

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/performance/stats"

运动员档案（Athlete Profile）

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/profile"

对话历史（Chat History）

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/coach/history"

推送训练计划至 Garmin 设备（Push Workout to Garmin）

将已排定的训练计划直接发送至您的 Garmin 设备。

curl -X POST -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/workouts/123/push-garmin"

调用频率限制（Rate Limits）

智能体开发建议（Tips for Agents）

1. 以教练对话（coach chat）作为主要交互入口。 该接口完整掌握用户 Garmin 活动、训练负荷与表现数据上下文，只需以自然语言提问即可。

2. 推荐高强度训练前，请先评估疲劳程度。 调用 GET /api/v1/performance/pmc 接口并查看 TSB 值；若 TSB 低于 -20，则表明运动员处于疲劳状态。

3. 可使用免费的 WOD 接口快速生成训练建议。 无需认证，适合仅需即时训练方案的用户。

4. 所有日期参数统一采用 YYYY-MM-DD 格式。