Mapflow AI 代理

Mapflow AI Agent 是 Mapflow Web 应用程序中内置的智能助手。它使用自然语言对话指导您完成完整的人工智能绘图工作流程——从定义感兴趣的区域到运行处理。代理会收集参数、推荐模型和图像来源、估算成本并代表您启动处理,同时在花费积分之前始终要求您确认。

工作流程

该代理是从主仪表板上的项目创建对话框启动的。

步骤 1. 仪表板

打开 Mapflow 仪表板。仪表板列出了您的所有项目,并且是任何新映射任务的起点。

步骤2.创建项目

单击“创建项目”以打开“新建项目”对话框。设置名称,可以选择自定义图标和颜色,并添加说明来解释您想要映射的内容。

步骤 3. 使用 AI Agent 创建项目

单击 使用 AI Agent 创建项目,而不是手动配置项目。代理会读取项目描述作为您的初始请求,并开始对话以收集运行处理所需的所有信息。

使用AI Agent创建项目

从这一点开始,代理驱动工作流程:它阐明您的意图,提出模型,帮助您定义 AOI,找到合适的图像,估计成本,并在您确认后运行处理。

注解

未经您明确确认,代理绝不会执行付费操作(订购图像、开始处理)。有关代理在搜索图像时使用的详细决策逻辑,请参阅图像代理指令。

代理工具集

代理可以访问与特定 Mapflow API 功能相对应的一组固定工具。每个工具在对话过程中都会被透明地调用;您无需直接致电他们。

工具

目的

query_mapflow_docs

使用官方 Mapflow 文档作为来源,回答有关 Mapflow 功能、模型、定价和限制的问题。

获取限制

检查当前 Mapflow 计划的限制(最大 AOI 大小、可用提供商、信用余额),以便代理可以保持在其中。

列表模型

列出您的账户可用的 AI 模型,并推荐适合您任务的模型。

保存所选模型

记录用户选择的模型,以便在后续步骤(成本估算、处理启动)中使用。

获取地理边界

将地名(地名)解析为地理边界。当用户通过名称而不是坐标引用区域时很有用。

保存_aoi

从 GeoJSON 几何体向项目添加感兴趣区域。

buffer_aoi

在 AOI 或点位置周围创建给定半径的缓冲区。

list_imagery_sources

列出用户可用的图像源(底图和商业提供商)并建议默认值。

搜索图像目录

在底图和商业目录中搜索与 AOI、日期范围、云量和分辨率标准匹配的图像。

保存所选图像

将所选图像源附加到处理配置。

计算成本

根据所选模型、AOI 和数据源估算处理成本(以学分为单位)。

开始处理

用户确认参数和成本后启动处理运行。

获取处理

轮询并报告正在运行的处理的状态,以便用户随时了解最新情况。

交互示例

与代理的典型对话遵循以下模式。代理的工具调用以斜体表示,仅供说明之用 - 它们在聊天 UI 中不可见。

User:  "Create a map of all trees in the London Hyde Park."

Agent: "I can help with that. I'll use the 🌲 Forest model.
        First, let me locate Hyde Park."
       [get_geoboundary → returns polygon for Hyde Park]
       [save_aoi → AOI stored]

Agent: "I found Hyde Park (~1.4 km²). It fits within your plan limits."
       [get_limits, list_models, save_selected_model: Forest]

Agent: "For tree mapping the date of imagery is not critical, so I
        recommend Mapbox Satellite at zoom 18 (0.5 m/px) as the source."
       [list_imagery_sources, save_selected_image: Mapbox z18]

Agent: "Estimated cost: 12 credits (1.4 km² × 8 credits/km²).
        Shall I start the processing?"
       [calculate_cost]

User:  "Yes."

Agent: "Processing started. I'll let you know when it's finished."
       [start_processing, get_processing → status: IN_PROGRESS]

缓冲 AOI

当用户给代理一个点位置或一个小几何图形时,代理可以使用“buffer_aoi”将其扩展为可用的 AOI。下面的动画显示了代理在某个位置周围创建缓冲区:

代理在 AOI 周围创建缓冲区