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 和数据源估算处理成本(以学分为单位)。

开始处理

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

获取处理

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

upload_image

Uploads an image to be stored in the user's My Imagery collection and used as an input for processing.

交互示例

与代理的典型对话遵循以下模式。代理的工具调用以斜体表示,仅供说明之用 - 它们在聊天 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]

Usage examples

缓冲 AOI

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

代理在 AOI 周围创建缓冲区

Uploading an image

The agent can accept an image upload from the user and use it as an input for processing. Drop an image into the chat window, and the agent will store it in your My Imagery collection and select it for the processing:

Agent handling an image upload