get_active_material
Read-only
Reads live AMS tray data to identify the filament physically active on a Bambu Lab printer and returns type, colour, remaining percentage, and temperature range.
Instructions
Get the filament physically active in the AMS hardware right now (Bambu Lab).
Reads live tray data from the AMS hardware. For the software-tracked
material (what was told to Kiln via ``set_material``), use
``get_material`` instead.
For Bambu Lab printers with an AMS, reads the active tray and
returns its type, colour, remaining percentage, and temperature
range. For non-Bambu printers (or printers without AMS), the
material is reported as ``"unknown"``.
``tray_now`` is the printer's own tray id (``unit * 4 + slot``
on a chained unit, the unit id itself on an AMS HT); ``254``
is the external spool and ``255`` no tray. An A1 / AMS Lite
can report ``255`` with trays loaded; then Kiln falls back to
the selected/target tray fields or returns the loaded
candidates instead of claiming the external spool.
Args:
printer_name: Named printer to query. Omit to use the
default printer.
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": "get_active_material"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| printer_name | No | Named printer to query. Omit to use the default printer. |