SuperAPI AI 工具集

gillby-water

通用与其它

查看项目

更新于 10-19 23:55

技能介绍

Gillby Water 是一个用于规划佛罗里达水上活动的技能,覆盖划船、钓鱼、划桨、冲浪和海滩出游等场景。它的核心目标是帮助用户按地点、时间和活动类型比较实际可选项,并基于 Gillby 的当前数据作答,而不是依赖记忆中的预报或截图读数。Gillby 覆盖其支持的佛罗里达水域,具体可用性因地点和上游数据源而异。

连接与发现

该技能提供以下入口:产品与发现索引 https://www.gillby.com/llms.txt ;当前工具 schema 与解读说明 https://www.gillby.com/llms-full.txt ;MCP 端点(Streamable HTTP)https://www.gillby.com/mcp ;HTTP API 与 OpenAPI 见 https://www.gillby.com/developers 和 https://www.gillby.com/api/v1/openapi.json ;安装、支持的客户端与账户权限见 https://www.gillby.com/integrations 。

使用时应通过可用的 Gillby 连接器或 MCP 连接,并检查其当前工具 schema,工具名称可能带有客户端特定前缀。公共海洋工具无需 API 密钥或登录。技能本身只提供指导,并不等于已安装 MCP 连接。如果没有可用连接器,在环境支持网络请求时可使用文档中的公共 HTTP API,否则应说明缺少连接并给出安装链接。不得声称查询了实际无法获取的数据。

从用户的计划出发

需要识别地点、活动、日期/时间窗口和相关约束。仅在缺失细节会改变答案时才追问。应解析模糊日期并包含明确的本地时区,不得用当前条件悄悄替代未来出游。在涉及船只特定路线或活动筛选前,需确认船只尺寸和用户提供的设备限制。

用 list_spots 解析确定的地点。查询当前条件时,先用 get_conditions 并传入已解析的 ID 和 view: "summary"。其捆绑结果可能已包含所需的潮汐、危险和来源状态,除非缺少细节,否则避免重复调用。MCP 参数保留嵌套对象,例如:{"query":{"spot":"boca-inlet","view":"summary"}}。等价的公共 HTTP 起点为:GET https://www.gillby.com/api/v1/spots 和 GET https://www.gillby.com/api/v1/conditions?spot=boca-inlet&view=summary 。

进行未来比较时,对每个已解析地点和用户实际想要的时间窗口请求 get_forecast,并阅读实时 schema 了解时间和活动参数。比较出发和返回时段、风/阵风、浪/周期/方向、潮汐/水流、相关警报以及不可用来源。使用合适的地点工具查询坡道、燃料、锚地、礁石或海滩。当访问和运营细节对计划重要时,应向运营方核实。

对于船只路线,使用用户确认的吃水、净空高度、安全余量和出发时间,或其授权的已保存船只。保留路线警告、深度/桥梁假设和数据缺口。单点深度读数本身不能确定路线净空。

解读证据

保留来源名称、观测/模型时间、新鲜度和 QC/不可用状态。新鲜响应仍可能包含不可用来源。缺失不同于零、无危险或无观测。

本地模拟海高与官方海洋区预报覆盖不同水域和时间。应呈现官方海洋预报和警报;较低的本地估计不能覆盖它们。近海海高不同于破碎浪高,也不能单独描述入海口。

来自不同本地 MLLW 潮位站的高度不能确定相对航道深度。高潮不一定是平流。大气能见度不是水下能见度。

活动评分是规划估计。当请求的评分缺失时,不要复用其他活动的评分。使用骑手提供的风筝风力限制,而不是编造设备范围。

闪电应描述为在所述窗口内观测到/未检测到,或不可用。野生动物和钓鱼证据是带日期的记录,不是实时动物追踪或渔获保证。摄像头画面可能有延迟。

截图和博客示例是历史性的。在声称原生应用、Spotify 或市场插件已公开发布前,应检查当前产品页面。

个人账户操作

个人船只、地点、行程和偏好需要用户的 Gillby OAuth。仅通过客户端支持的授权流程请求任务所需的访问权限。不要索取服务凭据。读取权限不授权保存、编辑、删除、共享位置或联系任何人。仅在用户明确请求范围内执行更改;报告实际结果,若授权或连接不可用则停止。

给出有用答案

先给出比较或实用的下一步,并绑定用户的活动和时间。比较地点或时段时使用紧凑表格。包含决定性读数及其时间、来源、警报,以及无法核实的内容。链接到相关 Gillby 页面或地图,不要编造 URL 参数。区分实测观测、预报和你的解读。避免给出通用的“可以安全出行”结论:此规划信息不能替代官方海图、本地通告、海滩旗帜、关闭通知或水上判断,Gillby 也不是紧急/救援服务。

有用请求示例包括:比较 Boca 和 Hillsboro 入海口早晨划船路线、寻找附近暴露水域较少的划桨下水点,或审查已保存船只在两个出发时间的拟议路线。应遵守服务速率限制和 Retry-After,而不是无限重试。