[{"data":1,"prerenderedAt":2805},["ShallowReactive",2],{"navigation":3,"\u002Fautomate\u002Fguides\u002Fbasic-error-handling":750,"\u002Fautomate\u002Fguides\u002Fbasic-error-handling-surround":2800},[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":519,"body":752,"description":2794,"extension":2795,"links":2796,"meta":2797,"navigation":894,"path":520,"seo":2798,"stem":521,"__hash__":2799},"docs\u002F07.automate\u002F25.guides\u002F60.basic-error-handling.md",{"type":753,"value":754,"toc":2785},"minimark",[755,759,762,788,794,807,810,818,832,1195,1206,1210,1228,1450,1455,1579,1589,1593,1604,2010,2025,2029,2032,2520,2527,2529,2533,2536,2587,2756,2762,2766,2781],[756,757,758],"p",{},"In lab automation, an error mid-run can leave hardware in an inconsistent state — tips are still loaded, a plate is mid-transfer, a gripper is holding something. Error recovery means: clean up first, then decide whether to retry or abort.",[756,760,761],{},"This guide covers four practical patterns. They compose well — most real workflows use two or three of them together.",[763,764,766],"callout",{"icon":765},"i-heroicons-information-circle",[756,767,768,769,773,774,777,778,781,782,784,785,787],{},"For ",[770,771,772],"code",{},"unitelabs-sdk\u003C 0.10.0",", import ",[770,775,776],{},"flow"," and ",[770,779,780],{},"task"," from Prefect instead. Use ",[770,783,776],{}," in place of both workflow and phase decorators, and ",[770,786,780],{}," as step decorators.",[756,789,790],{},[791,792,793],"strong",{},"Prerequisites",[795,796,797],"ul",{},[798,799,800,801,806],"li",{},"A working workflow (see ",[802,803,805],"a",{"href":804},"\u002Fautomate\u002Fyour-first-workflow\u002F","Build your first workflow",")",[808,809],"hr",{},[811,812,814,815],"h2",{"id":813},"pattern-1-guaranteed-cleanup-with-tryfinally","Pattern 1 — Guaranteed cleanup with ",[770,816,817],{},"try\u002Ffinally",[756,819,820,821,823,824,827,828,831],{},"Use ",[770,822,817],{}," to ensure hardware is left in a safe state even when an operation fails. The ",[770,825,826],{},"finally"," block always executes — whether the ",[770,829,830],{},"try"," body succeeds, raises, or is cancelled.",[833,834,839],"pre",{"className":835,"code":836,"language":837,"meta":838,"style":838},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","from unitelabs.sdk import get_logger\nfrom unitelabs.sdk.automate import phase\n\n\n@phase(log_prints=True, name=\"Dispensing Phase\")\nasync def dispensing_phase(lh) -> dict:\n    logger = get_logger()\n    try:\n        lh = await distribute_colour(lh=lh, reservoir=\"ice\", volume=100.0)\n        lh = await distribute_colour(lh=lh, reservoir=\"orange\", volume=100.0)\n    finally:\n        # Always return tips to the rack — even if distribute raises.\n        # This runs on success, exception, and Prefect cancellation.\n        lh = await return_tips(lh=lh)\n        logger.info(\"Tips returned.\")\n\n    return {\"lh\": lh, \"status\": \"success\"}\n","python","",[770,840,841,867,889,896,901,938,968,982,990,1040,1082,1090,1097,1103,1125,1147,1152],{"__ignoreMap":838},[842,843,846,850,854,858,861,864],"span",{"class":844,"line":845},"line",1,[842,847,849],{"class":848},"s7zQu","from",[842,851,853],{"class":852},"sTEyZ"," unitelabs",[842,855,857],{"class":856},"sMK4o",".",[842,859,860],{"class":852},"sdk ",[842,862,863],{"class":848},"import",[842,865,866],{"class":852}," get_logger\n",[842,868,870,872,874,876,879,881,884,886],{"class":844,"line":869},2,[842,871,849],{"class":848},[842,873,853],{"class":852},[842,875,857],{"class":856},[842,877,878],{"class":852},"sdk",[842,880,857],{"class":856},[842,882,883],{"class":852},"automate ",[842,885,863],{"class":848},[842,887,888],{"class":852}," phase\n",[842,890,892],{"class":844,"line":891},3,[842,893,895],{"emptyLinePlaceholder":894},true,"\n",[842,897,899],{"class":844,"line":898},4,[842,900,895],{"emptyLinePlaceholder":894},[842,902,904,907,910,913,917,920,923,926,929,933,935],{"class":844,"line":903},5,[842,905,906],{"class":856},"@",[842,908,448],{"class":909},"s2Zo4",[842,911,912],{"class":856},"(",[842,914,916],{"class":915},"sHdIc","log_prints",[842,918,919],{"class":856},"=True,",[842,921,922],{"class":915}," name",[842,924,925],{"class":856},"=",[842,927,928],{"class":856},"\"",[842,930,932],{"class":931},"sfazB","Dispensing Phase",[842,934,928],{"class":856},[842,936,937],{"class":856},")\n",[842,939,941,945,948,951,953,956,958,961,965],{"class":844,"line":940},6,[842,942,944],{"class":943},"spNyl","async",[842,946,947],{"class":943}," def",[842,949,950],{"class":909}," dispensing_phase",[842,952,912],{"class":856},[842,954,955],{"class":915},"lh",[842,957,806],{"class":856},[842,959,960],{"class":856}," ->",[842,962,964],{"class":963},"sBMFI"," dict",[842,966,967],{"class":856},":\n",[842,969,971,974,976,979],{"class":844,"line":970},7,[842,972,973],{"class":852},"    logger ",[842,975,925],{"class":856},[842,977,978],{"class":909}," get_logger",[842,980,981],{"class":856},"()\n",[842,983,985,988],{"class":844,"line":984},8,[842,986,987],{"class":848},"    try",[842,989,967],{"class":856},[842,991,993,996,998,1001,1004,1006,1008,1010,1012,1015,1018,1020,1022,1025,1027,1029,1032,1034,1038],{"class":844,"line":992},9,[842,994,995],{"class":852},"        lh ",[842,997,925],{"class":856},[842,999,1000],{"class":848}," await",[842,1002,1003],{"class":909}," distribute_colour",[842,1005,912],{"class":856},[842,1007,955],{"class":915},[842,1009,925],{"class":856},[842,1011,955],{"class":909},[842,1013,1014],{"class":856},",",[842,1016,1017],{"class":915}," reservoir",[842,1019,925],{"class":856},[842,1021,928],{"class":856},[842,1023,1024],{"class":931},"ice",[842,1026,928],{"class":856},[842,1028,1014],{"class":856},[842,1030,1031],{"class":915}," volume",[842,1033,925],{"class":856},[842,1035,1037],{"class":1036},"sbssI","100.0",[842,1039,937],{"class":856},[842,1041,1043,1045,1047,1049,1051,1053,1055,1057,1059,1061,1063,1065,1067,1070,1072,1074,1076,1078,1080],{"class":844,"line":1042},10,[842,1044,995],{"class":852},[842,1046,925],{"class":856},[842,1048,1000],{"class":848},[842,1050,1003],{"class":909},[842,1052,912],{"class":856},[842,1054,955],{"class":915},[842,1056,925],{"class":856},[842,1058,955],{"class":909},[842,1060,1014],{"class":856},[842,1062,1017],{"class":915},[842,1064,925],{"class":856},[842,1066,928],{"class":856},[842,1068,1069],{"class":931},"orange",[842,1071,928],{"class":856},[842,1073,1014],{"class":856},[842,1075,1031],{"class":915},[842,1077,925],{"class":856},[842,1079,1037],{"class":1036},[842,1081,937],{"class":856},[842,1083,1085,1088],{"class":844,"line":1084},11,[842,1086,1087],{"class":848},"    finally",[842,1089,967],{"class":856},[842,1091,1093],{"class":844,"line":1092},12,[842,1094,1096],{"class":1095},"sHwdD","        # Always return tips to the rack — even if distribute raises.\n",[842,1098,1100],{"class":844,"line":1099},13,[842,1101,1102],{"class":1095},"        # This runs on success, exception, and Prefect cancellation.\n",[842,1104,1106,1108,1110,1112,1115,1117,1119,1121,1123],{"class":844,"line":1105},14,[842,1107,995],{"class":852},[842,1109,925],{"class":856},[842,1111,1000],{"class":848},[842,1113,1114],{"class":909}," return_tips",[842,1116,912],{"class":856},[842,1118,955],{"class":915},[842,1120,925],{"class":856},[842,1122,955],{"class":909},[842,1124,937],{"class":856},[842,1126,1128,1131,1133,1136,1138,1140,1143,1145],{"class":844,"line":1127},15,[842,1129,1130],{"class":852},"        logger",[842,1132,857],{"class":856},[842,1134,1135],{"class":909},"info",[842,1137,912],{"class":856},[842,1139,928],{"class":856},[842,1141,1142],{"class":931},"Tips returned.",[842,1144,928],{"class":856},[842,1146,937],{"class":856},[842,1148,1150],{"class":844,"line":1149},16,[842,1151,895],{"emptyLinePlaceholder":894},[842,1153,1155,1158,1161,1163,1165,1167,1170,1173,1175,1178,1181,1183,1185,1187,1190,1192],{"class":844,"line":1154},17,[842,1156,1157],{"class":848},"    return",[842,1159,1160],{"class":856}," {",[842,1162,928],{"class":856},[842,1164,955],{"class":931},[842,1166,928],{"class":856},[842,1168,1169],{"class":856},":",[842,1171,1172],{"class":852}," lh",[842,1174,1014],{"class":856},[842,1176,1177],{"class":856}," \"",[842,1179,1180],{"class":931},"status",[842,1182,928],{"class":856},[842,1184,1169],{"class":856},[842,1186,1177],{"class":856},[842,1188,1189],{"class":931},"success",[842,1191,928],{"class":856},[842,1193,1194],{"class":856},"}\n",[756,1196,1197,1202,1203,1205],{},[791,1198,820,1199,1201],{},[770,1200,826],{}," for any action that must happen regardless of outcome:"," returning tips, closing connections, unlocking an instrument, setting a status flag. Do not use it for logic that should only run on success — put that in the ",[770,1204,830],{}," body.",[811,1207,1209],{"id":1208},"pattern-2-automatic-retry-with-delay","Pattern 2 — Automatic retry with delay",[756,1211,1212,1213,777,1216,1219,1220,1223,1224,1227],{},"Add ",[770,1214,1215],{},"retries",[770,1217,1218],{},"retry_delay_seconds"," to a ",[770,1221,1222],{},"@phase"," or ",[770,1225,1226],{},"@step"," to have the SDK automatically re-run it when an unhandled exception escapes. This is ideal for transient hardware failures — a gripper that occasionally mis-grips, a sensor that times out under load.",[833,1229,1231],{"className":835,"code":1230,"language":837,"meta":838,"style":838},"from unitelabs.sdk.automate import phase\n\n\n@phase(\n    log_prints=True,\n    name=\"Return Plate Phase\",\n    retries=1,\n    retry_delay_seconds=60,\n)\nasync def return_plate_phase(lh) -> dict:\n    \"\"\"\n    Move plate from working carrier back to storage.\n    If the gripper motion fails, Prefect retries once after 60 seconds.\n    The delay gives the instrument time to reset before the next attempt.\n    \"\"\"\n    lh = await gripper_move(\n        lh=lh,\n        source=\"working_carrier[1]\",\n        destination=\"storage_carrier[4]\",\n    )\n    return {\"lh\": lh}\n",[770,1232,1233,1251,1255,1259,1268,1276,1293,1305,1317,1321,1342,1347,1352,1357,1362,1366,1380,1391,1408,1425,1431],{"__ignoreMap":838},[842,1234,1235,1237,1239,1241,1243,1245,1247,1249],{"class":844,"line":845},[842,1236,849],{"class":848},[842,1238,853],{"class":852},[842,1240,857],{"class":856},[842,1242,878],{"class":852},[842,1244,857],{"class":856},[842,1246,883],{"class":852},[842,1248,863],{"class":848},[842,1250,888],{"class":852},[842,1252,1253],{"class":844,"line":869},[842,1254,895],{"emptyLinePlaceholder":894},[842,1256,1257],{"class":844,"line":891},[842,1258,895],{"emptyLinePlaceholder":894},[842,1260,1261,1263,1265],{"class":844,"line":898},[842,1262,906],{"class":856},[842,1264,448],{"class":909},[842,1266,1267],{"class":856},"(\n",[842,1269,1270,1273],{"class":844,"line":903},[842,1271,1272],{"class":915},"    log_prints",[842,1274,1275],{"class":856},"=True,\n",[842,1277,1278,1281,1283,1285,1288,1290],{"class":844,"line":940},[842,1279,1280],{"class":915},"    name",[842,1282,925],{"class":856},[842,1284,928],{"class":856},[842,1286,1287],{"class":931},"Return Plate Phase",[842,1289,928],{"class":856},[842,1291,1292],{"class":856},",\n",[842,1294,1295,1298,1300,1303],{"class":844,"line":970},[842,1296,1297],{"class":915},"    retries",[842,1299,925],{"class":856},[842,1301,1302],{"class":1036},"1",[842,1304,1292],{"class":856},[842,1306,1307,1310,1312,1315],{"class":844,"line":984},[842,1308,1309],{"class":915},"    retry_delay_seconds",[842,1311,925],{"class":856},[842,1313,1314],{"class":1036},"60",[842,1316,1292],{"class":856},[842,1318,1319],{"class":844,"line":992},[842,1320,937],{"class":856},[842,1322,1323,1325,1327,1330,1332,1334,1336,1338,1340],{"class":844,"line":1042},[842,1324,944],{"class":943},[842,1326,947],{"class":943},[842,1328,1329],{"class":909}," return_plate_phase",[842,1331,912],{"class":856},[842,1333,955],{"class":915},[842,1335,806],{"class":856},[842,1337,960],{"class":856},[842,1339,964],{"class":963},[842,1341,967],{"class":856},[842,1343,1344],{"class":844,"line":1084},[842,1345,1346],{"class":848},"    \"\"\"\n",[842,1348,1349],{"class":844,"line":1092},[842,1350,1351],{"class":1095},"    Move plate from working carrier back to storage.\n",[842,1353,1354],{"class":844,"line":1099},[842,1355,1356],{"class":1095},"    If the gripper motion fails, Prefect retries once after 60 seconds.\n",[842,1358,1359],{"class":844,"line":1105},[842,1360,1361],{"class":1095},"    The delay gives the instrument time to reset before the next attempt.\n",[842,1363,1364],{"class":844,"line":1127},[842,1365,1346],{"class":848},[842,1367,1368,1371,1373,1375,1378],{"class":844,"line":1149},[842,1369,1370],{"class":852},"    lh ",[842,1372,925],{"class":856},[842,1374,1000],{"class":848},[842,1376,1377],{"class":909}," gripper_move",[842,1379,1267],{"class":856},[842,1381,1382,1385,1387,1389],{"class":844,"line":1154},[842,1383,1384],{"class":915},"        lh",[842,1386,925],{"class":856},[842,1388,955],{"class":909},[842,1390,1292],{"class":856},[842,1392,1394,1397,1399,1401,1404,1406],{"class":844,"line":1393},18,[842,1395,1396],{"class":915},"        source",[842,1398,925],{"class":856},[842,1400,928],{"class":856},[842,1402,1403],{"class":931},"working_carrier[1]",[842,1405,928],{"class":856},[842,1407,1292],{"class":856},[842,1409,1411,1414,1416,1418,1421,1423],{"class":844,"line":1410},19,[842,1412,1413],{"class":915},"        destination",[842,1415,925],{"class":856},[842,1417,928],{"class":856},[842,1419,1420],{"class":931},"storage_carrier[4]",[842,1422,928],{"class":856},[842,1424,1292],{"class":856},[842,1426,1428],{"class":844,"line":1427},20,[842,1429,1430],{"class":856},"    )\n",[842,1432,1434,1436,1438,1440,1442,1444,1446,1448],{"class":844,"line":1433},21,[842,1435,1157],{"class":848},[842,1437,1160],{"class":856},[842,1439,928],{"class":856},[842,1441,955],{"class":931},[842,1443,928],{"class":856},[842,1445,1169],{"class":856},[842,1447,1172],{"class":852},[842,1449,1194],{"class":856},[756,1451,1452,1453,1169],{},"The same decorator works on ",[770,1454,1226],{},[833,1456,1458],{"className":835,"code":1457,"language":837,"meta":838,"style":838},"from unitelabs.sdk.automate import step\n\n\n@step(\n    log_prints=True,\n    name=\"Fetch Instrument Data\",\n    retries=3,\n    retry_delay_seconds=10,\n)\nasync def fetch_instrument_data_task(endpoint: str) -> dict:\n    # Retried up to 3 times on any exception, with 10s between attempts\n    ...\n",[770,1459,1460,1479,1483,1487,1495,1501,1516,1527,1538,1542,1569,1574],{"__ignoreMap":838},[842,1461,1462,1464,1466,1468,1470,1472,1474,1476],{"class":844,"line":845},[842,1463,849],{"class":848},[842,1465,853],{"class":852},[842,1467,857],{"class":856},[842,1469,878],{"class":852},[842,1471,857],{"class":856},[842,1473,883],{"class":852},[842,1475,863],{"class":848},[842,1477,1478],{"class":852}," step\n",[842,1480,1481],{"class":844,"line":869},[842,1482,895],{"emptyLinePlaceholder":894},[842,1484,1485],{"class":844,"line":891},[842,1486,895],{"emptyLinePlaceholder":894},[842,1488,1489,1491,1493],{"class":844,"line":898},[842,1490,906],{"class":856},[842,1492,449],{"class":909},[842,1494,1267],{"class":856},[842,1496,1497,1499],{"class":844,"line":903},[842,1498,1272],{"class":915},[842,1500,1275],{"class":856},[842,1502,1503,1505,1507,1509,1512,1514],{"class":844,"line":940},[842,1504,1280],{"class":915},[842,1506,925],{"class":856},[842,1508,928],{"class":856},[842,1510,1511],{"class":931},"Fetch Instrument Data",[842,1513,928],{"class":856},[842,1515,1292],{"class":856},[842,1517,1518,1520,1522,1525],{"class":844,"line":970},[842,1519,1297],{"class":915},[842,1521,925],{"class":856},[842,1523,1524],{"class":1036},"3",[842,1526,1292],{"class":856},[842,1528,1529,1531,1533,1536],{"class":844,"line":984},[842,1530,1309],{"class":915},[842,1532,925],{"class":856},[842,1534,1535],{"class":1036},"10",[842,1537,1292],{"class":856},[842,1539,1540],{"class":844,"line":992},[842,1541,937],{"class":856},[842,1543,1544,1546,1548,1551,1553,1556,1558,1561,1563,1565,1567],{"class":844,"line":1042},[842,1545,944],{"class":943},[842,1547,947],{"class":943},[842,1549,1550],{"class":909}," fetch_instrument_data_task",[842,1552,912],{"class":856},[842,1554,1555],{"class":915},"endpoint",[842,1557,1169],{"class":856},[842,1559,1560],{"class":963}," str",[842,1562,806],{"class":856},[842,1564,960],{"class":856},[842,1566,964],{"class":963},[842,1568,967],{"class":856},[842,1570,1571],{"class":844,"line":1084},[842,1572,1573],{"class":1095},"    # Retried up to 3 times on any exception, with 10s between attempts\n",[842,1575,1576],{"class":844,"line":1092},[842,1577,1578],{"class":852},"    ...\n",[763,1580,1582],{"icon":1581},"i-heroicons-exclamation-triangle",[756,1583,1584,1585,1588],{},"Only retry ",[791,1586,1587],{},"idempotent"," operations. Retrying a dispense that partially succeeded will double-dispense already-filled wells. Retrying a plate move when the plate was already moved will crash. When in doubt, use Pattern 3 instead: pause and let a human decide.",[811,1590,1592],{"id":1591},"pattern-3-pause-and-retry-hitl-recovery","Pattern 3 — Pause-and-retry (HITL recovery)",[756,1594,1595,1596,1599,1600,1603],{},"When a failure requires human intervention before retrying — not just waiting — combine ",[770,1597,1598],{},"try\u002Fexcept"," with ",[770,1601,1602],{},"pause_flow_run()",". The operator fixes the physical issue, clicks Resume, and the flow retries from that point.",[833,1605,1607],{"className":835,"code":1606,"language":837,"meta":838,"style":838},"from unitelabs.sdk import get_logger, pause_flow_run\nfrom unitelabs.sdk.automate import phase\n\n\nclass PlateNotDetectedError(Exception):\n    pass\n\n\n@phase(log_prints=True, name=\"Detection Phase with Recovery\")\nasync def detection_phase(lh, carrier_id: str) -> dict:\n    logger = get_logger()\n\n    try:\n        result = await detect_plate(lh=lh, carrier_id=carrier_id)\n        logger.info(f\"Plate detected at slot {result['slot']}.\")\n    except PlateNotDetectedError:\n        # 1. Log a clear, operator-readable message before pausing\n        logger.warning(\n            f\"No plate detected at {carrier_id} slot 1. \"\n            \"Check that the plate is fully seated, then click Resume.\"\n        )\n        # 2. Suspend the run — no resources held while waiting\n        await pause_flow_run()\n        # 3. On resume, retry detection (plate is now in position)\n        logger.info(\"Operator resumed — retrying detection.\")\n        result = await detect_plate(lh=lh, carrier_id=carrier_id)\n\n    return {\"lh\": lh, \"target_slot\": result[\"slot\"]}\n",[770,1608,1609,1628,1646,1650,1654,1670,1675,1679,1683,1708,1738,1748,1752,1758,1789,1833,1842,1847,1858,1875,1886,1891,1897,1908,1914,1934,1963,1968],{"__ignoreMap":838},[842,1610,1611,1613,1615,1617,1619,1621,1623,1625],{"class":844,"line":845},[842,1612,849],{"class":848},[842,1614,853],{"class":852},[842,1616,857],{"class":856},[842,1618,860],{"class":852},[842,1620,863],{"class":848},[842,1622,978],{"class":852},[842,1624,1014],{"class":856},[842,1626,1627],{"class":852}," pause_flow_run\n",[842,1629,1630,1632,1634,1636,1638,1640,1642,1644],{"class":844,"line":869},[842,1631,849],{"class":848},[842,1633,853],{"class":852},[842,1635,857],{"class":856},[842,1637,878],{"class":852},[842,1639,857],{"class":856},[842,1641,883],{"class":852},[842,1643,863],{"class":848},[842,1645,888],{"class":852},[842,1647,1648],{"class":844,"line":891},[842,1649,895],{"emptyLinePlaceholder":894},[842,1651,1652],{"class":844,"line":898},[842,1653,895],{"emptyLinePlaceholder":894},[842,1655,1656,1659,1662,1664,1667],{"class":844,"line":903},[842,1657,1658],{"class":943},"class",[842,1660,1661],{"class":963}," PlateNotDetectedError",[842,1663,912],{"class":856},[842,1665,1666],{"class":963},"Exception",[842,1668,1669],{"class":856},"):\n",[842,1671,1672],{"class":844,"line":940},[842,1673,1674],{"class":848},"    pass\n",[842,1676,1677],{"class":844,"line":970},[842,1678,895],{"emptyLinePlaceholder":894},[842,1680,1681],{"class":844,"line":984},[842,1682,895],{"emptyLinePlaceholder":894},[842,1684,1685,1687,1689,1691,1693,1695,1697,1699,1701,1704,1706],{"class":844,"line":992},[842,1686,906],{"class":856},[842,1688,448],{"class":909},[842,1690,912],{"class":856},[842,1692,916],{"class":915},[842,1694,919],{"class":856},[842,1696,922],{"class":915},[842,1698,925],{"class":856},[842,1700,928],{"class":856},[842,1702,1703],{"class":931},"Detection Phase with Recovery",[842,1705,928],{"class":856},[842,1707,937],{"class":856},[842,1709,1710,1712,1714,1717,1719,1721,1723,1726,1728,1730,1732,1734,1736],{"class":844,"line":1042},[842,1711,944],{"class":943},[842,1713,947],{"class":943},[842,1715,1716],{"class":909}," detection_phase",[842,1718,912],{"class":856},[842,1720,955],{"class":915},[842,1722,1014],{"class":856},[842,1724,1725],{"class":915}," carrier_id",[842,1727,1169],{"class":856},[842,1729,1560],{"class":963},[842,1731,806],{"class":856},[842,1733,960],{"class":856},[842,1735,964],{"class":963},[842,1737,967],{"class":856},[842,1739,1740,1742,1744,1746],{"class":844,"line":1084},[842,1741,973],{"class":852},[842,1743,925],{"class":856},[842,1745,978],{"class":909},[842,1747,981],{"class":856},[842,1749,1750],{"class":844,"line":1092},[842,1751,895],{"emptyLinePlaceholder":894},[842,1753,1754,1756],{"class":844,"line":1099},[842,1755,987],{"class":848},[842,1757,967],{"class":856},[842,1759,1760,1763,1765,1767,1770,1772,1774,1776,1778,1780,1782,1784,1787],{"class":844,"line":1105},[842,1761,1762],{"class":852},"        result ",[842,1764,925],{"class":856},[842,1766,1000],{"class":848},[842,1768,1769],{"class":909}," detect_plate",[842,1771,912],{"class":856},[842,1773,955],{"class":915},[842,1775,925],{"class":856},[842,1777,955],{"class":909},[842,1779,1014],{"class":856},[842,1781,1725],{"class":915},[842,1783,925],{"class":856},[842,1785,1786],{"class":909},"carrier_id",[842,1788,937],{"class":856},[842,1790,1791,1793,1795,1797,1799,1802,1805,1808,1811,1814,1817,1820,1822,1825,1828,1831],{"class":844,"line":1127},[842,1792,1130],{"class":852},[842,1794,857],{"class":856},[842,1796,1135],{"class":909},[842,1798,912],{"class":856},[842,1800,1801],{"class":943},"f",[842,1803,1804],{"class":931},"\"Plate detected at slot ",[842,1806,1807],{"class":1036},"{",[842,1809,1810],{"class":909},"result",[842,1812,1813],{"class":856},"[",[842,1815,1816],{"class":856},"'",[842,1818,1819],{"class":931},"slot",[842,1821,1816],{"class":856},[842,1823,1824],{"class":856},"]",[842,1826,1827],{"class":1036},"}",[842,1829,1830],{"class":931},".\"",[842,1832,937],{"class":856},[842,1834,1835,1838,1840],{"class":844,"line":1149},[842,1836,1837],{"class":848},"    except",[842,1839,1661],{"class":852},[842,1841,967],{"class":856},[842,1843,1844],{"class":844,"line":1154},[842,1845,1846],{"class":1095},"        # 1. Log a clear, operator-readable message before pausing\n",[842,1848,1849,1851,1853,1856],{"class":844,"line":1393},[842,1850,1130],{"class":852},[842,1852,857],{"class":856},[842,1854,1855],{"class":909},"warning",[842,1857,1267],{"class":856},[842,1859,1860,1863,1866,1868,1870,1872],{"class":844,"line":1410},[842,1861,1862],{"class":943},"            f",[842,1864,1865],{"class":931},"\"No plate detected at ",[842,1867,1807],{"class":1036},[842,1869,1786],{"class":909},[842,1871,1827],{"class":1036},[842,1873,1874],{"class":931}," slot 1. \"\n",[842,1876,1877,1880,1883],{"class":844,"line":1427},[842,1878,1879],{"class":856},"            \"",[842,1881,1882],{"class":931},"Check that the plate is fully seated, then click Resume.",[842,1884,1885],{"class":856},"\"\n",[842,1887,1888],{"class":844,"line":1433},[842,1889,1890],{"class":856},"        )\n",[842,1892,1894],{"class":844,"line":1893},22,[842,1895,1896],{"class":1095},"        # 2. Suspend the run — no resources held while waiting\n",[842,1898,1900,1903,1906],{"class":844,"line":1899},23,[842,1901,1902],{"class":848},"        await",[842,1904,1905],{"class":909}," pause_flow_run",[842,1907,981],{"class":856},[842,1909,1911],{"class":844,"line":1910},24,[842,1912,1913],{"class":1095},"        # 3. On resume, retry detection (plate is now in position)\n",[842,1915,1917,1919,1921,1923,1925,1927,1930,1932],{"class":844,"line":1916},25,[842,1918,1130],{"class":852},[842,1920,857],{"class":856},[842,1922,1135],{"class":909},[842,1924,912],{"class":856},[842,1926,928],{"class":856},[842,1928,1929],{"class":931},"Operator resumed — retrying detection.",[842,1931,928],{"class":856},[842,1933,937],{"class":856},[842,1935,1937,1939,1941,1943,1945,1947,1949,1951,1953,1955,1957,1959,1961],{"class":844,"line":1936},26,[842,1938,1762],{"class":852},[842,1940,925],{"class":856},[842,1942,1000],{"class":848},[842,1944,1769],{"class":909},[842,1946,912],{"class":856},[842,1948,955],{"class":915},[842,1950,925],{"class":856},[842,1952,955],{"class":909},[842,1954,1014],{"class":856},[842,1956,1725],{"class":915},[842,1958,925],{"class":856},[842,1960,1786],{"class":909},[842,1962,937],{"class":856},[842,1964,1966],{"class":844,"line":1965},27,[842,1967,895],{"emptyLinePlaceholder":894},[842,1969,1971,1973,1975,1977,1979,1981,1983,1985,1987,1989,1992,1994,1996,1999,2001,2003,2005,2007],{"class":844,"line":1970},28,[842,1972,1157],{"class":848},[842,1974,1160],{"class":856},[842,1976,928],{"class":856},[842,1978,955],{"class":931},[842,1980,928],{"class":856},[842,1982,1169],{"class":856},[842,1984,1172],{"class":852},[842,1986,1014],{"class":856},[842,1988,1177],{"class":856},[842,1990,1991],{"class":931},"target_slot",[842,1993,928],{"class":856},[842,1995,1169],{"class":856},[842,1997,1998],{"class":852}," result",[842,2000,1813],{"class":856},[842,2002,928],{"class":856},[842,2004,1819],{"class":931},[842,2006,928],{"class":856},[842,2008,2009],{"class":856},"]}\n",[756,2011,2012,2013,2016,2017,2021,2022,2024],{},"The run stays ",[770,2014,2015],{},"PAUSED"," until the operator acts. They can resume from the Prefect UI or ",[802,2018,2020],{"href":2019},"\u002Fautomate\u002Fguides\u002Fbasic-hitl\u002F","via the API",". See ",[802,2023,511],{"href":2019}," for more on the pause mechanism.",[811,2026,2028],{"id":2027},"pattern-4-phase-tracking-for-partial-recovery","Pattern 4 — Phase tracking for partial recovery",[756,2030,2031],{},"Track which phases completed successfully in a list. Include it in every return value — success and error alike. This tells you exactly where a run failed, which phases are safe to skip on a re-run, and what to report to a LIMS.",[833,2033,2035],{"className":835,"code":2034,"language":837,"meta":838,"style":838},"from unitelabs.sdk import get_logger\nfrom unitelabs.sdk.automate import workflow\n\n\n@workflow(log_prints=True, name=\"Full Workflow\")\nasync def full_workflow(lh) -> dict:\n    logger = get_logger()\n    phases_completed: list[str] = []\n\n    # Phase 01\n    lh = await initialization_phase(lh=lh)\n    phases_completed.append(\"01_initialization\")\n\n    # Phase 02\n    result = await detection_phase(lh=lh)\n    lh = result[\"lh\"]\n    phases_completed.append(\"02_detection\")\n\n    # Phase 03 — dispensing can fail mid-run\n    try:\n        lh = await dispensing_phase(lh=lh)\n        phases_completed.append(\"03_dispensing\")\n    except Exception as e:\n        logger.error(f\"Dispensing failed: {e}\")\n        return {\n            \"status\": \"error\",\n            \"failed_phase\": \"03_dispensing\",\n            \"phases_completed\": phases_completed,\n            \"message\": str(e),\n        }\n\n    phases_completed.append(\"04_finalization\")\n    return {\"status\": \"success\", \"phases_completed\": phases_completed}\n",[770,2036,2037,2051,2070,2074,2078,2103,2124,2134,2157,2161,2166,2187,2207,2211,2216,2237,2256,2275,2279,2284,2290,2310,2330,2345,2372,2380,2398,2417,2433,2454,2460,2465,2485],{"__ignoreMap":838},[842,2038,2039,2041,2043,2045,2047,2049],{"class":844,"line":845},[842,2040,849],{"class":848},[842,2042,853],{"class":852},[842,2044,857],{"class":856},[842,2046,860],{"class":852},[842,2048,863],{"class":848},[842,2050,866],{"class":852},[842,2052,2053,2055,2057,2059,2061,2063,2065,2067],{"class":844,"line":869},[842,2054,849],{"class":848},[842,2056,853],{"class":852},[842,2058,857],{"class":856},[842,2060,878],{"class":852},[842,2062,857],{"class":856},[842,2064,883],{"class":852},[842,2066,863],{"class":848},[842,2068,2069],{"class":852}," workflow\n",[842,2071,2072],{"class":844,"line":891},[842,2073,895],{"emptyLinePlaceholder":894},[842,2075,2076],{"class":844,"line":898},[842,2077,895],{"emptyLinePlaceholder":894},[842,2079,2080,2082,2084,2086,2088,2090,2092,2094,2096,2099,2101],{"class":844,"line":903},[842,2081,906],{"class":856},[842,2083,447],{"class":909},[842,2085,912],{"class":856},[842,2087,916],{"class":915},[842,2089,919],{"class":856},[842,2091,922],{"class":915},[842,2093,925],{"class":856},[842,2095,928],{"class":856},[842,2097,2098],{"class":931},"Full Workflow",[842,2100,928],{"class":856},[842,2102,937],{"class":856},[842,2104,2105,2107,2109,2112,2114,2116,2118,2120,2122],{"class":844,"line":940},[842,2106,944],{"class":943},[842,2108,947],{"class":943},[842,2110,2111],{"class":909}," full_workflow",[842,2113,912],{"class":856},[842,2115,955],{"class":915},[842,2117,806],{"class":856},[842,2119,960],{"class":856},[842,2121,964],{"class":963},[842,2123,967],{"class":856},[842,2125,2126,2128,2130,2132],{"class":844,"line":970},[842,2127,973],{"class":852},[842,2129,925],{"class":856},[842,2131,978],{"class":909},[842,2133,981],{"class":856},[842,2135,2136,2139,2141,2144,2146,2149,2151,2154],{"class":844,"line":984},[842,2137,2138],{"class":852},"    phases_completed",[842,2140,1169],{"class":856},[842,2142,2143],{"class":852}," list",[842,2145,1813],{"class":856},[842,2147,2148],{"class":963},"str",[842,2150,1824],{"class":856},[842,2152,2153],{"class":856}," =",[842,2155,2156],{"class":856}," []\n",[842,2158,2159],{"class":844,"line":992},[842,2160,895],{"emptyLinePlaceholder":894},[842,2162,2163],{"class":844,"line":1042},[842,2164,2165],{"class":1095},"    # Phase 01\n",[842,2167,2168,2170,2172,2174,2177,2179,2181,2183,2185],{"class":844,"line":1084},[842,2169,1370],{"class":852},[842,2171,925],{"class":856},[842,2173,1000],{"class":848},[842,2175,2176],{"class":909}," initialization_phase",[842,2178,912],{"class":856},[842,2180,955],{"class":915},[842,2182,925],{"class":856},[842,2184,955],{"class":909},[842,2186,937],{"class":856},[842,2188,2189,2191,2193,2196,2198,2200,2203,2205],{"class":844,"line":1092},[842,2190,2138],{"class":852},[842,2192,857],{"class":856},[842,2194,2195],{"class":909},"append",[842,2197,912],{"class":856},[842,2199,928],{"class":856},[842,2201,2202],{"class":931},"01_initialization",[842,2204,928],{"class":856},[842,2206,937],{"class":856},[842,2208,2209],{"class":844,"line":1099},[842,2210,895],{"emptyLinePlaceholder":894},[842,2212,2213],{"class":844,"line":1105},[842,2214,2215],{"class":1095},"    # Phase 02\n",[842,2217,2218,2221,2223,2225,2227,2229,2231,2233,2235],{"class":844,"line":1127},[842,2219,2220],{"class":852},"    result ",[842,2222,925],{"class":856},[842,2224,1000],{"class":848},[842,2226,1716],{"class":909},[842,2228,912],{"class":856},[842,2230,955],{"class":915},[842,2232,925],{"class":856},[842,2234,955],{"class":909},[842,2236,937],{"class":856},[842,2238,2239,2241,2243,2245,2247,2249,2251,2253],{"class":844,"line":1149},[842,2240,1370],{"class":852},[842,2242,925],{"class":856},[842,2244,1998],{"class":852},[842,2246,1813],{"class":856},[842,2248,928],{"class":856},[842,2250,955],{"class":931},[842,2252,928],{"class":856},[842,2254,2255],{"class":856},"]\n",[842,2257,2258,2260,2262,2264,2266,2268,2271,2273],{"class":844,"line":1154},[842,2259,2138],{"class":852},[842,2261,857],{"class":856},[842,2263,2195],{"class":909},[842,2265,912],{"class":856},[842,2267,928],{"class":856},[842,2269,2270],{"class":931},"02_detection",[842,2272,928],{"class":856},[842,2274,937],{"class":856},[842,2276,2277],{"class":844,"line":1393},[842,2278,895],{"emptyLinePlaceholder":894},[842,2280,2281],{"class":844,"line":1410},[842,2282,2283],{"class":1095},"    # Phase 03 — dispensing can fail mid-run\n",[842,2285,2286,2288],{"class":844,"line":1427},[842,2287,987],{"class":848},[842,2289,967],{"class":856},[842,2291,2292,2294,2296,2298,2300,2302,2304,2306,2308],{"class":844,"line":1433},[842,2293,995],{"class":852},[842,2295,925],{"class":856},[842,2297,1000],{"class":848},[842,2299,950],{"class":909},[842,2301,912],{"class":856},[842,2303,955],{"class":915},[842,2305,925],{"class":856},[842,2307,955],{"class":909},[842,2309,937],{"class":856},[842,2311,2312,2315,2317,2319,2321,2323,2326,2328],{"class":844,"line":1893},[842,2313,2314],{"class":852},"        phases_completed",[842,2316,857],{"class":856},[842,2318,2195],{"class":909},[842,2320,912],{"class":856},[842,2322,928],{"class":856},[842,2324,2325],{"class":931},"03_dispensing",[842,2327,928],{"class":856},[842,2329,937],{"class":856},[842,2331,2332,2334,2337,2340,2343],{"class":844,"line":1899},[842,2333,1837],{"class":848},[842,2335,2336],{"class":963}," Exception",[842,2338,2339],{"class":848}," as",[842,2341,2342],{"class":852}," e",[842,2344,967],{"class":856},[842,2346,2347,2349,2351,2354,2356,2358,2361,2363,2366,2368,2370],{"class":844,"line":1910},[842,2348,1130],{"class":852},[842,2350,857],{"class":856},[842,2352,2353],{"class":909},"error",[842,2355,912],{"class":856},[842,2357,1801],{"class":943},[842,2359,2360],{"class":931},"\"Dispensing failed: ",[842,2362,1807],{"class":1036},[842,2364,2365],{"class":909},"e",[842,2367,1827],{"class":1036},[842,2369,928],{"class":931},[842,2371,937],{"class":856},[842,2373,2374,2377],{"class":844,"line":1916},[842,2375,2376],{"class":848},"        return",[842,2378,2379],{"class":856}," {\n",[842,2381,2382,2384,2386,2388,2390,2392,2394,2396],{"class":844,"line":1936},[842,2383,1879],{"class":856},[842,2385,1180],{"class":931},[842,2387,928],{"class":856},[842,2389,1169],{"class":856},[842,2391,1177],{"class":856},[842,2393,2353],{"class":931},[842,2395,928],{"class":856},[842,2397,1292],{"class":856},[842,2399,2400,2402,2405,2407,2409,2411,2413,2415],{"class":844,"line":1965},[842,2401,1879],{"class":856},[842,2403,2404],{"class":931},"failed_phase",[842,2406,928],{"class":856},[842,2408,1169],{"class":856},[842,2410,1177],{"class":856},[842,2412,2325],{"class":931},[842,2414,928],{"class":856},[842,2416,1292],{"class":856},[842,2418,2419,2421,2424,2426,2428,2431],{"class":844,"line":1970},[842,2420,1879],{"class":856},[842,2422,2423],{"class":931},"phases_completed",[842,2425,928],{"class":856},[842,2427,1169],{"class":856},[842,2429,2430],{"class":852}," phases_completed",[842,2432,1292],{"class":856},[842,2434,2436,2438,2441,2443,2445,2447,2449,2451],{"class":844,"line":2435},29,[842,2437,1879],{"class":856},[842,2439,2440],{"class":931},"message",[842,2442,928],{"class":856},[842,2444,1169],{"class":856},[842,2446,1560],{"class":963},[842,2448,912],{"class":856},[842,2450,2365],{"class":909},[842,2452,2453],{"class":856},"),\n",[842,2455,2457],{"class":844,"line":2456},30,[842,2458,2459],{"class":856},"        }\n",[842,2461,2463],{"class":844,"line":2462},31,[842,2464,895],{"emptyLinePlaceholder":894},[842,2466,2468,2470,2472,2474,2476,2478,2481,2483],{"class":844,"line":2467},32,[842,2469,2138],{"class":852},[842,2471,857],{"class":856},[842,2473,2195],{"class":909},[842,2475,912],{"class":856},[842,2477,928],{"class":856},[842,2479,2480],{"class":931},"04_finalization",[842,2482,928],{"class":856},[842,2484,937],{"class":856},[842,2486,2488,2490,2492,2494,2496,2498,2500,2502,2504,2506,2508,2510,2512,2514,2516,2518],{"class":844,"line":2487},33,[842,2489,1157],{"class":848},[842,2491,1160],{"class":856},[842,2493,928],{"class":856},[842,2495,1180],{"class":931},[842,2497,928],{"class":856},[842,2499,1169],{"class":856},[842,2501,1177],{"class":856},[842,2503,1189],{"class":931},[842,2505,928],{"class":856},[842,2507,1014],{"class":856},[842,2509,1177],{"class":856},[842,2511,2423],{"class":931},[842,2513,928],{"class":856},[842,2515,1169],{"class":856},[842,2517,2430],{"class":852},[842,2519,1194],{"class":856},[756,2521,2522,2523,2526],{},"Knowing ",[770,2524,2525],{},"phases_completed = [\"01_initialization\", \"02_detection\"]"," means Phase 03 was the one that failed, Phases 01 and 02 do not need to be repeated, and the instrument state after Phase 02 is the starting point for a manual recovery.",[808,2528],{},[811,2530,2532],{"id":2531},"graceful-vs-fail-fast","Graceful vs fail-fast",[756,2534,2535],{},"For flows triggered by external systems (a UI, a webhook, a scheduler), the response format matters:",[2537,2538,2539,2555],"table",{},[2540,2541,2542],"thead",{},[2543,2544,2545,2549,2552],"tr",{},[2546,2547,2548],"th",{},"Pattern",[2546,2550,2551],{},"Prefect run status",[2546,2553,2554],{},"Use when",[2556,2557,2558,2574],"tbody",{},[2543,2559,2560,2566,2571],{},[2561,2562,2563,2565],"td",{},[770,2564,1598],{}," → return error dict",[2561,2567,2568],{},[770,2569,2570],{},"Completed",[2561,2572,2573],{},"Caller expects a structured response",[2543,2575,2576,2579,2584],{},[2561,2577,2578],{},"Let exception propagate",[2561,2580,2581],{},[770,2582,2583],{},"Failed",[2561,2585,2586],{},"You want Prefect alerts and on-call paging",[833,2588,2590],{"className":835,"code":2589,"language":837,"meta":838,"style":838},"# Graceful — caller sees {\"status\": \"error\", ...} instead of an exception\n@workflow(log_prints=True, name=\"Graceful Flow\")\nasync def graceful_flow(source: str) -> dict:\n    try:\n        result = await process(source=source)\n        return {\"status\": \"success\", **result}\n    except ValueError as e:\n        return {\"status\": \"error\", \"message\": str(e)}\n",[770,2591,2592,2597,2622,2648,2654,2675,2704,2717],{"__ignoreMap":838},[842,2593,2594],{"class":844,"line":845},[842,2595,2596],{"class":1095},"# Graceful — caller sees {\"status\": \"error\", ...} instead of an exception\n",[842,2598,2599,2601,2603,2605,2607,2609,2611,2613,2615,2618,2620],{"class":844,"line":869},[842,2600,906],{"class":856},[842,2602,447],{"class":909},[842,2604,912],{"class":856},[842,2606,916],{"class":915},[842,2608,919],{"class":856},[842,2610,922],{"class":915},[842,2612,925],{"class":856},[842,2614,928],{"class":856},[842,2616,2617],{"class":931},"Graceful Flow",[842,2619,928],{"class":856},[842,2621,937],{"class":856},[842,2623,2624,2626,2628,2631,2633,2636,2638,2640,2642,2644,2646],{"class":844,"line":891},[842,2625,944],{"class":943},[842,2627,947],{"class":943},[842,2629,2630],{"class":909}," graceful_flow",[842,2632,912],{"class":856},[842,2634,2635],{"class":915},"source",[842,2637,1169],{"class":856},[842,2639,1560],{"class":963},[842,2641,806],{"class":856},[842,2643,960],{"class":856},[842,2645,964],{"class":963},[842,2647,967],{"class":856},[842,2649,2650,2652],{"class":844,"line":898},[842,2651,987],{"class":848},[842,2653,967],{"class":856},[842,2655,2656,2658,2660,2662,2665,2667,2669,2671,2673],{"class":844,"line":903},[842,2657,1762],{"class":852},[842,2659,925],{"class":856},[842,2661,1000],{"class":848},[842,2663,2664],{"class":909}," process",[842,2666,912],{"class":856},[842,2668,2635],{"class":915},[842,2670,925],{"class":856},[842,2672,2635],{"class":909},[842,2674,937],{"class":856},[842,2676,2677,2679,2681,2683,2685,2687,2689,2691,2693,2695,2697,2700,2702],{"class":844,"line":940},[842,2678,2376],{"class":848},[842,2680,1160],{"class":856},[842,2682,928],{"class":856},[842,2684,1180],{"class":931},[842,2686,928],{"class":856},[842,2688,1169],{"class":856},[842,2690,1177],{"class":856},[842,2692,1189],{"class":931},[842,2694,928],{"class":856},[842,2696,1014],{"class":856},[842,2698,2699],{"class":856}," **",[842,2701,1810],{"class":852},[842,2703,1194],{"class":856},[842,2705,2706,2708,2711,2713,2715],{"class":844,"line":970},[842,2707,1837],{"class":848},[842,2709,2710],{"class":963}," ValueError",[842,2712,2339],{"class":848},[842,2714,2342],{"class":852},[842,2716,967],{"class":856},[842,2718,2719,2721,2723,2725,2727,2729,2731,2733,2735,2737,2739,2741,2743,2745,2747,2749,2751,2753],{"class":844,"line":984},[842,2720,2376],{"class":848},[842,2722,1160],{"class":856},[842,2724,928],{"class":856},[842,2726,1180],{"class":931},[842,2728,928],{"class":856},[842,2730,1169],{"class":856},[842,2732,1177],{"class":856},[842,2734,2353],{"class":931},[842,2736,928],{"class":856},[842,2738,1014],{"class":856},[842,2740,1177],{"class":856},[842,2742,2440],{"class":931},[842,2744,928],{"class":856},[842,2746,1169],{"class":856},[842,2748,1560],{"class":963},[842,2750,912],{"class":856},[842,2752,2365],{"class":909},[842,2754,2755],{"class":856},")}\n",[756,2757,2758,2759,857],{},"For a deeper treatment of structured error types and error codes, see ",[802,2760,523],{"href":2761},"\u002Fautomate\u002Fguides\u002Fadvanced-error-handling\u002F",[811,2763,2765],{"id":2764},"next-steps","Next steps",[795,2767,2768,2776],{},[798,2769,2770,2772,2773,2775],{},[802,2771,511],{"href":2019},": ",[770,2774,1602],{}," in depth",[798,2777,2778,2780],{},[802,2779,523],{"href":2761},": typed error taxonomy with user-facing messages and error codes",[2782,2783,2784],"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 .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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);}",{"title":838,"searchDepth":845,"depth":869,"links":2786},[2787,2789,2790,2791,2792,2793],{"id":813,"depth":869,"text":2788},"Pattern 1 — Guaranteed cleanup with try\u002Ffinally",{"id":1208,"depth":869,"text":1209},{"id":1591,"depth":869,"text":1592},{"id":2027,"depth":869,"text":2028},{"id":2531,"depth":869,"text":2532},{"id":2764,"depth":869,"text":2765},"Clean up hardware state, retry transient failures, and resume after operator intervention.","md",null,{},{"title":519,"description":2794},"19T6JLTLI-7ddDbM0V_bgIk0kANzJrA43n9tlcVJjSA",[2801,2803],{"title":515,"path":516,"stem":517,"description":2802},"Collect structured data from operators at runtime using a RunInput model — enums, booleans, numbers, and text fields rendered as a platform form.",{"title":523,"path":524,"stem":525,"description":2804},"Build a structured error taxonomy with typed error codes, user-facing messages, and automatic exception classification.",1783607790608]