Agent: Schema Validator

agent_validator · ai · Utility · Available · v1.1.0

Description

Validate structured input against JSON Schema + business rules. Returns valid/errors/normalized. Top 2026: schema, custom rules, strict mode, error path, normalize-on-fix.

⚙️ Configuration parameters

Fields shown in the editor when configuring the node. Generated directly from the NodeDefconfigFields.

Field	Type	Required	Default	Description
`schema` JSON Schema di validazione	`code`	yes	— { "type": "object", "required": ["email", "totale"], "properties": { "email": { "type": "string", "pattern": "^[^@]+@[^@]+$" }, "totale": { "type": "number", "minimum": 0 }, "tipo": { "type": "string", "enum": ["contratto","fattura","preventivo"] } } }	JSON Schema standard (draft-07). Definisce type/required/properties/pattern/enum/min/max. L'agent verifica che l'input rispetti lo schema e ritorna errors[] con path JSONPath.
`businessRules` Regole di business (opzionale)	`string (multiline)`	no	— es. "Se totale > 10000, customer_vat deve essere presente" "Se tipo=preventivo, deadline deve essere entro 30 giorni"	Regole in linguaggio naturale che vanno OLTRE il JSON Schema. L'agent le applica una per riga.
`strictMode` Strict mode (rifiuta campi extra)	`boolean`	no	`false`	Se true, qualsiasi field non dichiarato nello schema produce un errore. Se false, campi extra sono ignorati.
`normalize` Auto-normalize (trim/lowercase/parse)	`boolean`	no	`true`	Se true, prova fix non-distruttivi prima di failare: trim stringhe, lowercase email, parse number da stringa numerica. Output in "normalized".
`onInvalidBehavior` Cosa fare se invalido	`enum` `continuehaltbranch`	no	`continue`	continue=passa output al next con valid:false; halt=ferma workflow con errore; branch=usa con logic_if su output.valid per branching.
`provider` LLM provider (opzionale, override)	`enum` `liaraanthropicopenaigeminimistralgroqopenrouterollama`	no	—	Vuoto = usa il default da Settings → AI Providers. Selezionalo SOLO per override locale (es. account diverso per questo nodo).
`apiKey` API key (override)	`string (encrypted)`	no	—	Vuoto = usa la chiave di Settings → AI Providers. Liara è free-tier (nessuna key necessaria).
`model` Modello (override)	`string`	no	— es. claude-sonnet-4-5	Vuoto = default del provider. Es. claude-sonnet-4-5, gpt-4o, gemini-2.0-flash, nha-v1.
`baseUrl` Base URL (per Ollama / self-hosted)	`string`	no	— http://localhost:11434	—
`extraContext` Contesto aggiuntivo (opzionale)	`expression`	no	— Esempi di output desiderato, glossario di dominio, regole speciali...	Testo aggiunto al prompt PRIMA dell'input. Utile per "few-shot examples" o vincoli che il system prompt non copre.

💡 Configuration example

JSON snippet of the node as it appears in the workflow. Values are derived fromdefaultValue and from required parameters.

{
  "id": "node-agent_validator-1",
  "defId": "agent_validator",
  "label": "Agent: Schema Validator",
  "config": {
    "schema": "{\n  \"type\": \"object\",\n  \"required\": [\"email\", \"totale\"],\n  \"properties\": {\n    \"email\": { \"type\": \"string\", \"pattern\": \"^[^@]+@[^@]+$\" },\n    \"totale\": { \"type\": \"number\", \"minimum\": 0 },\n    \"tipo\": { \"type\": \"string\", \"enum\": [\"contratto\",\"fattura\",\"preventivo\"] }\n  }\n}",
    "strictMode": false,
    "normalize": true,
    "onInvalidBehavior": "continue"
  }
}

🔗 Related nodes in the same category

Ready to use Agent: Schema Validator?

Available now on all FlowForge plans. Try it free without a credit card.

Start free Browse all nodes