Create a Blueprint — a governance contract that defines validation rules.
A Blueprint tells the platform what "correct" means for your data: which
fields exist, what math must hold between them, and what value ranges
are acceptable. Without a Blueprint, the platform has nothing to validate against.
If you don't know what rules to define, use load_rule_pack to start from
a prebuilt template, or use discover_patterns to find rules from your data.
Use the blueprint_guide prompt for the complete reference of all available
rule types, constraint types, and configuration options.
Args:
api_key: GeodesicAI API key (starts with gai_)
customer_name: Organization or project name (used for folder naming)
workflow_name: Unique identifier for this Blueprint (used as the 'blueprint' parameter in validate)
mode: "observe" (platform checks agent's work) or "enforce" (platform computes derived fields)
extracted_fields: Fields the agent extracts from source data (e.g. ["vendor", "qty", "unit_cost"])
derived_fields: Fields computed from other fields (e.g. ["subtotal", "total"])
derivation_rules: Math rules defining field relationships. Available types: "add" (target = a + b), "subtract" (target = a - b), "multiply" (target = a × b), "divide" (target = a ÷ b), "round" (round field to N places), "copy" (copy source to target), "items_multiply" (per-item a × b in a list), "items_sum" (sum a field across list items). Each rule requires "type" and the relevant fields. See blueprint_guide prompt for full schema.
formal_constraints: Value bounds and ratio constraints. Available types: "magnitude_anchor" (field within min/max range, requires "field", "min", "max"), "relative_anchor" (ratio a/b within tolerance, requires "a", "b", "expected_ratio", "tolerance"), "max_action_threshold" (trigger action if field exceeds threshold, requires "field", "threshold", "action"). See blueprint_guide prompt for full schema.
semantic_checks: Domain-specific validation checks
require_math: Validate mathematical relationships (default true)
require_consistency: Check internal consistency (default true)
require_coherence: Check structural coherence (default true)
require_provenance: Require agents to report extraction source locations
require_high_assurance: Strictest validation — feasibility, spectral, and global consistency required
enable_anomaly_detection: Geometric fingerprinting to detect structural outliers
enable_drift_tracking: Monitor pattern stability across batches