repair_guide
Read-only
Walk through a printer maker's own repair guide one step per call, serving the maker's power-off warning, numbered steps, images and checks in their published order.
Instructions
Walk through the printer maker's own repair guide, one step per call.
The guide is the maker's published page for THIS model, reproduced in the
maker's order: their power-off warning first, their numbered steps in
their words, their picture for each step (as a URL, served from their
site with attribution -- Kiln never copies it), and their own check at
the end where the page has one. Kiln adds words only where the picture
cannot say it. Where the maker states them, the header carries the
tools, the interval ("every 10-15 spools") and the parts.
**Run it in steps, with the person at the machine.** ``plan_only=True``
returns the header (maker, page title and URL, the maker's own "also
applies to" sentence, tools, interval, parts) plus step 0 and the step
titles. ``step=0`` is ALWAYS the maker's power-off warning, verbatim.
``step=N`` returns only step N and names step N+1. Every step from 1 on
requires ``power_off_confirmed=True`` -- a PERSON's statement that the
printer is off and unplugged; without it the call is refused with
``POWER_OFF_REQUIRED`` and the warning itself. Never set it on a
person's behalf. A person who is already partway in (the screw is out)
skips ahead with ``step``; Kiln never assumes where they are. The last
step of a guide that fixes or replaces a part carries
``record_the_repair``: once the person says it is done, ask whether to
mark the printer repaired (``set_machine_repair``), so Kiln judges it by
its next prints.
Where Kiln has no guide for the topic it says so: the maker's own
maintenance index for this model where Kiln knows it (``maker_index_url``),
otherwise "your maker publishes no guide Kiln can step through". No
generic procedure is ever presented as the maker's.
Args:
printer_id: Printer model identifier (e.g. ``bambu_a1_mini``). Omit
to use the declared ``printer_model`` of ``printer_name`` (or the
default printer).
topic: What to repair -- ``cutter``, ``nozzle``, ``hotend``,
``ptfe_tube``, ``extruder_gears``, ``belts``, ``bed_level``,
``lubrication``, ``firmware_recovery``, ``filament_sensor``. A
fault code written here is read as one.
hms_code: The code on the printer's screen (``"1200-8001"``, any
separators); where it maps to a guide, that guide is chosen and
the answer says which step to start at.
step: Which step to serve (0 = the power-off warning). Ignored with
``plan_only``.
plan_only: Return the header and step titles; serve no step.
power_off_confirmed: A PERSON has powered the printer off and
unplugged it. Required for every ``step >= 1``.
printer_name: Which registered printer's declared model to use when
``printer_id`` is omitted.
guide: A guide's slug, from a ``choices`` answer. When a topic
matches more than one of the maker's guides for this model (one
Kiln printer id can cover two machines; a maker often has two
pages for one job) the answer lists them and nothing is picked
for the person -- ask, then pass the chosen slug here.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "repair_guide"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| step | No | Which step to serve (0 = the power-off warning). Ignored with ``plan_only``. Default: 0. | |
| guide | No | A guide's slug, from a ``choices`` answer. When a topic matches more than one of the maker's guides for this model (one Kiln printer id can cover two machines; a maker often has two pages for one job) the answer lists them and nothing is picked for the person -- ask, then pass the chosen slug here. Default: "". | |
| topic | No | What to repair -- ``cutter``, ``nozzle``, ``hotend``, ``ptfe_tube``, ``extruder_gears``, ``belts``, ``bed_level``, ``lubrication``, ``firmware_recovery``, ``filament_sensor``. A fault code written here is read as one. Default: "". | |
| hms_code | No | The code on the printer's screen (``"1200-8001"``, any separators); where it maps to a guide, that guide is chosen and the answer says which step to start at. Default: "". | |
| plan_only | No | Return the header and step titles; serve no step. Default: false. | |
| printer_id | No | Printer model identifier (e.g. ``bambu_a1_mini``). Omit to use the declared ``printer_model`` of ``printer_name`` (or the default printer). Default: "". | |
| printer_name | No | Which registered printer's declared model to use when ``printer_id`` is omitted. Default: "". | |
| power_off_confirmed | No | A PERSON has powered the printer off and unplugged it. Required for every ``step >= 1``. Default: false. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||