用途:面向 CARTO Builder 地图的全流程创作,从自然语言请求创建地图,到编辑已有地图的数据集、图层、组件、弹窗和隐私设置,发布快照供共享查看者使用,离线校验,以及管理地图资产,还涵盖跨 profile 复制(开发到生产提升、按客户隔离的组织交付,通过 carto maps copy)。
主要能力:访问路径分为 MCP(OAuth 附加时优先)与 CLI。列表/获取/搜索地图可用 read_maps 或 carto maps list / get;创建/编辑/发布用 create_map、update_map 或 carto maps create / update / publish / datasets update;离线校验用 validate_map 或 carto maps validate;删除用 delete (kind=map) 或 carto maps delete;行内预览(仅 MCP-Apps 宿主)用 view_map;检查数据集用 explore_data (describe) 或 carto connections describe;SQL 探测用 execute_query 或 carto sql query;导入文件先用 import_data 或 carto import。仅 CLI 提供:carto maps schema、carto maps agents *、carto maps screenshot、carto maps copy。
使用方式:按阶段执行,先收集上下文(目标、数据提示),再静默检查数据模式,随后做制图决策、编写配置、离线校验、创建并核实、按需发布。配置字段形状、枚举值、调色板等由 carto maps schema 提供,不应硬编码;文档与 schema 冲突时以 schema 为准。
限制:API token 下 MCP 会话仅暴露只读子集,创作需走 CLI 或改用 OAuth 重连;沙箱聊天宿主(Claude.ai、ChatGPT)无法运行 CLI,只能用 MCP。Organization AI 未启用时不支持地图上的 Agent。部分具体字段与价格信息暂未提供。