yaml-validator 技能Hyper-Extract 如何自动验证模板语法与类型【免费下载链接】Hyper-ExtractHypergraph is more powerful. Transform unstructured text into structured knowledge with LLMs. Graphs, hypergraphs, and spatio-temporal extractions — with one command.项目地址: https://gitcode.com/GitHub_Trending/hy/Hyper-ExtractHyper-Extract 是一个用 LLM 将非结构化文本转化为结构化知识的开源工具支持图谱、超图和时空知识提取。其中yaml-validator是内置的 AI 技能专门自动验证 YAML 知识模板的语法与类型帮你快速定位配置错误。下文带你了解它的工作流程、检查规则和常见错误修复方法。什么是 yaml-validator 技能在 Hyper-Extract 中你通过一份 YAML 模板告诉 LLM「要提取什么、怎么提取」。模板写错一点点——比如类型拼写错误、缺少必填字段——整个提取流程就会失败或质量下降。yaml-validator 就是为了解决这个问题而设计的「模板质检员」。它属于 hyperextract-skills/ 技能套件的一部分与 brainstorm需求探索、graph-designer图谱设计等技能协同工作。它的定义入口在 hyperextract-skills/yaml-validator/SKILL.md当你对 AI 说「validate template」「check YAML」「fix errors」时就会自动触发。五步自动验证工作流yaml-validator 按固定的五步顺序检查模板从基础到细节逐层深入步骤检查内容说明1️⃣ 语法检查YAML 是否合法缺少冒号、缩进错误等2️⃣ 必填字段7 个必备字段是否齐全language、name、type、tags、description、output、guideline3️⃣ 类型检查type 是否为合法 AutoType如graph而不是graphh4️⃣ 标识符检查identifiers 配置是否正确如 relation_members、time_field5️⃣ 字段验证字段类型和描述是否完整每个字段需有 type 与 description这种「先语法后语义」的递进式检查确保低级错误不会干扰高级检查让你拿到一份清晰、可执行的验证报告。高频错误与快速修复对照表技能内置了常见错误模式库rules-errors.md以下是最常踩的坑❌ 拼写错误type: graphhtype: graph # ✅ 正确必须是 8 种 AutoType 之一合法的类型值包括model、list、set、graph、hypergraph、temporal_graph、spatial_graph、spatio_temporal_graph。❌ 缺少必填的output字段output: description: 提取结果说明 fields: - name: field1 type: str❌ 超图 relation_members 格式错误简单超图应使用字符串分组超图才用列表# ✅ 简单超图 relation_members: participants # ✅ 嵌套分组超图 relation_members: [attackers, defenders]❌ 时序图谱缺少 time_fieldidentifiers: time_field: event_date # ✅ temporal_graph 必须配置详细的字段级规则可在 rules-identifiers.md 和 rules-types.md 中查阅。三级验证结果ERROR / WARNING / INFO验证报告采用三级严重度让你快速判断哪些问题必须处理级别含义处理建议 ERROR必须修复不修复无法正常工作 WARNING建议修复可能影响提取质量 INFO参考信息推荐遵循报告还会逐项列出 ✅/⚠️ 状态和总体评估例如「Syntax Validation ✅ PASSED」「2 warnings」一目了然。如何使用嵌入模板设计工作流在 hyperextract-skills/SKILL.md 定义的标准流程中yaml-validator 是设计完成后的「可选质检步骤」brainstorm → designer → validator → multilingual 探索需求 生成YAML 验证校验 多语言 官方推荐使用顺序先 brainstorm 探索需求 → 用 designer 生成 YAML → 用 validator 验证 → 可选转多语言。此外Hyper-Extract 的 CLI 也提供命令行校验入口he template validate可在终端直接检查本地 YAML 文件测试用例见 tests/cli/test_template_validate.py你也可以对照官方内置模板来理解一份「合法 YAML」长什么样例如 hyperextract/templates/presets/general/base_model.yaml。参考资料技能总览中文hyperextract-skills/README_ZH.md验证规则四件套rules-syntax.md、rules-types.md、rules-identifiers.md、rules-errors.md配套优化技能在验证前自动修复常见问题template-optimizer/SKILL.md小结yaml-validator 技能把「模板写得对不对」这件容易忽略的事变成了一键自动化流程——五步检查、三级报告、常见错误直接给修复方案。写完 YAML 模板后跑一次验证能让你在真正调用 LLM 提取之前就消灭绝大多数低级错误。【免费下载链接】Hyper-ExtractHypergraph is more powerful. Transform unstructured text into structured knowledge with LLMs. Graphs, hypergraphs, and spatio-temporal extractions — with one command.项目地址: https://gitcode.com/GitHub_Trending/hy/Hyper-Extract创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考