SuperAPI AI 工具集

ae-project-semantic

通用与其它

查看项目

更新于 10-15 22:33

技能介绍

用途:从 AE 项目资产包中生成、测试、提交、评审和发布受治理的 L2 项目语义候选。项目语义是项目级业务概念、规则、计算约定和默认资产选择方法,位于仪表盘与报表之上;仪表盘、报表、事件、属性、指标属于 L1 证据与执行资产,本身不是项目语义。仅使用 ae-cli,不得直接写数据库进行推荐、审批或发布。

主要能力:导出受治理资产包并检查 asset_scope、导出/已认证/未认证资产数、truncated、工作单元与定义族数量;按 manifest、catalog、work-units、definition-families、asset-directory、governance-coverage、details 的顺序读取;对比已发布、已禁用、活跃候选和已拒绝目录,产出 CREATE、UPDATE 或无候选;对候选文件做确定性校验与独立的 Agent 质量评审;提交、评审、启用及生命周期管理(禁用、删除影响、删除、重新启用)。

必要用法:先解析项目与主机,阅读 references/recommendation-quality.md 和 references/query-routing-v5.md,再执行 ae-cli project-semantic list --project-id <project_id>,导出资产包 ae-cli project-semantic asset-package export --project-id <project_id> --asset-scope governed --output <tmp>/project-semantic-assets --force。校验用 ae-cli project-semantic candidate validate --asset-package <tmp>/project-semantic-assets --submit-file <tmp>/project-semantic-candidates.json,提交用 ae-cli project-semantic candidate submit --project-id <project_id> --submit-file <tmp>/project-semantic-candidates.json --snapshot-hash <snapshot_hash>。

适用场景:需要从项目资产中提炼可复用的业务语义、默认资产选择、查询路由、召回捷径或分析剧本时。

限制:导出仅限项目管理员;受治理范围要求已认证、协作且近 90 天活跃;扩大范围需用户明确同意并降低置信度;未认证资产只能作为佐证;禁用语义不得通过推荐重建;零候选是有效结果;passed=true 不代表语义质量通过。具体收费、价格与平台支持信息暂未提供。