record_decoration_preset_outcome
Records a print outcome (success, partial, or failed) against a specific decoration preset version, so each version builds its own track record for quality and adhesion analysis.
Instructions
Record a print outcome against a specific preset version.
Needs Kiln Pro.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"preset_version_id": "<preset_version_id>",
"print_job_id": "<print_job_id>",
"outcome": "<outcome>"
},
"name": "record_decoration_preset_outcome"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | Freeform operator notes. Appended after the structured prefix. | |
| outcome | Yes | One of ``"success"``, ``"partial"``, ``"failed"``; any other word is refused. | |
| mesh_path | No | Optional path to the printed STL. When a ``<mesh>.intent.json`` sidecar lives next to it, ``intent_id`` / ``intent_hash`` are auto-tagged on the outcome row so per-intent success-rate queries pick this print up without the caller threading them by hand. | |
| print_job_id | Yes | Identifier of the print job that produced this outcome. Stored alongside the outcome so the print can be traced back later. | |
| quality_score | No | Optional 0.0–1.0 subjective quality rating. Packed into the notes prefix. | |
| adhesion_quality | No | Optional one of ``"poor"``, ``"good"``, ``"excellent"``. Maps to ``adhesion_issues=(adhesion_quality == "poor")`` on the underlying row and is also preserved verbatim in the notes prefix for round-trip. | |
| preset_version_id | Yes | The preset version attached at print time. Outcomes are keyed per-version so a version bump starts a clean track record. |