look_at_plate
Destructive
Capture a build-plate image from a printer camera and record whether the plate is clear or occupied before printing.
Instructions
Look at the build plate through the machine's camera, and record what is there.
Two steps, one tool. Called WITHOUT ``seen`` it fetches a frame and
hands it to you as a picture, after a short text record that names
``snapshot_path``, the same picture saved on this computer -- and
records nothing. Look at it, then call again with ``seen="clear"``
(nothing on the plate) or ``seen="occupied"`` (something is), and that
answer becomes the plate record with you named as the one who looked.
The picture shows whatever the camera sees, the room around the
printer included. This tool saves it only on this computer and hands
it only to you; it is never written to a log.
A refusal over a recorded part (a slice with no spot named, a print
start, a park or home that would cross it) already carries that frame
as ``snapshot_path`` and says how old the record is: look at it and
come straight here with ``seen``. A record days old most likely
describes a part someone took off -- look before you ask a person.
A print held with ``ALWAYS_ALLOW_LOOK_FIRST`` carries a frame the same
way: always allow is on for that printer, nobody is being asked, so
the bed is looked at first. Judge that frame here with ``seen`` and
start the print again; the picture is kept with the print's record.
If you cannot tell, say ``occupied`` -- the person is then the one who
says the bed is clear.
When the PERSON tells you the bed is clear -- typed to you in a chat,
after a refusal that says a part is on it -- pass their words exactly
as ``person_says``. They have to say it flatly ("bed clear", "the
plate is empty"); a hedge or a question is not that. Where this app
can show a dialog, Kiln asks the person itself and records their
answer; otherwise the words are recorded as passed on by you, kept on
the record. Never write these words yourself: if they have not said
it, ask them. It settles a plate the record says is occupied; a plate
with no such record is settled by looking.
Kiln ships no vision model and judges nothing here. The eyes are
yours; this tool is the camera and the pen. Say what you actually see:
a plate you are not sure about is ``occupied``, because the cost of a
wrong "clear" is a print driven into a part and the cost of a wrong
"occupied" is one question.
Works on any printer with a camera Kiln can read -- the machine's own,
or one registered against it with ``camera_snapshot_url``, which works
on every printer type including those with no camera of their own.
A machine with neither says so and stays ``unknown``.
Args:
printer_name: Which printer. Omit for the default one.
seen: Omit to fetch the picture. ``"clear"`` or ``"occupied"`` to
record what you saw in the picture you were just given.
person_says: The person's own words that the bed is clear, exactly
as they typed them. Not with ``seen``.
Returns the ``plate`` record and a ``look`` block saying whether a
frame was available and which camera it came from -- followed, when a
picture was taken, by the picture itself as image content.
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": "look_at_plate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seen | No | Omit to fetch the picture. ``"clear"`` or ``"occupied"`` to record what you saw in the picture you were just given. | |
| person_says | No | The person's own words that the bed is clear, exactly as they typed them. Not with ``seen``. | |
| printer_name | No | Which printer. Omit for the default one. |