Tool definition reference
Every field of a tool definition: tags, direction, units, magnitude and rate limits, verification strategy and owner.
Documentation
Everything needed to run, extend and audit the platform.
Guides for the first hour, reference for the parts you come back to, and runbooks written for the shift.
Getting started
First hour
From an empty tenant to a shadow-mode agent on a replayed run.
- 01Install the SDK and CLI
pip install glasent, then glasent auth login with your tenant. Access is provisioned with a pilot.
- 02Import a tag model
glasent tags import from your tag survey. Every tag gets units, ranges and an owner.
- 03Define a tool and an agent
Start from the anneal example on this page: one read-only tool, one guarded write, one goal.
- 04Replay a historical run
glasent replay against a historian extract. Compare recommendations to what the technologist did.
- 05Simulate on the twin
glasent twin simulate ranks candidates and shows which were discarded and why.
- 06Run in shadow
glasent run with --autonomy L1 on the connected line. Nothing is written; everything is logged.
Developers
Define an agent, bound it, run it
The Glasent SDK is typed Python. Tools are declared with schemas and limits; the policy engine enforces them at call time, not in a review meeting.
What you get
- Typed tool definitions with unit-aware ranges and rate limits
- Deterministic replay of any historical run against a new model
- Local twin harness so a recipe is simulated before it is shipped
- Autonomy policy as code, versioned and reviewed like any other change
# Bound the anneal agent to twelve lehr zones on FL-2.
from glasent import Agent, Tool, Limit, Autonomy
lehr = Tool(
name="lehr.write_curve",
tags=["FL2.LEHR.Z01..Z12.TEMP_SP"],
limits=[Limit(max_step="4 C", per="60s")],
)
anneal = Agent(
id="agent.anneal_stress",
goal="residual stress inside spec, min energy",
tools=[lehr, Tool("optic.read_birefringence", read_only=True)],
# bounded writes; a technologist still gates pull steps
autonomy=Autonomy.L3,
# simulate on Glastwin before every write
verify="twin",
)
run = anneal.start(line="FL-2", product="CLR-4MM")
for step in run.stream():
print(step.name, step.status, step.duration)
Reference
Reference sections
The parts you will come back to.
Agent definition reference
Goal statements, tool binding, autonomy levels, verification modes and escalation behaviour.
Autonomy policy schema
Level definitions, tag classes, approval chains, shift and interlock conditions, and site override rules.
REST and SSE reference
Endpoints, payloads, error codes, idempotency and webhook signature verification.
Simulation reference
Snapshot format, correction cadence, candidate scoring and the stress and seed limits that discard a recipe.
Log format and export
Entry schema, hash chaining, retention configuration and JSON or CSV export.
Ware record schema
Batch, melt, forming, lehr curve, defect map, stress map, agent actions, human approvals and standards mapping.
Connector reference
OPC UA, Modbus, GigE Vision, REST and file-drop connectors, with the tag model each produces.
Model registry
Versions, validation datasets, promotion history and rollback for every perception and control model.
Run timeline · scenario
Reading a run record
Every Glasent run is an ordered, inspectable sequence. This is scenario_fl2_01 on FL-2 · float line · clear soda-lime: Thickness change FL-2 · 6 mm to 4 mm clear float, residual stress inside spec, zero escaped seeds. It is a worked scenario that shows the shape of a run, not a measured customer result.
scenario_fl2_01
FL-2 · float line · clear soda-lime
scenario
SUCCEEDED
-
01
ingest.order
SUCCEEDED
0.9 s
Plant Orchestrator · Pulled the 4 mm clear float spec, optical-grade tolerances and the standing energy window from plant MES; locked the target envelope for the run.
-
02
twin.simulate
SUCCEEDED
41 s
Glastwin · Simulated 36 candidate transition recipes across furnace pull, tin-bath ribbon speed and lehr curve; ranked them on seed risk, residual stress and energy per tonne.
-
03
melt.pull
SUCCEEDED
6 m 20 s
Meltrix · Stepped furnace pull toward the new ribbon mass flow while holding melt temperature and fining; chemistry stayed inside the composition window.
-
04
form.ribbon
SUCCEEDED
4 m 05 s
Formeon · Raised ribbon speed and re-angled the top rollers to thin the ribbon toward 4 mm; thickness converged inside the design tolerance.
-
05
anneal.curve
SUCCEEDED
3 m 12 s
Anneon · Re-shaped the lehr cooling curve for the thinner, faster ribbon so residual stress stays inside spec at the higher speed.
-
06
inspect.ribbon
SUCCEEDED
continuous
Seedscan · 8 camera, optical and stress stations streaming; a seed cluster flagged at the ribbon edge and attributed to the pull transient, routed to cullet.
-
07
yield.balance
SUCCEEDED
2.4 s
Plant Orchestrator · Re-sequenced cut sizes so transition ribbon routes to cullet recovery and good ribbon to the highest-value open order.
-
08
approve.human
APPROVAL
48 s
Plant Orchestrator · The second pull step exceeded the site autonomy threshold. Held for the glass technologist on shift; approved and written to the audit log.
-
09
handle.stack
SUCCEEDED
1 m 10 s
Panebot · Re-planned pick and stack paths for the thinner panes; plates flagged by Seedscan diverted to cullet, good plates stacked to rack A3.
-
10
ware.qualify
SUCCEEDED
1 m 02 s
Plant Orchestrator · Lot released with full genealogy: batch, melt, forming, lehr curve, defect map, stress map and the technologist's approval.
Tool calls · scenario
Reading the tool log
Every tool invocation, argument and result is written to an immutable, human-readable log, and every reasoning step is expandable. Nothing about a run is hidden from the plant.
- 02:14:03mes.read_orders({ line: "FL-2", next: "CLR-4MM" })
- 02:14:03ok spec locked · 4.0 mm · optical grade · stress limit set
- 02:14:04twin.simulate({ candidates: 36, horizon: "22 min" })
- 02:14:45ok best recipe #19 · seed risk low · stress inside spec
- 02:14:46policy.evaluate({ recipe: 19, autonomy: "L3" })
- 02:14:46ok 11 writes permitted · 1 write requires human approval
- 02:14:47scada.write_setpoint({ tag: "F1.PULL_SP", step: 1 })
- 02:21:07ok pull step 1 settled · fining stable · chemistry in window
- 02:21:08float.write_ribbon({ speed: "+", rollers: "re-angle" })
- 02:25:13ok thickness converging to 4.0 mm · flatness in tolerance
- 02:25:14lehr.write_curve({ zones: 12, profile: "4mm-fast" })
- 02:28:26ok residual stress inside spec at new belt speed
- 02:28:27vision.stream({ stations: 8, model: "seedscan-v3" })
- 02:28:41seed cluster · ribbon edge · attributed to pull transient
- 02:28:42cuopt.sequence({ objective: "cullet+energy" })
- 02:28:44ok transition ribbon routed to cullet · good ribbon to order
- 02:28:45approval.request({ action: "pull_step_2" })
- 02:29:33ok approved by the technologist on shift · logged
- 02:31:02isaac.plan_path({ stack: "A3", thickness: "4.0 mm" })
- 02:32:12ok paths validated in Isaac Sim · flagged plates diverted
- 02:33:15mes.log_lot({ lot: "FL2-4MM", genealogy: "full" })
- 02:34:17ok scenario run complete · stress in spec · 0 escaped seeds
Reasoning trace
Plan, thought, action, observation, exactly as the orchestrator would record it.
GoalMove FL-2 from 6 mm to 4 mm clear float with residual stress i…
Move FL-2 from 6 mm to 4 mm clear float with residual stress inside spec and zero escaped seeds.
PlanSimulate the transition on the twin first. Lead with furnace p…
Simulate the transition on the twin first. Lead with furnace pull so the ribbon mass flow is right before the forming change, then thin the ribbon, then re-shape the lehr curve. Watch the ribbon continuously; hold the second pull step for a human.
ThoughtThe standing recipe changes pull and ribbon speed together. On…
The standing recipe changes pull and ribbon speed together. On the twin that produces a fining transient that seeds the ribbon edge. Sequencing the pull step ahead of the forming change and holding fining removes most of it.
Actiontwin.simulate(candidates=36) returned recipe #19: pull in two …
twin.simulate(candidates=36) returned recipe #19: pull in two steps, forming change after fining settles, lehr curve re-shaped before belt speed rises.
ObservationRecipe #19 scored lowest on seed risk with stress inside spec.…
Recipe #19 scored lowest on seed risk with stress inside spec. Two candidates scored lower on energy but pushed residual stress over the site limit and were discarded.
ActionExecute recipe #19 under autonomy level L3: eleven setpoint wr…
Execute recipe #19 under autonomy level L3: eleven setpoint writes permitted, the second pull step routed to the glass technologist.
ObservationSeed cluster at the ribbon edge at 02:28:41, attributed to the…
Seed cluster at the ribbon edge at 02:28:41, attributed to the pull transient. cuOpt routed that ribbon to cullet recovery; no flagged plate reached a customer stack.
OutcomeScenario run complete. Thickness at 4.0 mm, residual stress in…
Scenario run complete. Thickness at 4.0 mm, residual stress inside spec, one approval gate, full genealogy written to the lot record.
Operations
Runbooks
What to do when something is not right, written for the shift, not for us.
Control is already back with the plant
Confirm the plant's own systems hold the last known-good state, then restore the node. No action is pending from Glasent.
A held step needs a named person
The run waits. Find the approver in the console or escalate per the site chain. Nothing moves until someone decides.
Roll back by version
Every model is versioned. Roll back from the registry; the run engine picks it up on the next step.
Treat it like a code change
Edit, review, sign, deploy. The policy version appears on every write made under it.
Autonomy
Four levels, set per agent and per tag
A plant does not go from manual to unattended in one step. Glasent makes the level explicit, auditable and reversible at any time, and the first release plan is shadow, then assist, then graduated autonomy.
| Level | What the agent does | What the person does | When |
|---|---|---|---|
| L1 · Shadow and advisory | Observes, predicts and recommends setpoints with its reasoning | Enters every change manually; a baseline is measured | Pilot weeks 1 to 3 |
| L2 · Assist | Proposes a write; it executes on approval | Approves each write in the review console | Pilot weeks 4 to 8 |
| L3 · Bounded | Writes inside tag, rate and magnitude limits on low-risk loops | Approves pull steps, grade releases and anything above threshold | Pilot week 9 onward |
| L4 · Unattended | Runs the approved envelope without prompting | Sets the envelope; reviews the shift record | Planned, after graduated autonomy proves out |
CLI
Start a run from anywhere
The same run engine, the same policy checks, the same audit trail, from the terminal, the review console or the SDK.
$ glasent run "thickness change FL-2 to 4 mm" --autonomy L3
→ plan composed 10 steps · 1 approval gate
→ twin.simulate 36 candidates · best #19 · stress in spec
→ policy.evaluate 11 writes permitted · 1 held for human
→ executing melt.pull ....... ok 6m20s
→ executing form.ribbon ..... ok 4m05s
→ executing anneal.curve .... ok 3m12s
! seed cluster ribbon edge · attributed to pull transient
! approval required pull step 2 · above site threshold
→ approved glass technologist on shift · 02:29:33
→ run complete scenario · stress in spec · 0 escaped seeds
$ glasent runs show scenario_fl2_01 --format genealogy
Limits
Platform limits and defaults
Defaults a site can tighten. None can be loosened past the tool definition.
| Item | Default | Range | Who changes it |
|---|---|---|---|
| Autonomy level on install | L1 shadow | L1 to L4 | Plant director |
| Max write step per tag | Per tool definition | Tightened per site | Tool owner |
| Approval timeout | No timeout; the run waits | Fixed | Nobody |
| Twin candidates per run | 36 | 10 to 100 | Technologist |
| Stations per line | As surveyed | 4 to 24 | Deployment engineer |
| Audit retention | Plant storage, indefinite | Site policy | Plant IT |
Guardrails
An agent that can move a furnace needs a leash
Glasent writes to production equipment. Every capability is scoped, every write is policy-checked, and every action is written to an append-only audit log the plant owns.
- Bounded action space. Each agent can only write to an explicit tag allow-list, inside per-tag rate and magnitude limits.
- Policy engine before every write. Autonomy level, shift, product, interlock state and operator presence are all evaluated before a setpoint moves.
- Human-in-the-loop gates. Anything above the site threshold, pull steps, grade releases, safety-adjacent moves, waits for a named approver.
- Immutable audit log. Append-only, hash-chained, exportable, and retained on the plant's own storage.
- Hard fallback. Loss of the edge node, the network or the model returns control to the furnace, forming and lehr systems' last known-good state.
- Tenant and IP isolation. Compositions, forming recipes and defect libraries never cross a customer boundary. On-prem deployment available.
Compliance posture
| Standard | Scope | Status |
|---|---|---|
| SOC 2 Type I | Cloud control plane | RUNNING Planned in the first six months |
| SOC 2 Type II | Cloud control plane | QUEUED Planned in months six to twelve |
| IEC 62443 | Plant-edge OT security | RUNNING Design-aligned |
| ISO 9001 / IATF 16949 | Quality and genealogy records | SUCCEEDED Record formats supported |
| Container and safety-glass standards | Stress and defect conformance records | SUCCEEDED Record formats supported |
Integrations
It speaks plant, not cloud
Glasent reads and writes through the furnace, forming, lehr, inspection and MES systems already on the floor. No rip-and-replace, no parallel historian, no new HMI to learn.
Furnace SCADA and PLC, batch-plant weighing, redox and fining instruments
Setpoint reads and guarded writes over OPC UA and Modbus
Float-bath and IS-machine controls, gob-weight and timing systems
Gob, pull, ribbon speed and roller reads; guarded writes
Lehr zone controllers and belt drives
Zone temperature and curve reads; guarded writes
Camera, optical, thermal, polariscope and birefringence stations
Frames, stress maps, defect records, line-speed streams
Orders, grades, lots and ware genealogy
Spec and tolerance reads; genealogy and release writes
Time-series stores and lab information systems
Backfill, replay and lab chemistry
Robot cells, conveyors and stackers via NVIDIA Isaac
Pick, path and stack commands inside the safety envelope
SSO and RBAC via SAML or OIDC; NVIDIA Jetson Orin edge nodes
Named approvers, tag-level roles, sub-100 ms inference
FAQ
Straight answers
The questions plant directors and glass technologists ask in the first meeting.
Yes, but only within an explicit tag allow-list with per-tag rate and magnitude limits, and only at the autonomy level your site has set. Every pilot starts in shadow mode, where Glasent predicts and recommends and a person enters everything. Writes come later, after the recommendations have earned it.
Control returns to your existing furnace, forming and lehr systems at their last known-good state. Glasent is a supervisory layer on top of the control system you already run, never a replacement for it, so an outage degrades the plant to its current way of running, not to a stop.
Shadow mode starts on the first day from existing SCADA, forming, lehr and inspection data. Defect and stress prediction improve as site history and labelled outcomes accumulate; the pilot plan sets a baseline period before any recommendation is scored.
Only if you choose cloud training. Compositions, forming recipes and defect libraries are tenant-isolated and never used to train another customer's models. On-prem training and an air-gapped plant edge are available for IP-sensitive producers.
You are, the same as with any control strategy, which is why every write is policy-checked, bounded, logged and reversible, and why anything above your risk threshold waits for a named approver. The audit log records the request, the reasoning, the limits applied and the human decision.
A 90 to 120 day line pilot in three stages: shadow mode to measure the baseline, assist mode where a technologist approves each recommendation, then bounded write-back on low-risk forming, annealing or inspection loops if the plant is satisfied with the results.
Get started
Get documentation access
The full documentation set is provisioned with a pilot. Ask for it when you scope the line.