Garmin Skill_知识管理 skill-PHP中文网

Garmin Skill

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

使用AI与Garmin数据对话，询问活动、训练负荷、VO2 Max、心率区间等。

Garmin Skill : Chat 与您的 Garmin Connect 数据使用 AI.

功能概述

Garmin Skill : Chat 与您的 Garmin Connect 数据使用 AI.是一项面向实际任务的技能，主要用于询问您的运行、骑马、游泳、训练负荷、 VO2 Max 、心率区和性能趋势；由 Transit 驱动, 同步。

核心要点

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

结果检查与注意事项

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

Garmin Skill

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

设置

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

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）

等级（Tier）	读取类接口（Read Endpoints）	AI 类接口（AI Endpoints）
Free	100 次/天	3 次/天
Paid	10,000 次/天	100 次/天

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

以教练对话（coach chat）作为主要交互入口。 该接口完整掌握用户 Garmin 活动、训练负荷与表现数据上下文，只需以自然语言提问即可。
推荐高强度训练前，请先评估疲劳程度。 调用 GET /api/v1/performance/pmc 接口并查看 TSB 值；若 TSB 低于 -20，则表明运动员处于疲劳状态。
可使用免费的 WOD 接口快速生成训练建议。 无需认证，适合仅需即时训练方案的用户。
所有日期参数统一采用 YYYY-MM-DD 格式。