技能介绍

要解决什么问题

跨境物流里，船期、提单/箱号跟踪、口岸计划往往分散在不同产品与字段体系里；港口代码和船司 SCAC 还与 ShipXY、UN/LOCODE 等清单不一致。智能体若直接拼 HTTP 请求，容易在 OAuth、租户注入、参数映射和 queryId 复用上出错。

技能如何工作

本技能提供 仅标准库的 scripts/cargogo.py，从内置 references/catalog.json 读取契约，负责本地校验、Client Credentials 取 Token、租户头注入与结构化错误；大响应会落盘并返回 result_path。

能力面（节选）：

船舶与口岸计划：IMO/MMSI/船名档案、口岸进出口船计划
全球船期 query_global_schedule：港到港 ETD/ETA、航次与直达/中转（transitCount、wayPortList）
跟踪订阅：海运/空运/RoRo/陆运/中欧班列/北美铁路等；订阅成功后从结果顶层取 query_id，仅在同产品后续节点、轨迹、地图工具中复用
主数据解析：cargogo_resolve_port、cargogo_resolve_carrier；单号识船司用 query_ocean_scac_candidates

推荐流程：按意图选最小工具 → 自然语言港名/船司先解析且 status=resolved 再用 match.code → 首次调用前 list/describe 对齐参数名 → 订阅类先 --dry-run 确认标识再正式创建。

边界与注意

需配置 CARGOGO_CLIENT_ID、CARGOGO_CLIENT_SECRET（及租户相关的 CARGOGO_TENANT_ID），勿在聊天或 Skill 文件中粘贴 Secret/Token。一实例绑定一租户；港口必须用 Cargogo 清单中的 port_code，船司必须用清单 SCAC。用户给「未来 N 天船期」时默认约束 ETD（etd_from/etd_to），勿省略时间查全量船期。