前言¶

做农业 IoT 或智慧灌溉的开发者，多半遇到过这类重复劳动：设备清单在平台上，属性数据在平台上，现场图片也在平台上，却没有开放的现成接口给 Agent 调用，只能人肉登录后台一个个点。每次要取数、要截图、要设一个定时任务，都要走一遍网页流程。

JJR IoT Skill 就是为这个场景准备的。下面介绍它的定位、已核实的能力，以及使用上要注意的地方。

这是什么¶

JJR IoT Skill 是捷佳润 IoT 平台的技能，把设备查询、属性数据读取、图片获取和定时任务这几类操作封装成 Agent 可调用的步骤。它属于通用 SKILL.md 格式的 Skill，托管在 SkillHub 上。

• 坐标：@user_2d109134/jjr-iot-skill
• 版本：1.3.1
• 来源：community
• 发布者：user_2d109134
• 分类：ai-agent
• 标签：requires_api_key=true

与直接对接平台 API 的区别¶

自己写对接代码，要处理鉴权、字段映射、分页和错误码，改一次平台侧变更就要改一次。Skill 把这套流程固化成声明式步骤，Agent 只需要按 SKILL.md 的描述发起请求，不需要理解平台 API 的细节。代价是：能力边界由 Skill 决定，平台没封装的能力拿不到。

核心功能¶

以下四类能力来自该 Skill 的官方简介，是已核实的范围。

1. 设备查询：获取平台下的设备列表，用于确认有哪些设备在线、属于哪个项目。
2. 属性数据：读取设备上报的属性值，例如传感器读数一类。
3. 图片获取：拉取设备关联的现场图片。
4. 定时任务：创建或管理定时执行的任务，适合周期性的巡检或采集。

具体每个能力支持的入参、出参和限流，公开资料中没有展开，需要以 SKILL.md 内的说明为准。

安装与启用¶

公开资料中没有给出通用的安装命令，只有坐标和来源信息。要用的话，按下面两步走。

1. 先确认你使用的 Agent 客户端支持 SkillHub 上的 community 来源 Skill，并支持 @user_2d109134/jjr-iot-skill 这个坐标。
2. 从 SkillHub 页面获取该 Skill 的 SKILL.md 与附带文件，放到客户端的 Skill 目录中，然后按 SKILL.md 的描述启用。

代码块中的内容是坐标信息，不是可直接执行的命令：

@user_2d109134/jjr-iot-skill
version: 1.3.1
source: community
requires_api_key: true

requires_api_key=true 表示该 Skill 需要 API Key。启用前要先准备好捷佳润 IoT 平台的 API Key，并按 SKILL.md 的要求配置到位，否则调用会失败。

典型用法¶

官方简介中没有给出可复现的调用示例，下面按 SKILL.md 的通用流程描述用法，具体参数以 SKILL.md 为准。

1. 配置 API Key，确认鉴权通过。
2. 发起设备查询，拿到目标设备的标识。
3. 用设备标识读取属性数据或获取图片。
4. 如需周期性采集，创建定时任务，指定执行周期和要执行的操作。

如果需要精确的请求格式，建议直接打开官方页面查看 SKILL.md，不要凭猜测构造参数。

适用场景与注意¶

适合的人：已经在用 Agent 做捷佳润 IoT 平台运维或数据采集，希望把重复操作交给 Agent 自动执行的开发者。

要注意的限制：

• 该 Skill 来自 community 来源，不是官方发布，维护和更新依赖发布者 user_2d109134。
• 需要 API Key，涉及生产环境时要注意密钥的存放和权限范围。
• 版本为 1.3.1，平台侧接口变更可能导致 Skill 失效，用之前先在测试环境验证一遍。
• 公开资料中只有简介，没有完整参数说明，接入前需要自己读 SKILL.md。

结尾¶

JJR IoT Skill 的价值在于把捷佳润 IoT 平台上几类高频操作收拢成 Agent 可执行的步骤，省掉自建对接代码的成本。适合需要让 Agent 主动查设备、取数据、拿图片、跑定时任务的场景。接入前先把 SKILL.md 读完整，并确认 API Key 已配置好。

官方地址：https://api.skillhub.cn/user_2d109134/jjr-iot-skill
SkillHub 页面：https://www.skillhub.cn/skills/user_2d109134/jjr-iot-skill