[{"data":1,"prerenderedAt":743},["ShallowReactive",2],{"docs:en:\u002Fdocs\u002Fworkflows\u002Fsteps":3},{"page":4,"navigation":617,"surround":738,"prefix":620},{"id":5,"title":6,"body":7,"description":609,"extension":610,"meta":611,"navigation":612,"path":613,"seo":614,"stem":615,"__hash__":616},"agentDocs\u002Fdocs\u002F4.workflows\u002F3.steps.md","Steps",{"type":8,"value":9,"toc":588},"minimark",[10,14,41,46,74,82,86,89,100,104,110,127,130,136,143,157,162,169,172,175,195,198,233,245,248,301,307,327,331,341,344,357,360,363,370,403,409,412,420,474,480,491,495,502,508,515,519,522,530,533,543,546,550,553,577,580],[11,12,13],"p",{},"A workflow consists of a trigger and steps. There are three kinds of steps:",[15,16,17,25,35],"ul",{},[18,19,20,24],"li",{},[21,22,23],"strong",{},"Agent",": a step with AI. It reads fields from the context and calls the tools you give it.",[18,26,27,30,31,34],{},[21,28,29],{},"Action",": a step without AI. It runs exactly one operation from the catalog, for example ",[21,32,33],{},"Send email",".",[18,36,37,40],{},[21,38,39],{},"Condition",": a branch without AI. It checks the value of a field and chooses the path accordingly.",[42,43,45],"h2",{"id":44},"add-a-step","Add a step",[47,48,49,56,71],"ol",{},[18,50,51,52,55],{},"Click a ",[21,53,54],{},"+"," on the canvas.",[18,57,58,59,62,63,65,66,68,69,34],{},"In the menu ",[21,60,61],{},"New step",", choose the kind: ",[21,64,23],{},", ",[21,67,29],{}," or ",[21,70,39],{},[18,72,73],{},"Click the new card to configure the step.",[11,75,76,77,34],{},"How you connect and test cards is described under ",[78,79,81],"a",{"href":80},"\u002Fdocs\u002Fworkflows\u002Fbuilder","The builder",[42,83,85],{"id":84},"trigger","Trigger",[11,87,88],{},"Every workflow has exactly one trigger. It is always at the start, has no incoming connection and exactly one outgoing one. It fills the first fields of the context, for an email for example sender, subject and content.",[11,90,91,92,95,96,34],{},"The field ",[21,93,94],{},"Responsibility"," on the trigger filters out unsuitable events. There is no separate card for this. The kinds of trigger and the responsibility are described under ",[78,97,99],{"href":98},"\u002Fdocs\u002Fworkflows\u002Ftriggers","Triggers",[42,101,103],{"id":102},"context","Context",[11,105,106,107,109],{},"The context is the list of fields of a workflow. The panel ",[21,108,103],{}," on the canvas shows all of them. The fields belong to the workflow, not to a step. Data does not flow along the arrows. Each step only sets which fields it reads and which it fills:",[15,111,112,118],{},[18,113,114,117],{},[21,115,116],{},"Input",": the fields the step reads. The trigger or an earlier step must have filled them before.",[18,119,120,123,124,34],{},[21,121,122],{},"Output",": the fields the step fills itself. It only moves on once each of them is filled or marked as ",[21,125,126],{},"No value",[11,128,129],{},"In the run, an agent sees the values of its input and output fields. Of all other fields it sees only the name and the state: filled or still empty. Anything that is not a field in the context is unknown to it.",[11,131,132,133,135],{},"If an agent cannot determine a promised value, it enters ",[21,134,126],{}," with a reason instead of making something up.",[11,137,138,139,142],{},"On the field you set ",[21,140,141],{},"Multiple entries",":",[15,144,145,151],{},[18,146,147,150],{},[21,148,149],{},"Replace"," (default): the newest value applies.",[18,152,153,156],{},[21,154,155],{},"Collect",": every entry is added.",[158,159,161],"h3",{"id":160},"content-from-outside","Content from outside",[11,163,164,165,168],{},"Fields with content from outside carry the marking ",[21,166,167],{},"External",". These are email contents, submissions from a public form and data from an integration. The agent receives the marking in the run, together with the rule to treat such content only as data and never to follow instructions in it.",[11,170,171],{},"For a trigger that delivers content from outside, lowcloud always sets the marking. This also applies to the fields of a start form on that trigger.",[42,173,23],{"id":174},"agent",[11,176,177,178,65,180,183,184,186,187,190,191,194],{},"A click on an agent card opens three tiles: ",[21,179,116],{},[21,181,182],{},"Work"," and ",[21,185,122],{},". You change the name of the step in the header of the dialog. Below it is the row ",[21,188,189],{},"Note",", a remark for you and for the chat in the column ",[21,192,193],{},"Build",". The agent never reads the note in the run.",[158,196,116],{"id":197},"input",[15,199,200,205,211,217],{},[18,201,202,204],{},[21,203,103],{},": the fields the step reads.",[18,206,207,210],{},[21,208,209],{},"Knowledge",": documents the agent searches in every run.",[18,212,213,216],{},[21,214,215],{},"Skills",": instructions from the skill library. The step looks one up when it needs it.",[18,218,219,222,223,183,226,229,230,232],{},[21,220,221],{},"Buckets",": shared collections that grow with every run. Each bucket has the switches ",[21,224,225],{},"Read",[21,227,228],{},"Write",". With ",[21,231,228],{},", the step stores things in it without asking.",[11,234,235,65,237,183,239,241,242,34],{},[21,236,209],{},[21,238,215],{},[21,240,221],{}," exist only with ",[21,243,244],{},"Own agent",[158,246,182],{"id":247},"work",[15,249,250,256,266,275,285,295],{},[18,251,252,255],{},[21,253,254],{},"Instruction",": the text the agent follows in the run. It says what the agent checks and what it is responsible for. If the instruction is missing, the dialog and the card point this out.",[18,257,258,261,262,265],{},[21,259,260],{},"Optimise text with AI",": rewrites your draft. ",[21,263,264],{},"Undo"," brings it back.",[18,267,268,271,272,34],{},[21,269,270],{},"Model",": needed only if this step requires a particular model. Otherwise it stays on ",[21,273,274],{},"Automatic",[18,276,277,280,281,284],{},[21,278,279],{},"Tools",": what the step may do itself, from the catalog. Add one with ",[21,282,283],{},"+ Tool",". The tools are grouped by service. You choose the account a service runs through in the header of its group.",[18,286,287,290,291,294],{},[21,288,289],{},"Limits"," > ",[21,292,293],{},"Work steps",": how many tool calls and messages to you the step may make per pass. The default is 6. Context maintenance, knowledge search and reading skills and files do not count.",[18,296,297,300],{},[21,298,299],{},"Questions",": if this switch is on, the step may ask you a question during the run and waits for the answer.",[11,302,303,304,306],{},"The switch ",[21,305,299],{}," exists only on a manual start, because then someone is watching. With email, schedule or a public form, the builder does not offer it. In a run that someone is watching, every step may also send you interim messages and keeps running. This does not depend on the switch.",[11,308,309,310,312,313,315,316,65,318,183,320,322,323,326],{},"Next to ",[21,311,254],{}," you choose ",[21,314,244],{}," or an agent from the library. An agent from the library brings its own model, tools and knowledge. ",[21,317,270],{},[21,319,279],{},[21,321,293],{}," then do not apply. Instead you choose under ",[21,324,325],{},"Accounts"," which account a service runs through. Per service, one account applies to all steps of the process.",[158,328,330],{"id":329},"set-fixed-values","Set fixed values",[11,332,333,334,68,337,340],{},"For each parameter of a tool you choose ",[21,335,336],{},"Agent decides",[21,338,339],{},"Fixed value",". The agent cannot change a fixed value, such as a recipient, a folder or a channel. If a fixed value stays empty, the card reports it, and the workflow cannot be published.",[158,342,122],{"id":343},"output",[11,345,346,347,349,350,352,353,356],{},"The tile ",[21,348,122],{}," shows under ",[21,351,103],{}," the fields the step fills, and under ",[21,354,355],{},"Next step"," the path after this step.",[42,358,29],{"id":359},"action",[11,361,362],{},"An action decides nothing and words nothing. It calls the tool with the inputs you define. Use an action when it is fixed which operation should run with which values. If the step has to weigh something up or word something, use an agent.",[11,364,365,366,183,368,142],{},"A click on the card opens the tiles ",[21,367,182],{},[21,369,122],{},[15,371,372,378,383,389,395],{},[18,373,374,377],{},[21,375,376],{},"Tool",": the one operation of the action, from the built-in operations of the catalog. For a different operation you create a new action.",[18,379,380,382],{},[21,381,325],{},": which account the service of the operation runs through.",[18,384,385,388],{},[21,386,387],{},"Inputs",": one value per parameter. This is a fixed value, a field from the context or text with fields. A field on its own is passed on unchanged.",[18,390,391,394],{},[21,392,393],{},"Result",": which value from the response lands in which field of the context. Later steps can then read it.",[18,396,397,399,400,34],{},[21,398,355],{},": another step or ",[21,401,402],{},"End",[404,405,406],"note",{},[11,407,408],{},"Custom integrations and MCP tools only work in an agent.",[42,410,39],{"id":411},"condition",[11,413,414,415,183,417,142],{},"For a decision, an agent enters a value into a field. The condition after it checks the field and chooses the path. A click on the card opens the tiles ",[21,416,116],{},[21,418,419],{},"Rules",[15,421,422,441,468],{},[18,423,424,427,428,65,431,65,434,68,437,440],{},[21,425,426],{},"Field",": the one field the condition checks. You can choose fields of the type ",[21,429,430],{},"Selection",[21,432,433],{},"Yes\u002Fno",[21,435,436],{},"Number",[21,438,439],{},"Date",". A field that collects entries cannot be checked.",[18,442,443,445,446,449,450,68,453,456,457,68,460,463,464,467],{},[21,444,419],{},": each rule consists of a comparison, a value and a target. The comparison depends on the type of the field, for example ",[21,447,448],{},"Is"," for a selection, ",[21,451,452],{},"Below",[21,454,455],{},"At least"," for a number, ",[21,458,459],{},"Before",[21,461,462],{},"After"," for a date. ",[21,465,466],{},"Is empty"," exists for every type.",[18,469,470,473],{},[21,471,472],{},"All others",": the last path. It applies when no rule matches.",[11,475,476,477,479],{},"The rules are read from top to bottom, and the first one that matches applies. Use the arrows on a rule to change the order. ",[21,478,402],{}," is also possible as the target of every path.",[11,481,482,483,485,486,488,489,34],{},"A field that was never filled or is marked as ",[21,484,126],{}," counts as empty. Without a rule with ",[21,487,466],{},", the run then takes the path ",[21,490,472],{},[42,492,494],{"id":493},"turn-approval-on-or-off","Turn approval on or off",[11,496,497,498,501],{},"Every tool in an agent and in an action has the switch ",[21,499,500],{},"Approval",". If it is on, the run stops before each call and shows you the arguments of the call for confirmation. If it is off, the step runs the tool immediately.",[11,503,504,505,34],{},"For tools that write or send something, approval is on by default. Reading tools run without asking. If you switch off approval on a writing tool, lowcloud asks you to confirm. After that the tool carries the marking ",[21,506,507],{},"Without approval",[11,509,510,511,34],{},"There is no separate card for approvals on the canvas. What an approval shows in the run and how you answer it is described under ",[78,512,514],{"href":513},"\u002Fdocs\u002Fapprovals","Approvals and questions",[42,516,518],{"id":517},"paths","Paths",[11,520,521],{},"The arrows between the cards are the paths. An agent and an action have at most one path:",[15,523,524,527],{},[18,525,526],{},"Without a path, the process ends after the step. The answer of an agent is then the answer of the run.",[18,528,529],{},"With one path, it always continues there.",[11,531,532],{},"Only a condition has several paths.",[11,534,535,536,539,540,542],{},"In the dialog of an agent, you add a path with ",[21,537,538],{},"+ Path"," as long as none is set. The path gets a short name and a target. You can also draw a path on the canvas, from the handle of the path row onto the target card. ",[21,541,402],{}," is also possible as a target. The run then ends successfully at this point, with the agent's short reason instead of a written answer.",[11,544,545],{},"Agents with two or more paths only remain in old workflows. There the agent chooses exactly one path at the end. Neither the dialog nor the chat creates such agents any more.",[42,547,549],{"id":548},"loops","Loops",[11,551,552],{},"If a path points back to an earlier step, a loop arises. The step then runs once more, with the latest state. There is no separate card for loops.",[11,554,555,556,559,560,563,564,566,567,569,570,572,573,576],{},"On the condition that sends the run back, the path ",[21,557,558],{},"Round limit"," appears with the field ",[21,561,562],{},"Rounds",". ",[21,565,562],{}," sets how many rounds the loop runs at most. The default is 3. After the last round, the run takes the path ",[21,568,558],{}," instead of going back into the loop. Its target is a step outside the loop or ",[21,571,402],{},". If the target is set to ",[21,574,575],{},"Abort",", the run aborts with an error after the last round.",[11,578,579],{},"If a loop has no exit, the card reports it.",[11,581,582,583,585,586,34],{},"In old workflows in which an agent with two or more paths decides the loop, ",[21,584,562],{}," sits on the agent under ",[21,587,289],{},{"title":589,"searchDepth":590,"depth":590,"links":591},"",2,[592,593,594,598,604,605,606,607,608],{"id":44,"depth":590,"text":45},{"id":84,"depth":590,"text":85},{"id":102,"depth":590,"text":103,"children":595},[596],{"id":160,"depth":597,"text":161},3,{"id":174,"depth":590,"text":23,"children":599},[600,601,602,603],{"id":197,"depth":597,"text":116},{"id":247,"depth":597,"text":182},{"id":329,"depth":597,"text":330},{"id":343,"depth":597,"text":122},{"id":359,"depth":590,"text":29},{"id":411,"depth":590,"text":39},{"id":493,"depth":590,"text":494},{"id":517,"depth":590,"text":518},{"id":548,"depth":590,"text":549},"Set up agents, actions and conditions and pass results on through the context.","md",{},true,"\u002Fdocs\u002Fworkflows\u002Fsteps",{"title":6,"description":609},"docs\u002F4.workflows\u002F3.steps","2Dwg5FvZtoh_LaF0tV1tGTp05m9O9PgqrWKaMFvBjAY",[618],{"title":619,"path":620,"stem":621,"children":622,"page":-1},"Docs","\u002Fdocs","docs",[623,626,645,650,674,697,701,715,720],{"title":624,"path":620,"stem":625},"Documentation","docs\u002Findex",{"title":627,"icon":628,"path":629,"stem":630,"children":631,"page":644},"Getting started","i-lucide-compass","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",[632,636,640],{"title":633,"path":634,"stem":635},"Overview","\u002Fdocs\u002Fgetting-started\u002Foverview","docs\u002F1.getting-started\u002F1.overview",{"title":637,"path":638,"stem":639},"Quickstart","\u002Fdocs\u002Fgetting-started\u002Fquickstart","docs\u002F1.getting-started\u002F2.quickstart",{"title":641,"path":642,"stem":643},"Glossary","\u002Fdocs\u002Fgetting-started\u002Fglossary","docs\u002F1.getting-started\u002F3.glossary",false,{"title":646,"path":647,"stem":648,"icon":649},"Chat","\u002Fdocs\u002Fchat","docs\u002F2.chat","i-lucide-message-circle",{"title":651,"icon":652,"path":653,"stem":654,"children":655,"page":644},"Agents","i-lucide-bot","\u002Fdocs\u002Fagents","docs\u002F3.agents",[656,660,663,666,670],{"title":657,"path":658,"stem":659},"Building agents","\u002Fdocs\u002Fagents\u002Fbuilding","docs\u002F3.agents\u002F1.building",{"title":209,"path":661,"stem":662},"\u002Fdocs\u002Fagents\u002Fknowledge","docs\u002F3.agents\u002F2.knowledge",{"title":215,"path":664,"stem":665},"\u002Fdocs\u002Fagents\u002Fskills","docs\u002F3.agents\u002F3.skills",{"title":667,"path":668,"stem":669},"Sharing and access","\u002Fdocs\u002Fagents\u002Fsharing","docs\u002F3.agents\u002F4.sharing",{"title":671,"path":672,"stem":673},"Microsoft Teams","\u002Fdocs\u002Fagents\u002Fteams","docs\u002F3.agents\u002F5.teams",{"title":675,"icon":676,"path":677,"stem":678,"children":679,"page":644},"Workflows","i-lucide-workflow","\u002Fdocs\u002Fworkflows","docs\u002F4.workflows",[680,684,686,687,689,693],{"title":681,"path":682,"stem":683},"Your first workflow","\u002Fdocs\u002Fworkflows\u002Ffirst-workflow","docs\u002F4.workflows\u002F1.first-workflow",{"title":81,"path":80,"stem":685},"docs\u002F4.workflows\u002F2.builder",{"title":6,"path":613,"stem":615},{"title":99,"path":98,"stem":688},"docs\u002F4.workflows\u002F4.triggers",{"title":690,"path":691,"stem":692},"Publishing and setup","\u002Fdocs\u002Fworkflows\u002Fpublishing","docs\u002F4.workflows\u002F5.publishing",{"title":694,"path":695,"stem":696},"Runs","\u002Fdocs\u002Fworkflows\u002Fruns","docs\u002F4.workflows\u002F6.runs",{"title":698,"path":513,"stem":699,"icon":700},"Approvals","docs\u002F5.approvals","i-lucide-check-check",{"title":702,"icon":703,"path":704,"stem":705,"children":706,"page":644},"Integrations","i-lucide-cable","\u002Fdocs\u002Fconnections","docs\u002F6.connections",[707,711],{"title":708,"path":709,"stem":710},"Connecting services","\u002Fdocs\u002Fconnections\u002Fservices","docs\u002F6.connections\u002F1.services",{"title":712,"path":713,"stem":714},"Custom integrations and MCP","\u002Fdocs\u002Fconnections\u002Fcustom","docs\u002F6.connections\u002F2.custom",{"title":716,"path":717,"stem":718,"icon":719},"Sovereignty","\u002Fdocs\u002Fsovereignty","docs\u002F7.sovereignty","i-lucide-shield-check",{"title":721,"icon":722,"path":723,"stem":724,"children":725,"page":644},"Workspace","i-lucide-users","\u002Fdocs\u002Fworkspace","docs\u002F8.workspace",[726,730,734],{"title":727,"path":728,"stem":729},"Workspace and roles","\u002Fdocs\u002Fworkspace\u002Froles","docs\u002F8.workspace\u002F1.roles",{"title":731,"path":732,"stem":733},"Credit and costs","\u002Fdocs\u002Fworkspace\u002Fcosts","docs\u002F8.workspace\u002F2.costs",{"title":735,"path":736,"stem":737},"Partner","\u002Fdocs\u002Fworkspace\u002Fpartner","docs\u002F8.workspace\u002F3.partner",[739,741],{"title":81,"path":80,"stem":685,"description":740,"children":-1},"Build a workflow in the chat or by hand, test it and publish versions.",{"title":99,"path":98,"stem":688,"description":742,"children":-1},"Start workflows by hand, through a link, on a schedule or on an event in an app.",1791184597769]