airmosaic-ai

工具能力与执行边界

English 中文

真实 ID、参数与执行支持以 catalog/tools/*.yaml 和 list-tools/describe-tool 为准。当前 26 个登记条目中 17 个支持 run-tool(8 个核心 CLI、6 个 Python 脚本、3 个 R 入口);登记不证明本机就绪、登录或科学验证通过。操作见查询指南和执行指南,验证层级见记录。

核心工具

使用同一项目 Python 环境从仓库根调用 CLI,或通过下列真实 ID 调用 run-tool。查询命令保留公共详情;runner 的核心结果只返回允许的脱敏摘要。

工具 ID 原 CLI 子命令 runner 范围
airmosaic_list_datasets list-datasets 是 acquisition 声明,不查实际内容
airmosaic_describe_dataset describe-dataset 是 数据详情及既有数据别名
airmosaic_search_datasets search-datasets 是 本地元数据关键词匹配
airmosaic_check_availability check-availability 是 文件存在性,不验年限/单位/质量;原 CLI 会输出本机路径
airmosaic_draft_causal_plan draft-causal-plan 是 本地模板,不调用 LLM 或建立因果结论
airmosaic_list_tools list-tools 是 工具分类、筛选与静态状态
airmosaic_describe_tool describe-tool 是 manifest、参数、实际入口
airmosaic_check_tool check-tool 是 静态前置条件,不验证登录
airmosaic_run_tool run-tool 否,禁止递归 此条目用于展示执行器自身

SDK 导出 DataCatalogService、DataAccessService、CausalDesignService、ToolRegistryService 和 ToolRunnerService;详见基础工具。本地标准输入输出 MCP 已实现,见连接指南;REST、自动技能安装器和跨层编排未实现。

数据获取与处理

具体步骤及参数见数据获取。

工具 ID skill runner 边界
worldpop_download WorldPop 是 requests;发现也联网写元数据,下载由参数显式启用
csmar_process_company_info CSMAR 是 pandas/openpyxl;只处理已有企业基础信息 ZIP
ihme_gbd_fetch_results GBD 是 本机已登录浏览器,网络许可与会话声明;版本/维度需核对
csmar_browser_download CSMAR 否,参考 浏览器获取需要本人机构权限及实际可用工具
yearbook_regional_sector_template 工业年鉴 否,模板 人工适配地区行业表头、编码、年份和输出
yearbook_product_output_template 工业年鉴 否,模板 人工适配产品、单位与缺失规则;无独立全国行业实现

list-datasets 当前可读取 9 条声明,数量是此版本快照,不是未来固定验收标准:

Dataset ID 负责 skill_id 声明范围
worldpop_population_grid worldpop 人口栅格产品
worldpop_zonal_statistics worldpop 分区统计能力声明;尚无独立本地处理入口
csmar_listed_company_basic csmar 上市公司基础信息
csmar_financial_statements csmar 财务表获取声明;需按实际表核对流程
industrial_yearbook_national_sector ind_yearbook 全国行业指标;需补齐/适配实现
industrial_yearbook_regional_sector ind_yearbook 地区行业指标
industrial_yearbook_product_output ind_yearbook 地区产品产量
ihme_gbd_mortality_rates ihme-gbd-results 死亡率数据
ihme_gbd_population ihme-gbd-results 人口数据声明;需核对具体请求维度

模型分析

四步状态见流程导航。第二步仅在已明确声明的清单技能内提供有界合成计算,无该阶段的 run-tool 适配器;GEOS-Chem 是未登记执行器的参考 skill。GCAM 的构建排错也不是编译工具;本轮未增加执行适配器。

参考 GCAM 总导航和模型分类说明。

工具 ID runner 范围
gcam_extract_market_sector 是 已有数据库的市场/行业行,需 pandas、Java/BaseX 和模型根
gcam_extract_technology_components 是 已有技术组件行及汇总,不提供 method 参数
gcam_aggregate_provinces 是 已有市场 CSV;排除 China/Global,人工核对覆盖、单位和权重
gcam_inspect_output_structure 是,R 固定查询、output/database_basexdb 布局;自定义查询需适配副本
gcam_plot_sector_change 是,R 必填 input_csv;固定 2021/2035,runner 注入任务输出
gcam_configuration_reference 否,参考 只读说明或授权任务副本修改;没有配置 API 或模拟启动器
pm25_hia_calculate_template 否,模板 健康影响输入和方法需适配验收
pm25_hia_visualize_template 否,模板 绘图输入、网格、依赖与输出需人工检查
ml_regression_workflow 是,R 回归技能:数值预测、预测解释与声明 DAG 的 PLR
mlr3_workflow_reference 否,参考 机器学习:mlr3 训练/预测方法与上游跟踪;尚无执行适配器
timexer_workflow_reference 否,参考 TimeXer:外生变量时序预测、参数与推理适配方法;尚无执行适配器

参数、模板与注册的区别

可执行 JSON 示例只含 manifest 参数,工具 ID 在 run-tool 命令行指定。列表使用逗号分隔字符串,输出通常省略以自动分配任务目录。标为人工计划的配置/浏览器 JSON 使用 reference_tool_id 和 execution_supported: false,只供阅读,不能传给 run-tool。其余领域蓝图也不会成为可调用 action。

新增工具需同步 manifest、允许清单、参数解析、分类说明和 skill,遵循注册规范。状态查询的 ready 不表示任务 can_execute;进程 succeeded 不表示科学验收通过。

科学设计维护在 methods/shared/,通用数据与技能组合维护在 workflows/,具体问题和案例证据归 projects/。当前没有工作流引擎,数据获取、处理、计算和验收仍需显式交接,不会自动串联。