[{"data":1,"prerenderedAt":1803},["ShallowReactive",2],{"navigation":3,"\u002Fautomate\u002Fguides\u002Fbasic-hitl":750,"\u002Fautomate\u002Fguides\u002Fbasic-hitl-surround":1798},[4,80,134,364,428,530,567,646],{"title":5,"path":6,"stem":7,"children":8,"page":42},"Get Started","\u002Fget-started","01.get-started",[9,13,17,43,47],{"title":10,"path":11,"stem":12},"Welcome to UniteLabs","\u002Fget-started\u002Fwelcome","01.get-started\u002F00.welcome",{"title":14,"path":15,"stem":16},"How it works","\u002Fget-started\u002Fhow-it-works","01.get-started\u002F01.how-it-works",{"title":18,"path":19,"stem":20,"children":21,"page":42},"Use Cases","\u002Fget-started\u002Fuse-cases","01.get-started\u002F02.use-cases",[22,26,30,34,38],{"title":23,"path":24,"stem":25},"Instrument Control","\u002Fget-started\u002Fuse-cases\u002Flow-level-instrument-control","01.get-started\u002F02.use-cases\u002F10.low-level-instrument-control",{"title":27,"path":28,"stem":29},"Multi-device Control","\u002Fget-started\u002Fuse-cases\u002Fmulti-device-control","01.get-started\u002F02.use-cases\u002F20.multi-device-control",{"title":31,"path":32,"stem":33},"Workflow Orchestration","\u002Fget-started\u002Fuse-cases\u002Fworkflow-orchestration","01.get-started\u002F02.use-cases\u002F30.workflow-orchestration",{"title":35,"path":36,"stem":37},"Custom Apps and LIMS Integration","\u002Fget-started\u002Fuse-cases\u002Fcustom-apps-lims","01.get-started\u002F02.use-cases\u002F40.custom-apps-lims",{"title":39,"path":40,"stem":41},"Scale and Fleet Management","\u002Fget-started\u002Fuse-cases\u002Fscale-and-fleet","01.get-started\u002F02.use-cases\u002F50.scale-and-fleet",false,{"title":44,"path":45,"stem":46},"Lab as Code","\u002Fget-started\u002Fwhy-code","01.get-started\u002F03.why-code",{"title":48,"path":49,"stem":50,"children":51,"page":42},"Setup","\u002Fget-started\u002Fsetup","01.get-started\u002F20.setup",[52,56,60,64,68,72,76],{"title":53,"path":54,"stem":55},"GroundControl","\u002Fget-started\u002Fsetup\u002Fgroundcontrol","01.get-started\u002F20.setup\u002F10.groundcontrol",{"title":57,"path":58,"stem":59},"Network requirements","\u002Fget-started\u002Fsetup\u002Fnetwork-requirements","01.get-started\u002F20.setup\u002F20.network-requirements",{"title":61,"path":62,"stem":63},"Multi-device Networking","\u002Fget-started\u002Fsetup\u002Fmultiple-devices","01.get-started\u002F20.setup\u002F30.multiple-devices",{"title":65,"path":66,"stem":67},"Connect to Platform","\u002Fget-started\u002Fsetup\u002Fconnect-to-platform","01.get-started\u002F20.setup\u002F40.connect-to-platform",{"title":69,"path":70,"stem":71},"Headless install","\u002Fget-started\u002Fsetup\u002Fheadless-install","01.get-started\u002F20.setup\u002F50.headless-install",{"title":73,"path":74,"stem":75},"Raspberry Pi","\u002Fget-started\u002Fsetup\u002Fraspberry-pi","01.get-started\u002F20.setup\u002F55.raspberry-pi",{"title":77,"path":78,"stem":79},"Installation","\u002Fget-started\u002Fsetup\u002Fsdk-installation","01.get-started\u002F20.setup\u002F60.sdk-installation",{"title":81,"path":82,"stem":83,"children":84,"page":42},"Integrate","\u002Fintegrate","02.integrate",[85,89,93,118],{"title":86,"path":87,"stem":88},"What is a connector?","\u002Fintegrate\u002Fwhat-is-a-connector","02.integrate\u002F00.what-is-a-connector",{"title":90,"path":91,"stem":92},"Calling a Connector","\u002Fintegrate\u002Fcontrol-with-code","02.integrate\u002F05.control-with-code",{"title":94,"path":95,"stem":96,"children":97,"page":42},"Concepts","\u002Fintegrate\u002Fconcepts","02.integrate\u002F10.concepts",[98,102,106,110,114],{"title":99,"path":100,"stem":101},"Connector","\u002Fintegrate\u002Fconcepts\u002Fconnector","02.integrate\u002F10.concepts\u002F10.connector",{"title":103,"path":104,"stem":105},"Module","\u002Fintegrate\u002Fconcepts\u002Fmodule","02.integrate\u002F10.concepts\u002F20.module",{"title":107,"path":108,"stem":109},"Action","\u002Fintegrate\u002Fconcepts\u002Faction","02.integrate\u002F10.concepts\u002F30.action",{"title":111,"path":112,"stem":113},"Subscription","\u002Fintegrate\u002Fconcepts\u002Fsubscription","02.integrate\u002F10.concepts\u002F40.subscription",{"title":115,"path":116,"stem":117},"Device","\u002Fintegrate\u002Fconcepts\u002Fdevice","02.integrate\u002F10.concepts\u002F50.device",{"title":119,"path":120,"stem":121,"children":122,"page":42},"Use a connector","\u002Fintegrate\u002Fuse-a-connector","02.integrate\u002F30.use-a-connector",[123,126,130],{"title":53,"path":124,"stem":125},"\u002Fintegrate\u002Fuse-a-connector\u002Fgroundcontrol","02.integrate\u002F30.use-a-connector\u002F10.groundcontrol",{"title":127,"path":128,"stem":129},"Platform","\u002Fintegrate\u002Fuse-a-connector\u002Fplatform","02.integrate\u002F30.use-a-connector\u002F20.platform",{"title":131,"path":132,"stem":133},"UniteLabs SDK & REST API","\u002Fintegrate\u002Fuse-a-connector\u002Fpython","02.integrate\u002F30.use-a-connector\u002F30.python",{"title":135,"path":136,"stem":137,"children":138,"page":42},"Operate","\u002Foperate","03.operate",[139,142,146,186,259],{"title":135,"path":140,"stem":141},"\u002Foperate\u002Foverview","03.operate\u002F00.overview",{"title":143,"path":144,"stem":145},"Your First Protocol","\u002Foperate\u002Fyour-first-protocol","03.operate\u002F05.your-first-protocol",{"title":94,"path":147,"stem":148,"children":149,"page":42},"\u002Foperate\u002Fconcepts","03.operate\u002F10.concepts",[150,154,158,162,166,170,174,178,182],{"title":151,"path":152,"stem":153},"Liquid Handling","\u002Foperate\u002Fconcepts\u002Fliquid-handling","03.operate\u002F10.concepts\u002F10.liquid-handling",{"title":155,"path":156,"stem":157},"Modules","\u002Foperate\u002Fconcepts\u002Fmodules","03.operate\u002F10.concepts\u002F20.modules",{"title":159,"path":160,"stem":161},"Deck","\u002Foperate\u002Fconcepts\u002Fdeck","03.operate\u002F10.concepts\u002F30.deck",{"title":163,"path":164,"stem":165},"Labware","\u002Foperate\u002Fconcepts\u002Flabware","03.operate\u002F10.concepts\u002F40.labware",{"title":167,"path":168,"stem":169},"Liquids","\u002Foperate\u002Fconcepts\u002Fliquids","03.operate\u002F10.concepts\u002F50.liquids",{"title":171,"path":172,"stem":173},"Liquid Classes","\u002Foperate\u002Fconcepts\u002Fliquid-classes","03.operate\u002F10.concepts\u002F60.liquid-classes",{"title":175,"path":176,"stem":177},"Tips and Tip Tracking","\u002Foperate\u002Fconcepts\u002Ftips","03.operate\u002F10.concepts\u002F70.tips",{"title":179,"path":180,"stem":181},"Simulation","\u002Foperate\u002Fconcepts\u002Fsimulation","03.operate\u002F10.concepts\u002F80.simulation",{"title":183,"path":184,"stem":185},"Error Handling","\u002Foperate\u002Fconcepts\u002Ferror-handling","03.operate\u002F10.concepts\u002F90.error-handling",{"title":187,"path":188,"stem":189,"children":190,"page":42},"Guides","\u002Foperate\u002Fguides","03.operate\u002F20.guides",[191,220,232,256],{"title":163,"path":192,"stem":193,"children":194},"\u002Foperate\u002Fguides\u002Flabware","03.operate\u002F20.guides\u002F10.labware\u002Findex",[195,196,200,204,208,212,216],{"title":163,"path":192,"stem":193},{"title":197,"path":198,"stem":199},"Standard Labware","\u002Foperate\u002Fguides\u002Flabware\u002Fstandard-labware","03.operate\u002F20.guides\u002F10.labware\u002F05.standard-labware",{"title":201,"path":202,"stem":203},"Plates","\u002Foperate\u002Fguides\u002Flabware\u002Fplates","03.operate\u002F20.guides\u002F10.labware\u002F10.plates",{"title":205,"path":206,"stem":207},"Tips and Tip Racks","\u002Foperate\u002Fguides\u002Flabware\u002Ftips-and-racks","03.operate\u002F20.guides\u002F10.labware\u002F20.tips-and-racks",{"title":209,"path":210,"stem":211},"Tubes and Tube Racks","\u002Foperate\u002Fguides\u002Flabware\u002Ftubes-and-tube-racks","03.operate\u002F20.guides\u002F10.labware\u002F30.tubes-and-tube-racks",{"title":213,"path":214,"stem":215},"Troughs","\u002Foperate\u002Fguides\u002Flabware\u002Ftroughs","03.operate\u002F20.guides\u002F10.labware\u002F35.troughs",{"title":217,"path":218,"stem":219},"Carriers and Adapters","\u002Foperate\u002Fguides\u002Flabware\u002Fcarriers-and-adapters","03.operate\u002F20.guides\u002F10.labware\u002F40.carriers-and-adapters",{"title":159,"path":221,"stem":222,"children":223,"page":42},"\u002Foperate\u002Fguides\u002Fdeck","03.operate\u002F20.guides\u002F20.deck",[224,228],{"title":225,"path":226,"stem":227},"Building a Deck","\u002Foperate\u002Fguides\u002Fdeck\u002Fbuilding-a-deck","03.operate\u002F20.guides\u002F20.deck\u002F10.building-a-deck",{"title":229,"path":230,"stem":231},"Save\u002FLoad a Deck","\u002Foperate\u002Fguides\u002Fdeck\u002Fsave-load-deck","03.operate\u002F20.guides\u002F20.deck\u002F20.save-load-deck",{"title":233,"path":234,"stem":235,"children":236,"page":42},"Pipetting","\u002Foperate\u002Fguides\u002Fpipetting","03.operate\u002F20.guides\u002F30.pipetting",[237,241,245,249,252],{"title":238,"path":239,"stem":240},"Basic Pipetting","\u002Foperate\u002Fguides\u002Fpipetting\u002Fbasic-pipetting","03.operate\u002F20.guides\u002F30.pipetting\u002F10.basic-pipetting",{"title":242,"path":243,"stem":244},"Advanced Pipetting","\u002Foperate\u002Fguides\u002Fpipetting\u002Fadvanced-pipetting","03.operate\u002F20.guides\u002F30.pipetting\u002F20.advanced-pipetting",{"title":246,"path":247,"stem":248},"Tip Handling","\u002Foperate\u002Fguides\u002Fpipetting\u002Ftip-handling","03.operate\u002F20.guides\u002F30.pipetting\u002F30.tip-handling",{"title":171,"path":250,"stem":251},"\u002Foperate\u002Fguides\u002Fpipetting\u002Fliquid-classes","03.operate\u002F20.guides\u002F30.pipetting\u002F40.liquid-classes",{"title":253,"path":254,"stem":255},"Labware Transport","\u002Foperate\u002Fguides\u002Fpipetting\u002Flabware-transport","03.operate\u002F20.guides\u002F30.pipetting\u002F50.labware-transport",{"title":179,"path":257,"stem":258},"\u002Foperate\u002Fguides\u002Fsimulation","03.operate\u002F20.guides\u002F40.simulation",{"title":260,"path":261,"stem":262,"children":263,"page":42},"Liquid Handler Guides","\u002Foperate\u002Fdevices","03.operate\u002F30.devices",[264,305,330,347],{"title":265,"path":266,"stem":267,"children":268,"page":42},"Hamilton STAR","\u002Foperate\u002Fdevices\u002Fhamilton-star","03.operate\u002F30.devices\u002F10.hamilton-star",[269,273,277,281,285,289,293,297,301],{"title":270,"path":271,"stem":272},"Positioning & Movement","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fpositioning","03.operate\u002F30.devices\u002F10.hamilton-star\u002F10.positioning",{"title":274,"path":275,"stem":276},"Gripper Module","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fcore-gripper","03.operate\u002F30.devices\u002F10.hamilton-star\u002F20.core-gripper",{"title":278,"path":279,"stem":280},"iSWAP Module","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fiswap","03.operate\u002F30.devices\u002F10.hamilton-star\u002F30.iswap",{"title":282,"path":283,"stem":284},"Using TADM","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Ftadm","03.operate\u002F30.devices\u002F10.hamilton-star\u002F40.tadm",{"title":286,"path":287,"stem":288},"Autoload Module","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fautoload","03.operate\u002F30.devices\u002F10.hamilton-star\u002F50.autoload",{"title":290,"path":291,"stem":292},"Waste Block","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fwaste-block","03.operate\u002F30.devices\u002F10.hamilton-star\u002F60.waste-block",{"title":294,"path":295,"stem":296},"Complex Mixing","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fcomplex-mixing","03.operate\u002F30.devices\u002F10.hamilton-star\u002F66.complex-mixing",{"title":298,"path":299,"stem":300},"Teaching Gripper Paddle Positions","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fgripper-positions","03.operate\u002F30.devices\u002F10.hamilton-star\u002F70.gripper-positions",{"title":302,"path":303,"stem":304},"Training a Custom Deck Position With the iSWAP","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fcustom-deck-position","03.operate\u002F30.devices\u002F10.hamilton-star\u002F75.custom-deck-position",{"title":306,"path":307,"stem":308,"children":309,"page":42},"Hamilton Vantage","\u002Foperate\u002Fdevices\u002Fhamilton-vantage","03.operate\u002F30.devices\u002F20.hamilton-vantage",[310,314,318,322,326],{"title":311,"path":312,"stem":313},"Waste Configuration","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fwaste-configuration","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F05.waste-configuration",{"title":315,"path":316,"stem":317},"Covers and Lights","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fcovers-and-lights","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F10.covers-and-lights",{"title":319,"path":320,"stem":321},"IDL Module","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fidl","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F20.idl",{"title":323,"path":324,"stem":325},"IPG Module","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fipg","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F30.ipg",{"title":327,"path":328,"stem":329},"XL Pipettes","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fxl-channels","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F40.xl-channels",{"title":331,"path":332,"stem":333,"children":334,"page":42},"Agilent Bravo","\u002Foperate\u002Fdevices\u002Fagilent-bravo","03.operate\u002F30.devices\u002F30.agilent-bravo",[335,338,341,344],{"title":246,"path":336,"stem":337},"\u002Foperate\u002Fdevices\u002Fagilent-bravo\u002Ftip-handling","03.operate\u002F30.devices\u002F30.agilent-bravo\u002F10.tip-handling",{"title":238,"path":339,"stem":340},"\u002Foperate\u002Fdevices\u002Fagilent-bravo\u002Fbasic-pipetting","03.operate\u002F30.devices\u002F30.agilent-bravo\u002F20.basic-pipetting",{"title":171,"path":342,"stem":343},"\u002Foperate\u002Fdevices\u002Fagilent-bravo\u002Fliquid-classes","03.operate\u002F30.devices\u002F30.agilent-bravo\u002F25.liquid-classes",{"title":274,"path":345,"stem":346},"\u002Foperate\u002Fdevices\u002Fagilent-bravo\u002Fusing-the-gripper","03.operate\u002F30.devices\u002F30.agilent-bravo\u002F30.using-the-gripper",{"title":348,"path":349,"stem":350,"children":351,"page":42},"Tecan FluentControl","\u002Foperate\u002Fdevices\u002Ftecan-fluentcontrol","03.operate\u002F30.devices\u002F40.tecan-fluentcontrol",[352,356,360],{"title":353,"path":354,"stem":355},"Connect & Run a Method","\u002Foperate\u002Fdevices\u002Ftecan-fluentcontrol\u002Fconnect-and-run","03.operate\u002F30.devices\u002F40.tecan-fluentcontrol\u002F10.connect-and-run",{"title":357,"path":358,"stem":359},"Sending XML Commands","\u002Foperate\u002Fdevices\u002Ftecan-fluentcontrol\u002Fsending-xml-commands","03.operate\u002F30.devices\u002F40.tecan-fluentcontrol\u002F20.sending-xml-commands",{"title":361,"path":362,"stem":363},"Full Workflow Example","\u002Foperate\u002Fdevices\u002Ftecan-fluentcontrol\u002Ffull-workflow-example","03.operate\u002F30.devices\u002F40.tecan-fluentcontrol\u002F30.full-workflow-example",{"title":365,"path":366,"stem":367,"children":368,"page":42},"Device Guides","\u002Fdevice-guides","06.device-guides",[369,372,385,402,415],{"title":365,"path":370,"stem":371},"\u002Fdevice-guides\u002Foverview","06.device-guides\u002F00.overview",{"title":373,"path":374,"stem":375,"children":376,"page":42},"Incubation","\u002Fdevice-guides\u002Fincubation","06.device-guides\u002F20.incubation",[377,381],{"title":378,"path":379,"stem":380},"Inheco ODTC","\u002Fdevice-guides\u002Fincubation\u002Finheco-odtc","06.device-guides\u002F20.incubation\u002F10.inheco-odtc",{"title":382,"path":383,"stem":384},"Inheco SCILA","\u002Fdevice-guides\u002Fincubation\u002Finheco-scila","06.device-guides\u002F20.incubation\u002F20.inheco-scila",{"title":386,"path":387,"stem":388,"children":389,"page":42},"Heater-Shakers","\u002Fdevice-guides\u002Fheater-shakers","06.device-guides\u002F30.heater-shakers",[390,394,398],{"title":391,"path":392,"stem":393},"Inheco Thermoshake","\u002Fdevice-guides\u002Fheater-shakers\u002Finheco-thermoshake","06.device-guides\u002F30.heater-shakers\u002F10.inheco-thermoshake",{"title":395,"path":396,"stem":397},"QInstruments Bioshake","\u002Fdevice-guides\u002Fheater-shakers\u002Fqinstruments-bioshake","06.device-guides\u002F30.heater-shakers\u002F20.qinstruments-bioshake",{"title":399,"path":400,"stem":401},"QInstruments ColdPlate","\u002Fdevice-guides\u002Fheater-shakers\u002Fqinstruments-coldplate","06.device-guides\u002F30.heater-shakers\u002F30.qinstruments-coldplate",{"title":403,"path":404,"stem":405,"children":406,"page":42},"Readers","\u002Fdevice-guides\u002Freaders","06.device-guides\u002F40.readers",[407,411],{"title":408,"path":409,"stem":410},"Biotek Gen5","\u002Fdevice-guides\u002Freaders\u002Fbiotek-gen5","06.device-guides\u002F40.readers\u002F10.biotek-gen5",{"title":412,"path":413,"stem":414},"Biotek Synergy H1","\u002Fdevice-guides\u002Freaders\u002Fbiotek-synergy-h1","06.device-guides\u002F40.readers\u002F20.biotek-synergy-H1",{"title":416,"path":417,"stem":418,"children":419,"page":42},"Tilt & Turn","\u002Fdevice-guides\u002Ftilt-and-turn","06.device-guides\u002F50.tilt-and-turn",[420,424],{"title":421,"path":422,"stem":423},"TurnStation","\u002Fdevice-guides\u002Ftilt-and-turn\u002Fqinstruments-turnstation","06.device-guides\u002F50.tilt-and-turn\u002F10.qinstruments-turnstation",{"title":425,"path":426,"stem":427},"TiltStation","\u002Fdevice-guides\u002Ftilt-and-turn\u002Fqinstruments-tiltstation","06.device-guides\u002F50.tilt-and-turn\u002F20.qinstruments-tiltstation",{"title":429,"path":430,"stem":431,"children":432,"page":42},"Automate","\u002Fautomate","07.automate",[433,437,441,445,494],{"title":434,"path":435,"stem":436},"What is a workflow?","\u002Fautomate\u002Fwhat-is-a-workflow","07.automate\u002F00.what-is-a-workflow",{"title":438,"path":439,"stem":440},"Workflow template","\u002Fautomate\u002Fworkflow-template","07.automate\u002F05.workflow-template",{"title":442,"path":443,"stem":444},"Your First Workflow","\u002Fautomate\u002Fyour-first-workflow","07.automate\u002F08.your-first-workflow",{"title":94,"pages":446,"path":456,"stem":457,"children":458,"page":42},[447,448,449,450,451,452,453,454,455],"workflow","phase","step","runs","input","artifacts","logs","human-in-the-loop","error-handling","\u002Fautomate\u002Fconcepts","07.automate\u002F10.concepts",[459,463,467,471,475,479,483,487,491],{"title":460,"path":461,"stem":462},"Workflow","\u002Fautomate\u002Fconcepts\u002Fworkflow","07.automate\u002F10.concepts\u002F10.workflow",{"title":464,"path":465,"stem":466},"Phase","\u002Fautomate\u002Fconcepts\u002Fphase","07.automate\u002F10.concepts\u002F20.phase",{"title":468,"path":469,"stem":470},"Step","\u002Fautomate\u002Fconcepts\u002Fstep","07.automate\u002F10.concepts\u002F30.step",{"title":472,"path":473,"stem":474},"Runs","\u002Fautomate\u002Fconcepts\u002Fruns","07.automate\u002F10.concepts\u002F40.runs",{"title":476,"path":477,"stem":478},"Input","\u002Fautomate\u002Fconcepts\u002Finput","07.automate\u002F10.concepts\u002F50.input",{"title":480,"path":481,"stem":482},"Artifacts","\u002Fautomate\u002Fconcepts\u002Fartifacts","07.automate\u002F10.concepts\u002F60.artifacts",{"title":484,"path":485,"stem":486},"Logs","\u002Fautomate\u002Fconcepts\u002Flogs","07.automate\u002F10.concepts\u002F70.logs",{"title":488,"path":489,"stem":490},"Human in the Loop","\u002Fautomate\u002Fconcepts\u002Fhuman-in-the-loop","07.automate\u002F10.concepts\u002F80.human-in-the-loop",{"title":183,"path":492,"stem":493},"\u002Fautomate\u002Fconcepts\u002Ferror-handling","07.automate\u002F10.concepts\u002F90.error-handling",{"title":187,"path":495,"stem":496,"children":497,"page":42},"\u002Fautomate\u002Fguides","07.automate\u002F25.guides",[498,502,506,510,514,518,522,526],{"title":499,"path":500,"stem":501},"Deploy a workflow","\u002Fautomate\u002Fguides\u002Fdeploy-a-workflow","07.automate\u002F25.guides\u002F30.deploy-a-workflow",{"title":503,"path":504,"stem":505},"Run a workflow","\u002Fautomate\u002Fguides\u002Frun-a-workflow","07.automate\u002F25.guides\u002F35.run-a-workflow",{"title":507,"path":508,"stem":509},"CI\u002FCD for workflows","\u002Fautomate\u002Fguides\u002Fcicd-for-workflows","07.automate\u002F25.guides\u002F40.cicd-for-workflows",{"title":511,"path":512,"stem":513},"HITL basics","\u002Fautomate\u002Fguides\u002Fbasic-hitl","07.automate\u002F25.guides\u002F50.basic-hitl",{"title":515,"path":516,"stem":517},"Typed operator inputs","\u002Fautomate\u002Fguides\u002Ftyped-operator-inputs","07.automate\u002F25.guides\u002F55.typed-operator-inputs",{"title":519,"path":520,"stem":521},"Error recovery","\u002Fautomate\u002Fguides\u002Fbasic-error-handling","07.automate\u002F25.guides\u002F60.basic-error-handling",{"title":523,"path":524,"stem":525},"Advanced error handling","\u002Fautomate\u002Fguides\u002Fadvanced-error-handling","07.automate\u002F25.guides\u002F70.advanced-error-handling",{"title":527,"path":528,"stem":529},"Workflows REST API","\u002Fautomate\u002Fguides\u002Fworkflows-api","07.automate\u002F25.guides\u002F80.workflows-api",{"title":531,"path":532,"stem":533,"children":534,"page":42},"Observe","\u002Fobserve","08.observe",[535,539,555],{"title":536,"path":537,"stem":538},"Overview","\u002Fobserve\u002Foverview","08.observe\u002F10.overview",{"title":94,"path":540,"stem":541,"children":542,"page":42},"\u002Fobserve\u002Fconcepts","08.observe\u002F20.concepts",[543,547,551],{"title":544,"path":545,"stem":546},"Object Storage","\u002Fobserve\u002Fconcepts\u002Fstorage","08.observe\u002F20.concepts\u002F10.storage",{"title":548,"path":549,"stem":550},"Secrets","\u002Fobserve\u002Fconcepts\u002Fsecrets","08.observe\u002F20.concepts\u002F20.secrets",{"title":552,"path":553,"stem":554},"Data sources","\u002Fobserve\u002Fconcepts\u002Fdata-sources","08.observe\u002F20.concepts\u002F30.data-sources",{"title":187,"path":556,"stem":557,"children":558,"page":42},"\u002Fobserve\u002Fguides","08.observe\u002F30.guides",[559,563],{"title":560,"path":561,"stem":562},"File System Connector","\u002Fobserve\u002Fguides\u002Ffilesystem-connector","08.observe\u002F30.guides\u002F10.filesystem-connector",{"title":564,"path":565,"stem":566},"Building an ETL","\u002Fobserve\u002Fguides\u002Fbuilding-an-etl","08.observe\u002F30.guides\u002F20.building-an-etl",{"title":568,"path":569,"stem":570,"children":571,"page":42},"Technical Reference","\u002Ftechnical-reference","10.technical-reference",[572,576,580,592,603,614,624,635],{"title":573,"path":574,"stem":575},"Introduction","\u002Ftechnical-reference\u002Fplatform-blueprint","10.technical-reference\u002F00.platform-blueprint",{"title":577,"path":578,"stem":579},"REST API","\u002Ftechnical-reference\u002Frest-api","10.technical-reference\u002F01.rest-api",{"title":53,"path":581,"stem":582,"children":583,"page":42},"\u002Ftechnical-reference\u002Fgroundcontrol","10.technical-reference\u002F10.groundcontrol",[584,588],{"title":585,"path":586,"stem":587},"Install & Setup","\u002Ftechnical-reference\u002Fgroundcontrol\u002Finstall","10.technical-reference\u002F10.groundcontrol\u002F10.install",{"title":589,"path":590,"stem":591},"Changelog","\u002Ftechnical-reference\u002Fgroundcontrol\u002Fchangelog","10.technical-reference\u002F10.groundcontrol\u002F20.changelog",{"title":593,"path":594,"stem":595,"children":596,"page":42},"UniteLabs SDK","\u002Ftechnical-reference\u002Fpython-sdk","10.technical-reference\u002F20.python-sdk",[597,600],{"title":585,"path":598,"stem":599},"\u002Ftechnical-reference\u002Fpython-sdk\u002Finstall","10.technical-reference\u002F20.python-sdk\u002F10.install",{"title":589,"path":601,"stem":602},"\u002Ftechnical-reference\u002Fpython-sdk\u002Fchangelog","10.technical-reference\u002F20.python-sdk\u002F20.changelog",{"title":604,"path":605,"stem":606,"children":607,"page":42},"Liquid Handling SDK","\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk","10.technical-reference\u002F30.python-liquid-handling-sdk",[608,611],{"title":585,"path":609,"stem":610},"\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk\u002Finstall","10.technical-reference\u002F30.python-liquid-handling-sdk\u002F10.install",{"title":589,"path":612,"stem":613},"\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk\u002Fchangelog","10.technical-reference\u002F30.python-liquid-handling-sdk\u002F20.changelog",{"title":163,"path":615,"stem":616,"children":617,"page":42},"\u002Ftechnical-reference\u002Flabware","10.technical-reference\u002F40.labware",[618,621],{"title":585,"path":619,"stem":620},"\u002Ftechnical-reference\u002Flabware\u002Finstall","10.technical-reference\u002F40.labware\u002F10.install",{"title":589,"path":622,"stem":623},"\u002Ftechnical-reference\u002Flabware\u002Fchangelog","10.technical-reference\u002F40.labware\u002F20.changelog",{"title":625,"path":626,"stem":627,"children":628,"page":42},"Python Omnibus","\u002Ftechnical-reference\u002Fpython-omnibus","10.technical-reference\u002F50.python-omnibus",[629,632],{"title":585,"path":630,"stem":631},"\u002Ftechnical-reference\u002Fpython-omnibus\u002Finstall","10.technical-reference\u002F50.python-omnibus\u002F10.install",{"title":589,"path":633,"stem":634},"\u002Ftechnical-reference\u002Fpython-omnibus\u002Fchangelog","10.technical-reference\u002F50.python-omnibus\u002F20.changelog",{"title":636,"path":637,"stem":638,"children":639,"page":42},"Python CDK","\u002Ftechnical-reference\u002Fpython-cdk","10.technical-reference\u002F60.python-cdk",[640,643],{"title":585,"path":641,"stem":642},"\u002Ftechnical-reference\u002Fpython-cdk\u002Finstall","10.technical-reference\u002F60.python-cdk\u002F10.install",{"title":589,"path":644,"stem":645},"\u002Ftechnical-reference\u002Fpython-cdk\u002Fchangelog","10.technical-reference\u002F60.python-cdk\u002F20.changelog",{"title":647,"path":648,"stem":649,"children":650},"Connector Development (CDK)","\u002Fconnector-development","20.connector-development",[651,653,672,705,713,744],{"title":647,"path":648,"stem":652},"20.connector-development\u002Findex",{"title":654,"path":655,"stem":656,"children":657,"page":42},"Getting Started","\u002Fconnector-development\u002Fgetting-started","20.connector-development\u002F10.getting-started",[658,661,665,668],{"title":536,"path":659,"stem":660},"\u002Fconnector-development\u002Fgetting-started\u002Foverview","20.connector-development\u002F10.getting-started\u002F10.overview",{"title":662,"path":663,"stem":664},"What's new","\u002Fconnector-development\u002Fgetting-started\u002Fwhats-new","20.connector-development\u002F10.getting-started\u002F20.whats-new",{"title":77,"path":666,"stem":667},"\u002Fconnector-development\u002Fgetting-started\u002Finstallation","20.connector-development\u002F10.getting-started\u002F30.installation",{"title":669,"path":670,"stem":671},"Contributing","\u002Fconnector-development\u002Fgetting-started\u002Fcontributing","20.connector-development\u002F10.getting-started\u002F40.contributing",{"title":673,"path":674,"stem":675,"children":676,"page":42},"Tutorial","\u002Fconnector-development\u002Ftutorial","20.connector-development\u002F20.tutorial",[677,681,685,689,693,697,701],{"title":678,"path":679,"stem":680},"Walkthrough","\u002Fconnector-development\u002Ftutorial\u002Fwalkthrough","20.connector-development\u002F20.tutorial\u002F00.walkthrough",{"title":682,"path":683,"stem":684},"SiLA Endpoints","\u002Fconnector-development\u002Ftutorial\u002Fsila-endpoints","20.connector-development\u002F20.tutorial\u002F10.sila-endpoints",{"title":686,"path":687,"stem":688},"Data Endpoints","\u002Fconnector-development\u002Ftutorial\u002Fdata-endpoints","20.connector-development\u002F20.tutorial\u002F20.data-endpoints",{"title":690,"path":691,"stem":692},"Controls","\u002Fconnector-development\u002Ftutorial\u002Fcontrols","20.connector-development\u002F20.tutorial\u002F30.controls",{"title":694,"path":695,"stem":696},"SiLA Data Types","\u002Fconnector-development\u002Ftutorial\u002Fdata-types","20.connector-development\u002F20.tutorial\u002F40.data-types",{"title":698,"path":699,"stem":700},"Feature","\u002Fconnector-development\u002Ftutorial\u002Fconnector-structure","20.connector-development\u002F20.tutorial\u002F70.connector-structure",{"title":702,"path":703,"stem":704},"Hardware Communication","\u002Fconnector-development\u002Ftutorial\u002Fhardware-communication","20.connector-development\u002F20.tutorial\u002F90.hardware-communication",{"title":94,"path":706,"stem":707,"children":708,"page":42},"\u002Fconnector-development\u002Fconcepts","20.connector-development\u002F30.concepts",[709],{"title":710,"path":711,"stem":712},"SiLA","\u002Fconnector-development\u002Fconcepts\u002Fsila","20.connector-development\u002F30.concepts\u002Fsila",{"title":187,"path":714,"stem":715,"children":716,"page":42},"\u002Fconnector-development\u002Fguides","20.connector-development\u002F40.guides",[717,721,725,729,733,736,740],{"title":718,"path":719,"stem":720},"Configuration","\u002Fconnector-development\u002Fguides\u002Fconfiguration","20.connector-development\u002F40.guides\u002F20.configuration",{"title":722,"path":723,"stem":724},"Deployment","\u002Fconnector-development\u002Fguides\u002Fdeployment","20.connector-development\u002F40.guides\u002F30.deployment",{"title":726,"path":727,"stem":728},"Security","\u002Fconnector-development\u002Fguides\u002Fsecurity","20.connector-development\u002F40.guides\u002F40.security",{"title":730,"path":731,"stem":732},"Subscriptions","\u002Fconnector-development\u002Fguides\u002Fsubscriptions","20.connector-development\u002F40.guides\u002F45.subscriptions",{"title":183,"path":734,"stem":735},"\u002Fconnector-development\u002Fguides\u002Ferror-handling","20.connector-development\u002F40.guides\u002F50.error-handling",{"title":737,"path":738,"stem":739},"Serial Troubleshooting","\u002Fconnector-development\u002Fguides\u002Fserial-troubleshooting","20.connector-development\u002F40.guides\u002F70.serial-troubleshooting",{"title":741,"path":742,"stem":743},"Testing","\u002Fconnector-development\u002Fguides\u002Ftesting","20.connector-development\u002F40.guides\u002F80.testing",{"title":745,"path":746,"stem":747,"children":748},"References","\u002Fconnector-development\u002Freference","20.connector-development\u002F50.reference\u002Findex",[749],{"title":745,"path":746,"stem":747},{"id":751,"title":511,"body":752,"description":1792,"extension":1793,"links":1794,"meta":1795,"navigation":917,"path":512,"seo":1796,"stem":513,"__hash__":1797},"docs\u002F07.automate\u002F25.guides\u002F50.basic-hitl.md",{"type":753,"value":754,"toc":1782},"minimark",[755,764,789,795,814,819,825,836,844,848,855,1080,1090,1094,1097,1437,1459,1464,1470,1578,1582,1585,1601,1691,1701,1705,1714,1750,1757,1761,1778],[756,757,758,759,763],"p",{},"In this guide you will add human-in-the-loop (HITL) checkpoints to a workflow using the SDK's ",[760,761,762],"code",{},"operator_confirm()"," helper. When called, the run suspends completely — the process is idle, no resources are held — and only continues when an operator confirms via the UI or API.",[765,766,768],"callout",{"icon":767},"i-heroicons-information-circle",[756,769,770,771,774,775,778,779,782,783,785,786,788],{},"For ",[760,772,773],{},"unitelabs-sdk\u003C 0.10.0",", import ",[760,776,777],{},"flow"," and ",[760,780,781],{},"task"," from Prefect instead. Use ",[760,784,777],{}," in place of both workflow and phase decorators, and ",[760,787,781],{}," as step decorators.",[756,790,791],{},[792,793,794],"strong",{},"Prerequisites",[796,797,798,808],"ul",{},[799,800,801,802,807],"li",{},"A working workflow (see ",[803,804,806],"a",{"href":805},"\u002Fautomate\u002Fyour-first-workflow\u002F","Build your first workflow",")",[799,809,810,813],{},[760,811,812],{},"unitelabs-sdk[automate]"," installed",[815,816,818],"h2",{"id":817},"when-to-use-hitl","When to use HITL",[756,820,821,822,824],{},"Use ",[760,823,762],{}," when the workflow cannot safely proceed without a human action:",[796,826,827,830,833],{},[799,828,829],{},"An operator needs to physically load a plate before liquid handling begins",[799,831,832],{},"A supervisor needs to visually confirm instrument state before dispensing",[799,834,835],{},"An automatic check fails and a human needs to intervene before retrying",[756,837,838,839,843],{},"If you only need to notify someone without pausing execution, use ",[803,840,842],{"href":841},"\u002Fautomate\u002Fconcepts\u002Flogs\u002F","logging"," instead.",[815,845,847],{"id":846},"pattern-1-unconditional-checkpoint","Pattern 1 — Unconditional checkpoint",[756,849,850,851,854],{},"The simplest form: pause at a fixed point and wait for an operator to confirm before continuing. The message you pass is logged with an ",[760,852,853],{},"OPERATOR ACTION REQUIRED:"," prefix and shown to the operator — make it specific and actionable.",[856,857,862],"pre",{"className":858,"code":859,"language":860,"meta":861,"style":861},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","from unitelabs.sdk import operator_confirm\nfrom unitelabs.sdk.automate import phase\n\n\n@phase(name=\"Dispense Workflow\")\nasync def dispense_flow() -> dict:\n    # ... initialization and setup ...\n\n    # Checkpoint: operator confirms before dispensing begins\n    await operator_confirm(\n        \"Confirm that plate_1 is seated at ByonoyCarrier slot 1 \"\n        \"before dispensing, then click Resume.\"\n    )\n\n    # ... dispensing logic ...\n    return {\"status\": \"success\"}\n","python","",[760,863,864,890,912,919,924,955,981,988,993,999,1011,1023,1033,1039,1044,1050],{"__ignoreMap":861},[865,866,869,873,877,881,884,887],"span",{"class":867,"line":868},"line",1,[865,870,872],{"class":871},"s7zQu","from",[865,874,876],{"class":875},"sTEyZ"," unitelabs",[865,878,880],{"class":879},"sMK4o",".",[865,882,883],{"class":875},"sdk ",[865,885,886],{"class":871},"import",[865,888,889],{"class":875}," operator_confirm\n",[865,891,893,895,897,899,902,904,907,909],{"class":867,"line":892},2,[865,894,872],{"class":871},[865,896,876],{"class":875},[865,898,880],{"class":879},[865,900,901],{"class":875},"sdk",[865,903,880],{"class":879},[865,905,906],{"class":875},"automate ",[865,908,886],{"class":871},[865,910,911],{"class":875}," phase\n",[865,913,915],{"class":867,"line":914},3,[865,916,918],{"emptyLinePlaceholder":917},true,"\n",[865,920,922],{"class":867,"line":921},4,[865,923,918],{"emptyLinePlaceholder":917},[865,925,927,930,933,936,940,943,946,950,952],{"class":867,"line":926},5,[865,928,929],{"class":879},"@",[865,931,448],{"class":932},"s2Zo4",[865,934,935],{"class":879},"(",[865,937,939],{"class":938},"sHdIc","name",[865,941,942],{"class":879},"=",[865,944,945],{"class":879},"\"",[865,947,949],{"class":948},"sfazB","Dispense Workflow",[865,951,945],{"class":879},[865,953,954],{"class":879},")\n",[865,956,958,962,965,968,971,974,978],{"class":867,"line":957},6,[865,959,961],{"class":960},"spNyl","async",[865,963,964],{"class":960}," def",[865,966,967],{"class":932}," dispense_flow",[865,969,970],{"class":879},"()",[865,972,973],{"class":879}," ->",[865,975,977],{"class":976},"sBMFI"," dict",[865,979,980],{"class":879},":\n",[865,982,984],{"class":867,"line":983},7,[865,985,987],{"class":986},"sHwdD","    # ... initialization and setup ...\n",[865,989,991],{"class":867,"line":990},8,[865,992,918],{"emptyLinePlaceholder":917},[865,994,996],{"class":867,"line":995},9,[865,997,998],{"class":986},"    # Checkpoint: operator confirms before dispensing begins\n",[865,1000,1002,1005,1008],{"class":867,"line":1001},10,[865,1003,1004],{"class":871},"    await",[865,1006,1007],{"class":932}," operator_confirm",[865,1009,1010],{"class":879},"(\n",[865,1012,1014,1017,1020],{"class":867,"line":1013},11,[865,1015,1016],{"class":879},"        \"",[865,1018,1019],{"class":948},"Confirm that plate_1 is seated at ByonoyCarrier slot 1 ",[865,1021,1022],{"class":879},"\"\n",[865,1024,1026,1028,1031],{"class":867,"line":1025},12,[865,1027,1016],{"class":879},[865,1029,1030],{"class":948},"before dispensing, then click Resume.",[865,1032,1022],{"class":879},[865,1034,1036],{"class":867,"line":1035},13,[865,1037,1038],{"class":879},"    )\n",[865,1040,1042],{"class":867,"line":1041},14,[865,1043,918],{"emptyLinePlaceholder":917},[865,1045,1047],{"class":867,"line":1046},15,[865,1048,1049],{"class":986},"    # ... dispensing logic ...\n",[865,1051,1053,1056,1059,1061,1064,1066,1069,1072,1075,1077],{"class":867,"line":1052},16,[865,1054,1055],{"class":871},"    return",[865,1057,1058],{"class":879}," {",[865,1060,945],{"class":879},[865,1062,1063],{"class":948},"status",[865,1065,945],{"class":879},[865,1067,1068],{"class":879},":",[865,1070,1071],{"class":879}," \"",[865,1073,1074],{"class":948},"success",[865,1076,945],{"class":879},[865,1078,1079],{"class":879},"}\n",[756,1081,1082,1083,1085,1086,1089],{},"When the flow reaches ",[760,1084,762],{},", the run transitions to ",[760,1087,1088],{},"AWAITING_INPUT"," and the platform shows a confirm-and-resume control. The operator resumes it from the platform UI or via the API.",[815,1091,1093],{"id":1092},"pattern-2-conditional-pause-on-failure","Pattern 2 — Conditional pause on failure",[756,1095,1096],{},"A more powerful pattern: catch a failure, pause for the operator to fix it, then retry the failed step on resume. This is the standard approach for transient physical errors — a plate out of position, a sensor misfiring, a gripper not gripping cleanly.",[856,1098,1100],{"className":858,"code":1099,"language":860,"meta":861,"style":861},"from unitelabs.sdk import operator_confirm\nfrom unitelabs.sdk.automate import phase\n\n\nclass PlateNotDetectedError(Exception):\n    pass\n\n\nasync def detect_plate(carrier_id: str) -> dict:\n    \"\"\"Returns detection result or raises PlateNotDetectedError.\"\"\"\n    ...\n\n\n@phase(name=\"Detection with HITL Recovery\")\nasync def detection_flow(carrier_id: str) -> dict:\n    try:\n        result = await detect_plate(carrier_id=carrier_id)\n    except PlateNotDetectedError:\n        # Pause — operator physically fixes the plate and confirms; retry on resume\n        await operator_confirm(\n            f\"No plate detected at {carrier_id} slot 1. \"\n            \"Check that the plate is fully seated, then click Resume.\"\n        )\n        result = await detect_plate(carrier_id=carrier_id)\n\n    return {\"status\": \"success\", \"target_slot\": result[\"slot\"]}\n",[760,1101,1102,1116,1134,1138,1142,1158,1163,1167,1171,1198,1209,1214,1218,1222,1243,1268,1275,1298,1308,1314,1324,1345,1356,1362,1383,1388],{"__ignoreMap":861},[865,1103,1104,1106,1108,1110,1112,1114],{"class":867,"line":868},[865,1105,872],{"class":871},[865,1107,876],{"class":875},[865,1109,880],{"class":879},[865,1111,883],{"class":875},[865,1113,886],{"class":871},[865,1115,889],{"class":875},[865,1117,1118,1120,1122,1124,1126,1128,1130,1132],{"class":867,"line":892},[865,1119,872],{"class":871},[865,1121,876],{"class":875},[865,1123,880],{"class":879},[865,1125,901],{"class":875},[865,1127,880],{"class":879},[865,1129,906],{"class":875},[865,1131,886],{"class":871},[865,1133,911],{"class":875},[865,1135,1136],{"class":867,"line":914},[865,1137,918],{"emptyLinePlaceholder":917},[865,1139,1140],{"class":867,"line":921},[865,1141,918],{"emptyLinePlaceholder":917},[865,1143,1144,1147,1150,1152,1155],{"class":867,"line":926},[865,1145,1146],{"class":960},"class",[865,1148,1149],{"class":976}," PlateNotDetectedError",[865,1151,935],{"class":879},[865,1153,1154],{"class":976},"Exception",[865,1156,1157],{"class":879},"):\n",[865,1159,1160],{"class":867,"line":957},[865,1161,1162],{"class":871},"    pass\n",[865,1164,1165],{"class":867,"line":983},[865,1166,918],{"emptyLinePlaceholder":917},[865,1168,1169],{"class":867,"line":990},[865,1170,918],{"emptyLinePlaceholder":917},[865,1172,1173,1175,1177,1180,1182,1185,1187,1190,1192,1194,1196],{"class":867,"line":995},[865,1174,961],{"class":960},[865,1176,964],{"class":960},[865,1178,1179],{"class":932}," detect_plate",[865,1181,935],{"class":879},[865,1183,1184],{"class":938},"carrier_id",[865,1186,1068],{"class":879},[865,1188,1189],{"class":976}," str",[865,1191,807],{"class":879},[865,1193,973],{"class":879},[865,1195,977],{"class":976},[865,1197,980],{"class":879},[865,1199,1200,1203,1206],{"class":867,"line":1001},[865,1201,1202],{"class":871},"    \"\"\"",[865,1204,1205],{"class":986},"Returns detection result or raises PlateNotDetectedError.",[865,1207,1208],{"class":871},"\"\"\"\n",[865,1210,1211],{"class":867,"line":1013},[865,1212,1213],{"class":875},"    ...\n",[865,1215,1216],{"class":867,"line":1025},[865,1217,918],{"emptyLinePlaceholder":917},[865,1219,1220],{"class":867,"line":1035},[865,1221,918],{"emptyLinePlaceholder":917},[865,1223,1224,1226,1228,1230,1232,1234,1236,1239,1241],{"class":867,"line":1041},[865,1225,929],{"class":879},[865,1227,448],{"class":932},[865,1229,935],{"class":879},[865,1231,939],{"class":938},[865,1233,942],{"class":879},[865,1235,945],{"class":879},[865,1237,1238],{"class":948},"Detection with HITL Recovery",[865,1240,945],{"class":879},[865,1242,954],{"class":879},[865,1244,1245,1247,1249,1252,1254,1256,1258,1260,1262,1264,1266],{"class":867,"line":1046},[865,1246,961],{"class":960},[865,1248,964],{"class":960},[865,1250,1251],{"class":932}," detection_flow",[865,1253,935],{"class":879},[865,1255,1184],{"class":938},[865,1257,1068],{"class":879},[865,1259,1189],{"class":976},[865,1261,807],{"class":879},[865,1263,973],{"class":879},[865,1265,977],{"class":976},[865,1267,980],{"class":879},[865,1269,1270,1273],{"class":867,"line":1052},[865,1271,1272],{"class":871},"    try",[865,1274,980],{"class":879},[865,1276,1278,1281,1283,1286,1288,1290,1292,1294,1296],{"class":867,"line":1277},17,[865,1279,1280],{"class":875},"        result ",[865,1282,942],{"class":879},[865,1284,1285],{"class":871}," await",[865,1287,1179],{"class":932},[865,1289,935],{"class":879},[865,1291,1184],{"class":938},[865,1293,942],{"class":879},[865,1295,1184],{"class":932},[865,1297,954],{"class":879},[865,1299,1301,1304,1306],{"class":867,"line":1300},18,[865,1302,1303],{"class":871},"    except",[865,1305,1149],{"class":875},[865,1307,980],{"class":879},[865,1309,1311],{"class":867,"line":1310},19,[865,1312,1313],{"class":986},"        # Pause — operator physically fixes the plate and confirms; retry on resume\n",[865,1315,1317,1320,1322],{"class":867,"line":1316},20,[865,1318,1319],{"class":871},"        await",[865,1321,1007],{"class":932},[865,1323,1010],{"class":879},[865,1325,1327,1330,1333,1337,1339,1342],{"class":867,"line":1326},21,[865,1328,1329],{"class":960},"            f",[865,1331,1332],{"class":948},"\"No plate detected at ",[865,1334,1336],{"class":1335},"sbssI","{",[865,1338,1184],{"class":932},[865,1340,1341],{"class":1335},"}",[865,1343,1344],{"class":948}," slot 1. \"\n",[865,1346,1348,1351,1354],{"class":867,"line":1347},22,[865,1349,1350],{"class":879},"            \"",[865,1352,1353],{"class":948},"Check that the plate is fully seated, then click Resume.",[865,1355,1022],{"class":879},[865,1357,1359],{"class":867,"line":1358},23,[865,1360,1361],{"class":879},"        )\n",[865,1363,1365,1367,1369,1371,1373,1375,1377,1379,1381],{"class":867,"line":1364},24,[865,1366,1280],{"class":875},[865,1368,942],{"class":879},[865,1370,1285],{"class":871},[865,1372,1179],{"class":932},[865,1374,935],{"class":879},[865,1376,1184],{"class":938},[865,1378,942],{"class":879},[865,1380,1184],{"class":932},[865,1382,954],{"class":879},[865,1384,1386],{"class":867,"line":1385},25,[865,1387,918],{"emptyLinePlaceholder":917},[865,1389,1391,1393,1395,1397,1399,1401,1403,1405,1407,1409,1412,1414,1417,1419,1421,1424,1427,1429,1432,1434],{"class":867,"line":1390},26,[865,1392,1055],{"class":871},[865,1394,1058],{"class":879},[865,1396,945],{"class":879},[865,1398,1063],{"class":948},[865,1400,945],{"class":879},[865,1402,1068],{"class":879},[865,1404,1071],{"class":879},[865,1406,1074],{"class":948},[865,1408,945],{"class":879},[865,1410,1411],{"class":879},",",[865,1413,1071],{"class":879},[865,1415,1416],{"class":948},"target_slot",[865,1418,945],{"class":879},[865,1420,1068],{"class":879},[865,1422,1423],{"class":875}," result",[865,1425,1426],{"class":879},"[",[865,1428,945],{"class":879},[865,1430,1431],{"class":948},"slot",[865,1433,945],{"class":879},[865,1435,1436],{"class":879},"]}\n",[765,1438,1440],{"icon":1439},"i-heroicons-exclamation-triangle",[756,1441,1442,1444,1445,1448,1449,1455,1456,1458],{},[760,1443,762],{}," (like the ",[760,1446,1447],{},"pause_flow_run()"," it wraps) must be called from the ",[792,1450,1451,1452],{},"top-level ",[760,1453,1454],{},"@phase",", not from inside a nested sub-flow. Prefect does not support pausing from within a child ",[760,1457,1454],{},". If your detection logic lives in a sub-flow, catch the exception at the top level before pausing.",[1460,1461,1463],"h3",{"id":1462},"chaining-multiple-checkpoints","Chaining multiple checkpoints",[756,1465,1466,1467,1469],{},"For multi-step operator interactions, call ",[760,1468,762],{}," at each checkpoint in sequence:",[856,1471,1473],{"className":858,"code":1472,"language":860,"meta":861,"style":861},"@phase(name=\"Multi-Step HITL\")\nasync def multi_step_flow() -> dict:\n    await operator_confirm(\"Step 1\u002F2: Load tip boxes and reservoir. Click Resume when ready.\")\n    await operator_confirm(\"Step 2\u002F2: Load sample plate at slot 1. Click Resume to start.\")\n\n    # ... instrument logic ...\n    return {\"status\": \"success\"}\n",[760,1474,1475,1496,1513,1530,1547,1551,1556],{"__ignoreMap":861},[865,1476,1477,1479,1481,1483,1485,1487,1489,1492,1494],{"class":867,"line":868},[865,1478,929],{"class":879},[865,1480,448],{"class":932},[865,1482,935],{"class":879},[865,1484,939],{"class":938},[865,1486,942],{"class":879},[865,1488,945],{"class":879},[865,1490,1491],{"class":948},"Multi-Step HITL",[865,1493,945],{"class":879},[865,1495,954],{"class":879},[865,1497,1498,1500,1502,1505,1507,1509,1511],{"class":867,"line":892},[865,1499,961],{"class":960},[865,1501,964],{"class":960},[865,1503,1504],{"class":932}," multi_step_flow",[865,1506,970],{"class":879},[865,1508,973],{"class":879},[865,1510,977],{"class":976},[865,1512,980],{"class":879},[865,1514,1515,1517,1519,1521,1523,1526,1528],{"class":867,"line":914},[865,1516,1004],{"class":871},[865,1518,1007],{"class":932},[865,1520,935],{"class":879},[865,1522,945],{"class":879},[865,1524,1525],{"class":948},"Step 1\u002F2: Load tip boxes and reservoir. Click Resume when ready.",[865,1527,945],{"class":879},[865,1529,954],{"class":879},[865,1531,1532,1534,1536,1538,1540,1543,1545],{"class":867,"line":921},[865,1533,1004],{"class":871},[865,1535,1007],{"class":932},[865,1537,935],{"class":879},[865,1539,945],{"class":879},[865,1541,1542],{"class":948},"Step 2\u002F2: Load sample plate at slot 1. Click Resume to start.",[865,1544,945],{"class":879},[865,1546,954],{"class":879},[865,1548,1549],{"class":867,"line":926},[865,1550,918],{"emptyLinePlaceholder":917},[865,1552,1553],{"class":867,"line":957},[865,1554,1555],{"class":986},"    # ... instrument logic ...\n",[865,1557,1558,1560,1562,1564,1566,1568,1570,1572,1574,1576],{"class":867,"line":983},[865,1559,1055],{"class":871},[865,1561,1058],{"class":879},[865,1563,945],{"class":879},[865,1565,1063],{"class":948},[865,1567,945],{"class":879},[865,1569,1068],{"class":879},[865,1571,1071],{"class":879},[865,1573,1074],{"class":948},[865,1575,945],{"class":879},[865,1577,1079],{"class":879},[815,1579,1581],{"id":1580},"pattern-3-resume-via-api","Pattern 3 — Resume via API",[756,1583,1584],{},"An operator does not need to be watching the platform UI. Any system that can call the API can resume a paused run.",[756,1586,1587,1589,1590,1592,1593,1596,1597,1600],{},[760,1588,762],{}," puts the run in ",[760,1591,1088],{},", so resume it by submitting the confirmation (its ",[760,1594,1595],{},"confirmed"," field defaults to ",[760,1598,1599],{},"true",") keyed by the waiting phase ID:",[856,1602,1606],{"className":1603,"code":1604,"language":1605,"meta":861,"style":861},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -X POST \"$BASE_URL\u002Fv1\u002Fruns\u002F{runId}\u002Fstatus\" \\\n  -H \"Authorization: Bearer $TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"status\": \"RUNNING\",\n    \"data\": { \"phase-abc-123\": { \"confirmed\": true } }\n  }'\n","bash",[760,1607,1608,1632,1649,1662,1673,1678,1683],{"__ignoreMap":861},[865,1609,1610,1613,1616,1619,1621,1624,1627,1629],{"class":867,"line":868},[865,1611,1612],{"class":976},"curl",[865,1614,1615],{"class":948}," -X",[865,1617,1618],{"class":948}," POST",[865,1620,1071],{"class":879},[865,1622,1623],{"class":875},"$BASE_URL",[865,1625,1626],{"class":948},"\u002Fv1\u002Fruns\u002F{runId}\u002Fstatus",[865,1628,945],{"class":879},[865,1630,1631],{"class":875}," \\\n",[865,1633,1634,1637,1639,1642,1645,1647],{"class":867,"line":892},[865,1635,1636],{"class":948},"  -H",[865,1638,1071],{"class":879},[865,1640,1641],{"class":948},"Authorization: Bearer ",[865,1643,1644],{"class":875},"$TOKEN",[865,1646,945],{"class":879},[865,1648,1631],{"class":875},[865,1650,1651,1653,1655,1658,1660],{"class":867,"line":914},[865,1652,1636],{"class":948},[865,1654,1071],{"class":879},[865,1656,1657],{"class":948},"Content-Type: application\u002Fjson",[865,1659,945],{"class":879},[865,1661,1631],{"class":875},[865,1663,1664,1667,1670],{"class":867,"line":921},[865,1665,1666],{"class":948},"  -d",[865,1668,1669],{"class":879}," '",[865,1671,1672],{"class":948},"{\n",[865,1674,1675],{"class":867,"line":926},[865,1676,1677],{"class":948},"    \"status\": \"RUNNING\",\n",[865,1679,1680],{"class":867,"line":957},[865,1681,1682],{"class":948},"    \"data\": { \"phase-abc-123\": { \"confirmed\": true } }\n",[865,1684,1685,1688],{"class":867,"line":983},[865,1686,1687],{"class":948},"  }",[865,1689,1690],{"class":879},"'\n",[756,1692,1693,1694,1696,1697,1700],{},"Look up the phase ID from the run's status response (the ",[760,1695,451],{}," field). See ",[803,1698,515],{"href":1699},"\u002Fautomate\u002Fguides\u002Ftyped-operator-inputs\u002F"," for the full resume-with-data flow. This lets you build operator-facing tools — a lab dashboard, a mobile approval screen, a Slack button — that resume the run when a human clicks confirm.",[815,1702,1704],{"id":1703},"handling-timeouts","Handling timeouts",[756,1706,1707,1709,1710,1713],{},[760,1708,762],{}," defaults to a one-hour timeout. Pass ",[760,1711,1712],{},"timeout="," (seconds) to fail the run cleanly if the operator never responds, rather than leaving it paused indefinitely:",[856,1715,1717],{"className":858,"code":1716,"language":860,"meta":861,"style":861},"await operator_confirm(\"Load plate at slot 1, then resume.\", timeout=600)  # fails after 10 minutes\n",[760,1718,1719],{"__ignoreMap":861},[865,1720,1721,1724,1726,1728,1730,1733,1735,1737,1740,1742,1745,1747],{"class":867,"line":868},[865,1722,1723],{"class":871},"await",[865,1725,1007],{"class":932},[865,1727,935],{"class":879},[865,1729,945],{"class":879},[865,1731,1732],{"class":948},"Load plate at slot 1, then resume.",[865,1734,945],{"class":879},[865,1736,1411],{"class":879},[865,1738,1739],{"class":938}," timeout",[865,1741,942],{"class":879},[865,1743,1744],{"class":1335},"600",[865,1746,807],{"class":879},[865,1748,1749],{"class":986},"  # fails after 10 minutes\n",[756,1751,1752,1753,1756],{},"A timed-out pause transitions the run to ",[760,1754,1755],{},"FAILED"," with a clear message in the logs — easier to debug than a run that is silently stuck.",[815,1758,1760],{"id":1759},"next-steps","Next steps",[796,1762,1763,1772],{},[799,1764,1765,1767,1768,1771],{},[803,1766,515],{"href":1699},": collect structured data — not just a confirmation — with a ",[760,1769,1770],{},"RunInput"," model",[799,1773,1774,1777],{},[803,1775,519],{"href":1776},"\u002Fautomate\u002Fguides\u002Fbasic-error-handling\u002F",": clean up hardware state and retry after failure",[1779,1780,1781],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":861,"searchDepth":868,"depth":892,"links":1783},[1784,1785,1786,1789,1790,1791],{"id":817,"depth":892,"text":818},{"id":846,"depth":892,"text":847},{"id":1092,"depth":892,"text":1093,"children":1787},[1788],{"id":1462,"depth":914,"text":1463},{"id":1580,"depth":892,"text":1581},{"id":1703,"depth":892,"text":1704},{"id":1759,"depth":892,"text":1760},"Pause a workflow run so an operator can take a physical action, then resume automatically.","md",null,{},{"title":511,"description":1792},"O45grxrLvaVcmCydxW6eSZsPpXHEkE6fw82CAmfs8Vo",[1799,1801],{"title":507,"path":508,"stem":509,"description":1800},"Automate workflow deploys to UniteLabs with three channels — DEV (manual), STG (push to main), PRD (per-workflow release tags) — on GitHub Actions or GitLab CI.",{"title":515,"path":516,"stem":517,"description":1802},"Collect structured data from operators at runtime using a RunInput model — enums, booleans, numbers, and text fields rendered as a platform form.",1783607790084]