ci4s
/
ai4mats-mcp-tools
0
0
Fork 1
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity
ai4mats-mcp-tools/.opencode/skills/dataset/create_dataset/SKILL.md

4.0 KiB
Raw Blame History

name description triggers metadata
create-dataset 当用户需要新增数据集时，请使用此技能。
新增数据集
创建数据集
api-base
https://www.ai4mats.com

创建数据集（调用接口）

何时使用

  • 用户需要创建一个新的数据集
  • 用户提到“创建数据集”“新建数据集”“调用创建数据集 API”

执行流程（Agent 必须遵守）

  1. 确认参数

    • 是否已提供：
      • 用户名 username
      • 密码 password
      • 数据集名称 name
      • 数据集标签 data_tag
    • 若缺失，必须先向用户询问

  2. 调用登录接口获取token

    • 调用common/login_mcp_server.login方法
    • 参数: username, password
    • 获取 access_token
    • 保存为临时变量 token

  3. 获取父级分类列表

    • 调用scripts/dataset_mcp_server.get_parent_categories方法
    • 参数: token(来自步骤2)
    • 返回父级分类列表，供用户选择需要展开的分类

  4. 选择需要展开的父级分类

    • 展示父级分类列表给用户
    • 询问用户需要展开哪个父级分类
    • 获取用户选择的父级分类ID parent_id

  5. 获取叶子节点列表

    • 调用scripts/dataset_mcp_server.get_child_categories方法
    • 参数: token(来自步骤2), parent_id(来自步骤4)
    • 返回该父级分类下的所有叶子节点列表

  6. 选择数据类型

    • 展示叶子节点列表给用户
    • 询问用户选择哪种数据类型 data_type

  7. 创建数据集

    • 调用scripts/dataset_mcp_server.create_dataset方法
    • 参数：token(来自步骤2), name, data_tag, data_type(来自步骤6)

  8. 反馈结果

    • ✅ 成功：返回数据集名称和创建结果
    • ❌ 失败：返回错误码和错误信息

  9. 询问是否创建数据集版本

    • 如果创建数据集成功，则继续询问用户是否需要创建数据集版本
    • 用户回答是则进行以下步骤，否则终止。

  10. 输入版本描述

    • 输入版本描述version_desc

  11. 上传文件

  • 调用scripts/upload_file.upload_file方法分片上传文件

  1. 获取最新的版本号

    • 调用scripts/dataset_mcp_server.query_next_version方法获取最新的版本号

  2. 创建数据集版本

    • 调用scripts/dataset_mcp_server.create_dataset_version方法
    • 参数：token(来自步骤2), git_id(来自步骤7), id(来自步骤7), identifier(来自步骤7), file_path(来自步骤11的输入), file_data(来自步骤11的结果), name:name, owner:username, version(来自步骤12), version_desc(来自步骤10)

  3. 反馈结果

    • 打印第13步的参数
    • ✅ 成功：返回创建数据集版本结果
    • ❌ 失败：返回错误码和错误信息

示例对话

用户：

帮我创建一个数据集，名字叫 test121，标签是 test

Agent 行为：

  1. 询问用户名和密码（如未知）
  2. 调用登录接口获取token
  3. 调用获取父级分类列表接口，返回：知识层级数据
  4. 询问用户需要展开哪个父级分类
  5. 用户选择"知识层级数据"
  6. 调用获取叶子节点列表接口，返回：通用数据、领域基础数据、领域专业数据
  7. 询问用户选择哪种数据类型
  8. 用户选择"通用数据"
  9. 调用创建数据集
  10. 返回：

    ✅ 数据集 test121 创建成功

  11. 询问是否创建数据集版本
  12. 输入版本描述
  13. 上传文件
  14. 获取最新的版本号
  15. 创建数据集版本
  16. 反馈结果

注意事项

  • Token 有效期由服务端控制，过期需重新登录
  • 不建议将用户名、密码、Token 写入日志
  • 创建失败时应明确提示是 登录失败 还是 创建失败
  • 数据类型选择流程：先选择父级分类 → 展开叶子节点 → 选择叶子节点作为数据类型
  • 如用户直接指定数据类型名称，可调用get_data_types获取所有叶子节点进行匹配验证