monitor_print_vision
Captures webcam snapshot of a 3D print, analyzes it for visual failures, and returns structured metadata with optional auto-pause on issue detection.
Instructions
Snapshot + structured data for AI visual inspection of an in-progress print.
Use when analyzing camera images for print failures. Returns webcam image
(base64 or saved file) alongside structured metadata (temps, progress,
phase, cost estimate, failure hints). Can auto-pause on detected issues.
For a quick text status report, use ``monitor_print`` instead.
For persistent background monitoring, use ``watch_print``.
Args:
printer_name: Target printer. Omit for the default printer.
include_snapshot: Whether to capture a webcam snapshot (default True).
save_snapshot: Optional path to save the snapshot image.
failure_type: Optional detected failure type (e.g. "spaghetti",
"layer_shift", "warping"). Reported by the agent after visual
inspection of a previous snapshot.
failure_confidence: Confidence score (0.0-1.0) of the failure detection.
auto_pause: If True, automatically pause the print when a failure is
detected with confidence >= 0.8. Defaults to the value of the
``KILN_VISION_AUTO_PAUSE`` environment variable (default False).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| auto_pause | No | ||
| failure_type | No | ||
| printer_name | No | ||
| save_snapshot | No | ||
| include_snapshot | No | ||
| failure_confidence | No |