[{"data":1,"prerenderedAt":1631},["ShallowReactive",2],{"navigation":3,"\u002Fautomate\u002Fconcepts\u002Ferror-handling":750,"\u002Fautomate\u002Fconcepts\u002Ferror-handling-surround":1626},[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":183,"body":752,"description":1620,"extension":1621,"links":1622,"meta":1623,"navigation":913,"path":492,"seo":1624,"stem":493,"__hash__":1625},"docs\u002F07.automate\u002F10.concepts\u002F90.error-handling.md",{"type":753,"value":754,"toc":1611},"minimark",[755,764,789,794,860,864,867,1017,1020,1027,1031,1037,1395,1402,1525,1533,1537,1547,1550,1554,1562,1566,1592,1595,1607],[756,757,758,759,763],"p",{},"Error handling in UniteLabs is built into the workflow hierarchy. Different error types are handled at the level best suited to recover from them — automatic retries at the step level, and ",[760,761,762],"code",{},"try\u002Fexcept"," with operator-assisted recovery at the phase level.",[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.",[790,791,793],"h2",{"id":792},"error-types","Error types",[795,796,797,813],"table",{},[798,799,800],"thead",{},[801,802,803,807,810],"tr",{},[804,805,806],"th",{},"Type",[804,808,809],{},"Examples",[804,811,812],{},"Where handled",[814,815,816,831,847],"tbody",{},[801,817,818,825,828],{},[819,820,821],"td",{},[822,823,824],"strong",{},"Technical",[819,826,827],{},"Device timeout, lost connection, command not acknowledged",[819,829,830],{},"Step — automatic retry",[801,832,833,838,841],{},[819,834,835],{},[822,836,837],{},"Operational",[819,839,840],{},"Phase time limit exceeded, device unavailable at scheduling time",[819,842,843,844,846],{},"Phase — ",[760,845,762],{}," + pause or abort",[801,848,849,854,857],{},[819,850,851],{},[822,852,853],{},"Scientific",[819,855,856],{},"Sample outside expected range, upstream result invalid",[819,858,859],{},"Phase — raise an exception, pause for operator intervention",[790,861,863],{"id":862},"step-level-automatic-retry","Step level: automatic retry",[756,865,866],{},"Steps are the first line of defense. The workflow engine retries technical errors automatically before surfacing them:",[868,869,875],"pre",{"className":870,"code":871,"filename":872,"language":873,"meta":874,"style":874},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","from unitelabs.sdk.automate import step\n\n@step(retries=3, retry_delay_seconds=2)\nasync def aspirate(liquid_handler: LiquidHandlerDevice, volume: float):\n    await liquid_handler.pipettes.aspirate(volume)\n","workflows\u002Fsteps.py","python","",[760,876,877,908,915,952,990],{"__ignoreMap":874},[878,879,882,886,890,894,897,899,902,905],"span",{"class":880,"line":881},"line",1,[878,883,885],{"class":884},"s7zQu","from",[878,887,889],{"class":888},"sTEyZ"," unitelabs",[878,891,893],{"class":892},"sMK4o",".",[878,895,896],{"class":888},"sdk",[878,898,893],{"class":892},[878,900,901],{"class":888},"automate ",[878,903,904],{"class":884},"import",[878,906,907],{"class":888}," step\n",[878,909,911],{"class":880,"line":910},2,[878,912,914],{"emptyLinePlaceholder":913},true,"\n",[878,916,918,921,924,927,931,934,938,941,944,946,949],{"class":880,"line":917},3,[878,919,920],{"class":892},"@",[878,922,449],{"class":923},"s2Zo4",[878,925,926],{"class":892},"(",[878,928,930],{"class":929},"sHdIc","retries",[878,932,933],{"class":892},"=",[878,935,937],{"class":936},"sbssI","3",[878,939,940],{"class":892},",",[878,942,943],{"class":929}," retry_delay_seconds",[878,945,933],{"class":892},[878,947,948],{"class":936},"2",[878,950,951],{"class":892},")\n",[878,953,955,959,962,965,967,970,973,976,978,981,983,987],{"class":880,"line":954},4,[878,956,958],{"class":957},"spNyl","async",[878,960,961],{"class":957}," def",[878,963,964],{"class":923}," aspirate",[878,966,926],{"class":892},[878,968,969],{"class":929},"liquid_handler",[878,971,972],{"class":892},":",[878,974,975],{"class":888}," LiquidHandlerDevice",[878,977,940],{"class":892},[878,979,980],{"class":929}," volume",[878,982,972],{"class":892},[878,984,986],{"class":985},"sBMFI"," float",[878,988,989],{"class":892},"):\n",[878,991,993,996,999,1001,1005,1007,1010,1012,1015],{"class":880,"line":992},5,[878,994,995],{"class":884},"    await",[878,997,998],{"class":888}," liquid_handler",[878,1000,893],{"class":892},[878,1002,1004],{"class":1003},"swJcz","pipettes",[878,1006,893],{"class":892},[878,1008,1009],{"class":923},"aspirate",[878,1011,926],{"class":892},[878,1013,1014],{"class":923},"volume",[878,1016,951],{"class":892},[756,1018,1019],{},"If the step fails after all retries, the error is propagated to the enclosing phase.",[756,1021,1022,1023,1026],{},"The default retry count is configurable per step. Only retry ",[822,1024,1025],{},"idempotent"," operations — retrying a partial dispense will double-dispense already-filled wells.",[790,1028,1030],{"id":1029},"phase-level-tryexcept-and-operator-recovery","Phase level: try\u002Fexcept and operator recovery",[756,1032,1033,1034,1036],{},"At the phase level, use ",[760,1035,762],{}," to catch errors and decide how to respond — retry, pause for operator intervention, or abort cleanly:",[868,1038,1041],{"className":870,"code":1039,"filename":1040,"language":873,"meta":874,"style":874},"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()\nasync def detection_phase(lh, carrier_id: str) -> dict:\n    logger = get_logger()\n    try:\n        result = await detect_plate(lh=lh, carrier_id=carrier_id)\n    except PlateNotDetectedError:\n        logger.warning(\n            f\"No plate detected at {carrier_id}. \"\n            \"Seat the plate fully, then click Resume.\"\n        )\n        await pause_flow_run()\n        logger.info(\"Operator resumed — retrying detection.\")\n        result = await detect_plate(lh=lh, carrier_id=carrier_id)\n    return {\"lh\": lh, \"target_slot\": result[\"slot\"]}\n","workflows\u002Fdetection.py",[760,1042,1043,1064,1083,1087,1091,1106,1112,1117,1122,1132,1169,1181,1189,1222,1232,1246,1267,1279,1285,1296,1318,1347],{"__ignoreMap":874},[878,1044,1045,1047,1049,1051,1054,1056,1059,1061],{"class":880,"line":881},[878,1046,885],{"class":884},[878,1048,889],{"class":888},[878,1050,893],{"class":892},[878,1052,1053],{"class":888},"sdk ",[878,1055,904],{"class":884},[878,1057,1058],{"class":888}," get_logger",[878,1060,940],{"class":892},[878,1062,1063],{"class":888}," pause_flow_run\n",[878,1065,1066,1068,1070,1072,1074,1076,1078,1080],{"class":880,"line":910},[878,1067,885],{"class":884},[878,1069,889],{"class":888},[878,1071,893],{"class":892},[878,1073,896],{"class":888},[878,1075,893],{"class":892},[878,1077,901],{"class":888},[878,1079,904],{"class":884},[878,1081,1082],{"class":888}," phase\n",[878,1084,1085],{"class":880,"line":917},[878,1086,914],{"emptyLinePlaceholder":913},[878,1088,1089],{"class":880,"line":954},[878,1090,914],{"emptyLinePlaceholder":913},[878,1092,1093,1096,1099,1101,1104],{"class":880,"line":992},[878,1094,1095],{"class":957},"class",[878,1097,1098],{"class":985}," PlateNotDetectedError",[878,1100,926],{"class":892},[878,1102,1103],{"class":985},"Exception",[878,1105,989],{"class":892},[878,1107,1109],{"class":880,"line":1108},6,[878,1110,1111],{"class":884},"    pass\n",[878,1113,1115],{"class":880,"line":1114},7,[878,1116,914],{"emptyLinePlaceholder":913},[878,1118,1120],{"class":880,"line":1119},8,[878,1121,914],{"emptyLinePlaceholder":913},[878,1123,1125,1127,1129],{"class":880,"line":1124},9,[878,1126,920],{"class":892},[878,1128,448],{"class":923},[878,1130,1131],{"class":892},"()\n",[878,1133,1135,1137,1139,1142,1144,1147,1149,1152,1154,1157,1160,1163,1166],{"class":880,"line":1134},10,[878,1136,958],{"class":957},[878,1138,961],{"class":957},[878,1140,1141],{"class":923}," detection_phase",[878,1143,926],{"class":892},[878,1145,1146],{"class":929},"lh",[878,1148,940],{"class":892},[878,1150,1151],{"class":929}," carrier_id",[878,1153,972],{"class":892},[878,1155,1156],{"class":985}," str",[878,1158,1159],{"class":892},")",[878,1161,1162],{"class":892}," ->",[878,1164,1165],{"class":985}," dict",[878,1167,1168],{"class":892},":\n",[878,1170,1172,1175,1177,1179],{"class":880,"line":1171},11,[878,1173,1174],{"class":888},"    logger ",[878,1176,933],{"class":892},[878,1178,1058],{"class":923},[878,1180,1131],{"class":892},[878,1182,1184,1187],{"class":880,"line":1183},12,[878,1185,1186],{"class":884},"    try",[878,1188,1168],{"class":892},[878,1190,1192,1195,1197,1200,1203,1205,1207,1209,1211,1213,1215,1217,1220],{"class":880,"line":1191},13,[878,1193,1194],{"class":888},"        result ",[878,1196,933],{"class":892},[878,1198,1199],{"class":884}," await",[878,1201,1202],{"class":923}," detect_plate",[878,1204,926],{"class":892},[878,1206,1146],{"class":929},[878,1208,933],{"class":892},[878,1210,1146],{"class":923},[878,1212,940],{"class":892},[878,1214,1151],{"class":929},[878,1216,933],{"class":892},[878,1218,1219],{"class":923},"carrier_id",[878,1221,951],{"class":892},[878,1223,1225,1228,1230],{"class":880,"line":1224},14,[878,1226,1227],{"class":884},"    except",[878,1229,1098],{"class":888},[878,1231,1168],{"class":892},[878,1233,1235,1238,1240,1243],{"class":880,"line":1234},15,[878,1236,1237],{"class":888},"        logger",[878,1239,893],{"class":892},[878,1241,1242],{"class":923},"warning",[878,1244,1245],{"class":892},"(\n",[878,1247,1249,1252,1256,1259,1261,1264],{"class":880,"line":1248},16,[878,1250,1251],{"class":957},"            f",[878,1253,1255],{"class":1254},"sfazB","\"No plate detected at ",[878,1257,1258],{"class":936},"{",[878,1260,1219],{"class":923},[878,1262,1263],{"class":936},"}",[878,1265,1266],{"class":1254},". \"\n",[878,1268,1270,1273,1276],{"class":880,"line":1269},17,[878,1271,1272],{"class":892},"            \"",[878,1274,1275],{"class":1254},"Seat the plate fully, then click Resume.",[878,1277,1278],{"class":892},"\"\n",[878,1280,1282],{"class":880,"line":1281},18,[878,1283,1284],{"class":892},"        )\n",[878,1286,1288,1291,1294],{"class":880,"line":1287},19,[878,1289,1290],{"class":884},"        await",[878,1292,1293],{"class":923}," pause_flow_run",[878,1295,1131],{"class":892},[878,1297,1299,1301,1303,1306,1308,1311,1314,1316],{"class":880,"line":1298},20,[878,1300,1237],{"class":888},[878,1302,893],{"class":892},[878,1304,1305],{"class":923},"info",[878,1307,926],{"class":892},[878,1309,1310],{"class":892},"\"",[878,1312,1313],{"class":1254},"Operator resumed — retrying detection.",[878,1315,1310],{"class":892},[878,1317,951],{"class":892},[878,1319,1321,1323,1325,1327,1329,1331,1333,1335,1337,1339,1341,1343,1345],{"class":880,"line":1320},21,[878,1322,1194],{"class":888},[878,1324,933],{"class":892},[878,1326,1199],{"class":884},[878,1328,1202],{"class":923},[878,1330,926],{"class":892},[878,1332,1146],{"class":929},[878,1334,933],{"class":892},[878,1336,1146],{"class":923},[878,1338,940],{"class":892},[878,1340,1151],{"class":929},[878,1342,933],{"class":892},[878,1344,1219],{"class":923},[878,1346,951],{"class":892},[878,1348,1350,1353,1356,1358,1360,1362,1364,1367,1369,1372,1375,1377,1379,1382,1385,1387,1390,1392],{"class":880,"line":1349},22,[878,1351,1352],{"class":884},"    return",[878,1354,1355],{"class":892}," {",[878,1357,1310],{"class":892},[878,1359,1146],{"class":1254},[878,1361,1310],{"class":892},[878,1363,972],{"class":892},[878,1365,1366],{"class":888}," lh",[878,1368,940],{"class":892},[878,1370,1371],{"class":892}," \"",[878,1373,1374],{"class":1254},"target_slot",[878,1376,1310],{"class":892},[878,1378,972],{"class":892},[878,1380,1381],{"class":888}," result",[878,1383,1384],{"class":892},"[",[878,1386,1310],{"class":892},[878,1388,1389],{"class":1254},"slot",[878,1391,1310],{"class":892},[878,1393,1394],{"class":892},"]}\n",[756,1396,1397,1398,1401],{},"Use ",[760,1399,1400],{},"try\u002Ffinally"," to guarantee cleanup regardless of outcome:",[868,1403,1406],{"className":870,"code":1404,"filename":1405,"language":873,"meta":874,"style":874},"@phase()\nasync def dispensing_phase(lh) -> dict:\n    try:\n        lh = await distribute(lh=lh, volume=100.0)\n    finally:\n        lh = await return_tips(lh=lh)  # always runs — success, error, or cancellation\n    return {\"lh\": lh}\n","workflows\u002Fdispensing.py",[760,1407,1408,1416,1437,1443,1474,1481,1506],{"__ignoreMap":874},[878,1409,1410,1412,1414],{"class":880,"line":881},[878,1411,920],{"class":892},[878,1413,448],{"class":923},[878,1415,1131],{"class":892},[878,1417,1418,1420,1422,1425,1427,1429,1431,1433,1435],{"class":880,"line":910},[878,1419,958],{"class":957},[878,1421,961],{"class":957},[878,1423,1424],{"class":923}," dispensing_phase",[878,1426,926],{"class":892},[878,1428,1146],{"class":929},[878,1430,1159],{"class":892},[878,1432,1162],{"class":892},[878,1434,1165],{"class":985},[878,1436,1168],{"class":892},[878,1438,1439,1441],{"class":880,"line":917},[878,1440,1186],{"class":884},[878,1442,1168],{"class":892},[878,1444,1445,1448,1450,1452,1455,1457,1459,1461,1463,1465,1467,1469,1472],{"class":880,"line":954},[878,1446,1447],{"class":888},"        lh ",[878,1449,933],{"class":892},[878,1451,1199],{"class":884},[878,1453,1454],{"class":923}," distribute",[878,1456,926],{"class":892},[878,1458,1146],{"class":929},[878,1460,933],{"class":892},[878,1462,1146],{"class":923},[878,1464,940],{"class":892},[878,1466,980],{"class":929},[878,1468,933],{"class":892},[878,1470,1471],{"class":936},"100.0",[878,1473,951],{"class":892},[878,1475,1476,1479],{"class":880,"line":992},[878,1477,1478],{"class":884},"    finally",[878,1480,1168],{"class":892},[878,1482,1483,1485,1487,1489,1492,1494,1496,1498,1500,1502],{"class":880,"line":1108},[878,1484,1447],{"class":888},[878,1486,933],{"class":892},[878,1488,1199],{"class":884},[878,1490,1491],{"class":923}," return_tips",[878,1493,926],{"class":892},[878,1495,1146],{"class":929},[878,1497,933],{"class":892},[878,1499,1146],{"class":923},[878,1501,1159],{"class":892},[878,1503,1505],{"class":1504},"sHwdD","  # always runs — success, error, or cancellation\n",[878,1507,1508,1510,1512,1514,1516,1518,1520,1522],{"class":880,"line":1114},[878,1509,1352],{"class":884},[878,1511,1355],{"class":892},[878,1513,1310],{"class":892},[878,1515,1146],{"class":1254},[878,1517,1310],{"class":892},[878,1519,972],{"class":892},[878,1521,1366],{"class":888},[878,1523,1524],{"class":892},"}\n",[756,1526,1527,1528,1532],{},"See ",[1529,1530,519],"a",{"href":1531},"\u002Fautomate\u002Fguides\u002Fbasic-error-handling\u002F"," for more patterns.",[790,1534,1536],{"id":1535},"workflow-level-propagation-and-setting-a-checkpoint","Workflow level: propagation and setting a checkpoint",[756,1538,1539,1540,1542,1543,1546],{},"If a phase fails and no ",[760,1541,762],{}," handles the error, the failure propagates to the workflow. The run is marked as ",[760,1544,1545],{},"FAILED"," and the workflow engine records the last completed phase as a checkpoint.",[756,1548,1549],{},"Because phases always end in stable states, a failed run can be resumed from the last successful phase — either automatically or by an operator.",[790,1551,1553],{"id":1552},"summary","Summary",[868,1555,1560],{"className":1556,"code":1558,"language":1559},[1557],"language-text","Step fails\n  └── Technical error → retry (up to N times)\n        └── Still failing → propagate to phase\n\nPhase receives error\n  └── try\u002Fexcept → pause for operator, retry, or return error\n  └── No handler → propagate to workflow\n\nWorkflow receives error\n  └── Run marked FAILED at last stable checkpoint\n  └── Operator can resume from checkpoint\n","text",[760,1561,1558],{"__ignoreMap":874},[790,1563,1565],{"id":1564},"related-concepts","Related concepts",[1567,1568,1569,1576,1586],"ul",{},[1570,1571,1572,1575],"li",{},[1529,1573,468],{"href":1574},"\u002Fautomate\u002Fconcepts\u002Fstep\u002F",": where retries are configured",[1570,1577,1578,1581,1582,1585],{},[1529,1579,488],{"href":1580},"\u002Fautomate\u002Fconcepts\u002Fhuman-in-the-loop\u002F",": using ",[760,1583,1584],{},"pause_flow_run()"," for operator-assisted recovery",[1570,1587,1588,1591],{},[1529,1589,472],{"href":1590},"\u002Fautomate\u002Fconcepts\u002Fruns\u002F",": run states and checkpoint-based resumption",[790,1593,187],{"id":1594},"guides",[1567,1596,1597,1602],{},[1570,1598,1599],{},[1529,1600,1601],{"href":1531},"Basic error handling",[1570,1603,1604],{},[1529,1605,523],{"href":1606},"\u002Fautomate\u002Fguides\u002Fadvanced-error-handling\u002F",[1608,1609,1610],"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 .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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 .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}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 .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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}",{"title":874,"searchDepth":881,"depth":910,"links":1612},[1613,1614,1615,1616,1617,1618,1619],{"id":792,"depth":910,"text":793},{"id":862,"depth":910,"text":863},{"id":1029,"depth":910,"text":1030},{"id":1535,"depth":910,"text":1536},{"id":1552,"depth":910,"text":1553},{"id":1564,"depth":910,"text":1565},{"id":1594,"depth":910,"text":187},"How errors are classified, retried, and recovered at each level of the workflow hierarchy — from automatic step retries to operator-assisted recovery.","md",null,{},{"title":183,"description":1620},"FjGSXqU2TOSux73wmBtqzgfYt5JUVactBZfSji3vFnQ",[1627,1629],{"title":488,"path":489,"stem":490,"description":1628},"Pause a workflow run to request a human decision or physical action before continuing.",{"title":499,"path":500,"stem":501,"description":1630},"Bundle a workflow from a workflow-template repo and ship it to the UniteLabs platform with scripts\u002Fdeploy.py.",1783607788989]