Agent/examples/process_pipeline/prompts/apply_to_grounding_agent.schema.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "apply_to_grounding_agent_output",
  "description": "Grounding agent 单 capability 输出 JSON 结构。Python 端解析后会把 matched 直接写入 capability.apply_to，suggested_additions 写入 capability.suggest_apply_to。",
  "type": "object",
  "required": [
    "matched",
    "suggested_additions"
  ],
  "additionalProperties": false,
  "properties": {
    "matched": {
      "type": "array",
      "description": "与分类库匹配上的节点。可包含实质和形式两种类型，用 category_type 区分。",
      "items": {
        "type": "object",
        "required": [
          "category_path",
          "category_type",
          "action",
          "ability_type",
          "matched_elements",
          "structured_content"
        ],
        "additionalProperties": false,
        "properties": {
          "category_path": {
            "type": "string",
            "minLength": 1,
            "description": "匹配到的节点路径（最多 6 层，前 6 层 L6）"
          },
          "category_type": {
            "type": "string",
            "enum": ["实质", "形式"],
            "description": "节点类型：实质或形式"
          },
          "action": {
            "type": "string",
            "minLength": 1,
            "description": "对该节点内容的操作要求（包含动词，如「提示词设定」「套用模板」「生成视频」）"
          },
          "ability_type": {
            "type": "string",
            "minLength": 1,
            "description": "能力类型（如 prompt、操作步骤、参数配置、模板套用、参考素材）"
          },
          "matched_elements": {
            "type": "array",
            "description": "命中的元素列表（每项含名称）",
            "items": {
              "type": "object",
              "required": ["名称"],
              "additionalProperties": false,
              "properties": {
                "名称": {
                  "type": "string",
                  "minLength": 1
                }
              }
            }
          },
          "structured_content": {
            "type": "array",
            "description": "与该节点相关的描述内容（可含排除项）",
            "items": {
              "type": "string"
            }
          }
        }
      }
    },
    "suggested_additions": {
      "type": "array",
      "description": "建议新增的节点。按规则只新增实质，不新增形式 — 所以 category_type 必为「实质」。",
      "items": {
        "type": "object",
        "required": [
          "category_type",
          "parent_path",
          "suggested_level",
          "reason",
          "action",
          "ability_type",
          "suggested_categories",
          "structured_content"
        ],
        "additionalProperties": false,
        "properties": {
          "category_type": {
            "type": "string",
            "enum": ["实质"],
            "description": "新增建议只针对实质（硬约束）"
          },
          "parent_path": {
            "type": "string",
            "description": "库中已存在的最深父级路径，若从 L1 开始则为空字符串"
          },
          "suggested_level": {
            "type": "string",
            "enum": ["L1", "L2", "L3", "L4", "L5", "L6"],
            "description": "建议新增的层级"
          },
          "reason": {
            "type": "string",
            "minLength": 1,
            "description": "缺失原因（一句话）"
          },
          "action": {
            "type": "string",
            "minLength": 1,
            "description": "对该节点内容的操作要求"
          },
          "ability_type": {
            "type": "string",
            "minLength": 1,
            "description": "能力类型"
          },
          "suggested_categories": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "object",
              "required": ["category_name", "category_description"],
              "additionalProperties": false,
              "properties": {
                "category_name": {
                  "type": "string",
                  "minLength": 1
                },
                "category_description": {
                  "type": "string",
                  "minLength": 1
                }
              }
            }
          },
          "structured_content": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}