SuperAPI AI 工具集

carto-preview-builder-map

数据与分析

查看项目

更新于 10-15 17:32

技能介绍

用途:在聊天中内联渲染已保存的 CARTO Builder 地图的轻量预览。用户以 URL、ID 或名称引用地图,智能体用 read_maps 解析,再用 view_map 内联加载。

主要能力:该技能消费 CARTO MCP 服务器提供的 read_maps 与 view_map 工具,负责路由、名称到 ID 的解析,并说明轻量预览的预期。工具输入结构与访问控制规则(用户须拥有、被共享或对地图有公开访问权)见工具自身的 MCP 描述,可通过 MCP 宿主的工具检查器或 tools/list 查看。

使用方式:仅支持 MCP,无内联渲染的 CLI 等价方式,需要 MCP-Apps 宿主(Claude.ai、Claude Desktop、ChatGPT)。view_map 与 read_maps 都须在工具列表中且宿主能渲染 MCP Apps。令牌会话下提供 view_map 但不提供 read_maps,此时按显式 URL/ID 加载仍可用,按名称搜索需 OAuth 会话或向用户索取地图 URL。宿主不支持渲染(如 Gemini CLI、Codex CLI、MCP Inspector、MCPJam 等纯文本环境)时,告知用户无法内联渲染并建议直接打开 Builder URL;view_map 不存在说明 MCP 服务器未接入,不要从零重建已保存地图。

解析规则:Builder URL https://<workspace>.app.carto.com/builder/<mapId> 提取 mapId 直接传给 view_map;裸 UUID 直接传入;名称或主题先用 read_maps 搜索再按 ID 加载,用户说“我的地图”时限定为其自有地图,默认按 updated_at 降序。匹配结果:1 个则加载并告知名称;多个则列出名称、日期与缩略图让用户选择,不要猜测;0 个则告知无匹配,可建议改用 carto-render-inline-map。

预览预期:包含图层、底图、视口、弹窗、图例,含虚线/点线及多边形边框等描边样式;不包含小组件、SQL 参数、地图描述、AI 智能体配置等 Builder 专有功能。加载后应主动说明这一点,并提示点击渲染组件中的“Open in Builder”获得完整体验。

创建后预览:通过 carto-create-builder-maps 创建地图后,将返回的 mapId 传给 view_map 即可内联预览,适合样式迭代的编辑→保存→预览循环;调试小组件或 SQL 参数仍需完整 Builder。

其他技能选择:临时可视化且无已保存地图用 carto-render-inline-map;创作或编辑永久地图用 carto-create-builder-maps;从零构建 deck.gl 应用用 carto-develop-app。

限制与反模式:不要用手工 deck.gl 规格重建已保存地图,应始终先解析并加载已保存地图;用户按名称引用时不要跳过 read_maps 猜测 ID;不要承诺预览中包含小组件、SQL 参数或地图描述;多个匹配时不要静默选择最近的一个。