V3DTILES 切片技能

1. 本技能使用原则

本技能用于通过 V3DTILES MCP 服务执行实际 GIS 和三维数据处理任务。

重要：只要用户的目标是执行数据切片、转换、裁切或生成 3D Tiles/地图瓦片/地形瓦片，就应优先使用本技能，而不是仅向用户解释如何操作。

Agent 的职责：

1. 判断用户是否需要执行 V3DTILES 数据处理任务；
2. 识别工程类型 project_type；
3. 从用户请求中提取输入路径、输出路径及其他明确参数；
4. 使用 MCP 工具 project_fetch_prompt 获取对应工程类型的参数解析提示词；
5. 将用户请求和提示词交给大模型生成 llm_json_output；
6. 使用 MCP 工具 task_execute_by_llm_json_output 创建并执行任务；
7. 根据 MCP 返回结果向用户反馈任务是否提交成功。

2. 工程类型

3. 支持的自然语言表达

不要求用户使用固定术语。以下表达都可以理解为相关任务：

3D Tiles

• 3dtiles
• 3DTiles
• 3D Tiles
• 3d tiles
• 3D瓦片
• 三维瓦片
• 三维切片

切片

• 切片
• 切数据
• 数据切片
• 模型切片
• 生成瓦片
• 生成3D瓦片
• 转换成3DTiles
• 转为3DTiles
• 转成3DTiles
• 输出3DTiles

倾斜摄影

• 倾斜摄影
• 倾斜摄影模型
• 倾斜模型
• OSGB
• OSGB模型
• 实景三维模型

高斯泼溅

• 高斯泼溅
• 3D高斯
• gaussian splatting
• Gaussian Splatting
• 3DGS
• PLY
• SPLAT
• SOG
• 高斯泼溅转3DTiles
• 高斯泼溅切片
• 3DGS切片
• PLY转3DTiles
• 3D Gaussian Splatting转3DTiles

4. 推荐执行流程

用户自然语言请求
        ↓
判断是否属于 V3DTILES 数据处理任务
        ↓
识别 project_type
        ↓
提取用户已经提供的参数
        ↓
调用MCP工具 project_fetch_prompt(project_type) 获取提示词，发送给大模型
        ↓
大模型根据提示词从用户自然语言中提取切片工程和任务配置，生成 llm_json_output
        ↓
调用MCP工具 task_execute_by_llm_json_output
        ↓
返回任务提交结果给用户

5. MCP 工具调用

5.1 获取工程配置解析提示词

project_fetch_prompt(project_type)

参数：

project_type = 1 ~ 8

用途：

获取对应工程类型的完整参数解析提示词。

5.2 推荐：创建并执行任务

task_execute_by_llm_json_output(llm_json_output)

该工具用于：

大模型参数解析
        ↓
创建切片工程
        ↓
执行切片任务

执行实际切片任务时优先使用此工具。

5.3 创建工程但不执行

project_save_by_llm_json_output(llm_json_output)

仅在用户明确要求：

• 创建工程
• 保存工程配置
• 暂时不要执行

等场景下使用。

5.4 已有工程执行

task_execute_by_project_id(project_id, ...)

用于用户已经指定或已经存在工程 ID，需要执行该工程任务的场景。

6. 其他 MCP 工具

6.1 工程

project_list
project_detail
project_get_id_by_name
project_delete

6.2 任务

task_detail
task_executing_list
task_finished_list
task_cancel
task_cancel_all
task_delete
task_delete_all

只有用户需求涉及工程查询、任务查询、任务取消或删除时才调用这些工具。

不要为了普通切片任务额外调用无关工具。

7. 执行时间

切片任务可能运行较长时间。

调用：

task_execute_by_llm_json_output

成功提交任务后，通常不需要等待整个切片过程完成。可以调用 task_detail 尝试获取任务详情。

如果任务正在执行，应向用户说明“任务已提交，将在后台执行”。

如果工具返回任务 ID、工程 ID 等信息，应将这些信息提供给用户。

用户明确要求查询任务进度或任务结果时，调用：

task_detail
task_executing_list
task_finished_list

8. 错误处理

MCP 可能返回以下错误码：

9. MCP Server 要求

使用本技能 必须配置 V3DTILES MCP Server。

所有 MCP 请求必须使用 Authorization 请求头：

Authorization: Bearer {v3dtiles_api_key_here}

如果 MCP Server 未配置，应提示用户先配置，而不是假装已经执行任务。

推荐配置：

{
  "mcpServers": {
    "v3dtiles": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:7760/mcp",
      "headers": {
        "Authorization": "Bearer {v3dtiles_api_key_here}"
      }
    }
  }
}

另外，所有 MCP 工具调用返回的 JSON 对象中有属性 _metadata.skill_version 表示当前最新技能文档的版本号，例如 { "_metadata": { "skill_version": "1.3.0.1" } }，请与当前技能文档的版本号(YAML Frontmatter metadata 中定义)比较，如果不一致，请提示用户更新本技能。最新版 SKILL.md 下载地址 http://127.0.0.1:7760/api/public/ai/SKILL.md ，操作指引 http://127.0.0.1:7760/mcp/guide 。

10. 软件 WebGUI

V3DTILES WebGUI 访问地址 http://127.0.0.1:7760 。

可以用于：

• 配置切片工程
• 执行任务
• 查询任务结果
• Cesium 三维可视化
• 预览切片成果
• 统计分析
• 生成 API Key
• 开通 VIP 或 购买离线授权码 (个人中心页面)

11. 相关网站

• 官方网站：https://v3dtiles.top
• 用户手册：https://www.v3dtiles.top/doc
• API 文档：https://v3dtiles.apifox.cn
• GitHub：https://github.com/Leopard-C/v3dtiles-release

12. 重要注意事项

1. 本技能 的主要目标是执行 V3DTILES 数据处理任务，不只是回答 V3DTILES 的产品问题。
2. 用户说“切片”“转换”“生成 3DTiles”等操作性请求时，应优先判断是否可以通过 V3DTILES MCP 执行。
3. 用户不一定会明确写出输入文件格式，应结合文件扩展名、目录名称、任务语义和上下文判断。
4. 当前智能体不需要创建输出目录，软件执行任务时会自动创建输出目录。
5. 缺少 MCP 配置时，应提示用户配置 V3DTILES MCP Server。
6. 任务执行时间可能很长，提交成功后不需要等待完整切片结束。
7. 不要编造 MCP 工具不存在的参数、工程类型或返回值。
8. 如果 MCP 返回错误码，应根据错误码向用户说明真实原因。
9. 部分功能需要 VIP 或离线授权，遇到 1005 错误码时明确告知用户。
10. 首次调用 MCP 工具后，请检查响应对象的 _metadata.skill_version 与当前技能版本号是否一致，不一致的话在对话最后提示用户更新技能文档。
11. 如果需要在中文括号（全角括号「（）」）内放置 URL，请在 URL 前后各加一个空格，例如：（ https://example.com ）