Ambient Weather

通过您的 OOMOL 连接账户操作 Ambient Weather。该技能调用 ambient_weather 连接器（通过 oo CLI）；OOMOL 在服务端注入凭据，因此您无需直接处理原始令牌。

执行操作

假设用户已安装 oo CLI、完成登录，并已连接 Ambient Weather。请勿主动执行 oo auth login 或打开连接 URL —— 直接运行操作即可。仅当命令因认证或连接错误而实际失败时，才回退至首次设置流程。

1. 检查合约（schema）：在构建请求载荷前，使用以下命令获取该操作权威的输入/输出结构定义：

oo connector schema "ambient_weather" --action ""

2. 执行操作：传入符合输入结构的 JSON 载荷：

oo connector run "ambient_weather" --action "" --data '' --json

• --data 接受 JSON 对象字符串，或以 @path/to/file.json 格式指定本地文件路径；若省略该参数，则默认发送空对象 {}。
• 响应格式为 { "data": ..., "meta": { "executionId": "..." } }；执行 ID 位于 meta.executionId 字段下。

下方列出了所有可用操作，每项附有一行简要说明；其中会改变状态的操作标有 [write] 或 [destructive] 标签。在构造 --data 前，请务必先通过 oo connector schema 获取该操作的实时结构定义，以确认其权威输入字段。

可用操作

• get_device_history — 获取 Ambient Weather 设备的近期历史观测记录。
• get_latest_device_data — 获取 Ambient Weather 设备的最新观测记录。
• list_devices — 列出已关联至当前连接账户的所有 Ambient Weather 设备。

安全性

• 未标注标签的操作均为只读操作（get / list / search），可安全直接执行。
• 标有 [write] 的操作会更改 Ambient Weather 状态 —— 执行前须与用户确认载荷内容及具体影响。
• 标有 [destructive] 的操作将删除或覆盖数据 —— 执行前必须明确确认目标对象，并获得用户的显式授权。

首次设置

以下为一次性步骤，切勿在每次调用时重复执行。仅当命令因对应原因失败时，才运行相应步骤。

• oo: command not found — 安装 oo CLI（其他平台安装指南：https://cli.oomol.com/install-guide.md）：

  curl -fsSL https://cli.oomol.com/install.sh | bash    # macOS / Linux
  

  irm https://cli.oomol.com/install.ps1 | iex           # Windows PowerShell
  

• 未登录 / 认证错误 — 一次性登录您的 OOMOL 账户：

  oo auth login
  

• scope_missing / credential_expired / app_not_ready / app_not_found — Ambient Weather 尚未连接，或连接已过期、缺少必要权限范围（scope）。请通过以下链接一次性完成连接（认证类型：API key）：

  https://console.oomol.com/app-connections?provider=ambient_weather
  

• HTTP 402 / OOMOL_INSUFFICIENT_CREDIT — 账户余额不足导致服务暂停。请访问 https://console.oomol.com/billing/token-recharge 充值后重试。

相关资源

• Ambient Weather 官网：https://ambientweather.net/