[{"data":1,"prerenderedAt":747},["ShallowReactive",2],{"docs:en:\u002Fdocs\u002Fworkflows\u002Ffirst-workflow":3},{"page":4,"navigation":623,"surround":742,"prefix":626},{"id":5,"title":6,"body":7,"description":615,"extension":616,"meta":617,"navigation":618,"path":619,"seo":620,"stem":621,"__hash__":622},"agentDocs\u002Fdocs\u002F4.workflows\u002F1.first-workflow.md","Your first workflow",{"type":8,"value":9,"toc":602},"minimark",[10,14,19,53,56,60,96,104,108,114,142,148,151,155,162,182,189,229,236,239,243,304,314,317,331,335,342,351,390,405,412,416,445,448,451,462,466,472,475,509,515,519,522,590],[11,12,13],"p",{},"You build a workflow that creates a contact and a deal in the CRM from every new email in the mailbox. It asks you before it creates them.",[15,16,18],"h2",{"id":17},"prerequisites","Prerequisites",[20,21,22,39,42],"ul",{},[23,24,25,26,30,31,34,35,38],"li",{},"You may build (the role ",[27,28,29],"strong",{},"admin",", or the former role ",[27,32,33],{},"developer","). With the role ",[27,36,37],{},"member",", you land on the workflow list instead of the builder.",[23,40,41],{},"You have connected an account for every service of the workflow, in the example Outlook Mail and Pipedrive. The test run fetches real emails from your account. Without a connection there is no test event.",[23,43,44,45,48,49,52],{},"The workspace has credit. Every model call costs money, when building in the chat just like in every run. ",[27,46,47],{},"Settings"," shows the balance in the section ",[27,50,51],{},"Credit",". If it is empty, the app answers \"Your credit is used up.\"",[11,54,55],{},"In a workspace that a partner looks after, the partner builds. The client's people see no build functions there, regardless of their role.",[15,57,59],{"id":58},"describe-the-workflow","Describe the workflow",[61,62,63,70,76,83,90],"ol",{},[23,64,65,66,69],{},"Click ",[27,67,68],{},"New chat"," in the sidebar.",[23,71,65,72,75],{},[27,73,74],{},"Create workflow"," below the input field.",[23,77,78,79],{},"Describe the process in your own words, for example: ",[80,81,82],"em",{},"When a new email arrives in the inbox and looks like an enquiry, create a contact and a deal in Pipedrive. Ask me first.",[23,84,85,86,89],{},"Send the message. As soon as the trigger or the process is clear, the chat shows the card ",[27,87,88],{},"Build workflow",".",[23,91,65,92,95],{},[27,93,94],{},"Build",". The builder opens with your description and starts building at once.",[11,97,98,99,89],{},"The interface is German, but you can write the description in any language. Other ways into the builder, such as an empty workflow or a template, are described under ",[100,101,103],"a",{"href":102},"\u002Fdocs\u002Fworkflows\u002Fbuilder","The builder",[15,105,107],{"id":106},"answer-questions-during-the-build","Answer questions during the build",[11,109,110,111,113],{},"The Co-Builder is the chat in the column ",[27,112,94],{}," on the left of the builder. It creates the steps on the canvas itself. While it does, it asks for fixed values that only you know, such as mailbox, folder or recipient.",[61,115,116,119,126,136,139],{},[23,117,118],{},"Answer its questions in the chat.",[23,120,121,122,125],{},"Wait until the card ",[27,123,124],{},"Build plan"," has ticked off all steps.",[23,127,65,128,131,132,135],{},[27,129,130],{},"Connect"," in the card ",[27,133,134],{},"Connection missing",", if it appears.",[23,137,138],{},"Read the last message. It says whether the workflow is executable or whether fixed values are still open.",[23,140,141],{},"Supply open values in the chat or enter them directly on the step.",[11,143,144,145,89],{},"For SharePoint and OneDrive locations and for Teams channels and chats, the chat shows a picker instead of a question. There you click ",[27,146,147],{},"Apply",[11,149,150],{},"You do not need to save anything. The builder saves the draft after every change.",[15,152,154],{"id":153},"check-the-steps","Check the steps",[11,156,157,158,161],{},"Every workflow has exactly one ",[27,159,160],{},"Trigger",", always as the first card. Steps of three kinds follow:",[20,163,164,170,176],{},[23,165,166,169],{},[27,167,168],{},"Agent",": works with a model and with tools.",[23,171,172,175],{},[27,173,174],{},"Action",": runs exactly one operation from the catalog, without a model.",[23,177,178,181],{},[27,179,180],{},"Condition",": branches on the value of a field, without a model.",[11,183,184,185,89],{},"Approvals are not cards of their own. They are a switch on the tool of an agent or an action. What each kind can do is described under ",[100,186,188],{"href":187},"\u002Fdocs\u002Fworkflows\u002Fsteps","Steps",[61,190,191,205,215],{},[23,192,193,194,197,198,201,202,89],{},"Click the card of the CRM step. The dialog shows three tiles: ",[27,195,196],{},"Input",", ",[27,199,200],{},"Work"," and ",[27,203,204],{},"Output",[23,206,207,208,211,212,214],{},"Check the ",[27,209,210],{},"Instruction"," in ",[27,213,200],{},". The step works by it, and it must not be empty.",[23,216,217,218,201,221,224,225,228],{},"Check the tools ",[27,219,220],{},"Create contact",[27,222,223],{},"Create deal",". Both write, so their switch ",[27,226,227],{},"Approval"," is on. The run stops before each call and asks you.",[11,230,231,232,235],{},"If you switch approval off, the tool shows ",[27,233,234],{},"Without approval",", and the agent creates the entries immediately.",[11,237,238],{},"If a card has a red border, a line above it gives the reason, for example \"Not reachable from the trigger, connect the flow\". The sparkle on this line hands the problem to the chat.",[15,240,242],{"id":241},"set-the-trigger","Set the trigger",[61,244,245,250,263,272,281,294],{},[23,246,247,248,89],{},"Click the card ",[27,249,160],{},[23,251,252,253,255,256,259,260,89],{},"In the tile ",[27,254,160],{},", choose ",[27,257,258],{},"Integration"," in the field ",[27,261,262],{},"Kind",[23,264,265,266,269,270,89],{},"Choose the app ",[27,267,268],{},"Outlook Mail"," under ",[27,271,258],{},[23,273,274,275,269,278,89],{},"Choose ",[27,276,277],{},"New email",[27,279,280],{},"Event",[23,282,283,284,269,287,289,290,89],{},"Check the field ",[27,285,286],{},"Folder",[27,288,47],{},". The default is ",[291,292,293],"code",{},"inbox",[23,295,296,297,300,301,89],{},"Describe under ",[27,298,299],{},"Responsibility"," which emails the workflow should handle, for example ",[80,302,303],{},"only enquiries from new prospects, no newsletters, no invoices",[11,305,306,307,309,310,313],{},"If you leave ",[27,308,299],{}," empty, the workflow handles every email. An email that does not fit ends as ",[27,311,312],{},"Skipped",", with a visible reason.",[11,315,316],{},"The trigger names no account. Each person chooses their own Outlook Mail account when they set the workflow up for themselves.",[11,318,319,320,323,324,326,327,330],{},"With this trigger, a step cannot ask you questions in the middle of the run, because nobody is at the screen. The switch ",[27,321,322],{},"Questions"," in the tile ",[27,325,200],{}," appears only with the trigger ",[27,328,329],{},"Form",". Approvals exist regardless.",[15,332,334],{"id":333},"test-with-a-real-email","Test with a real email",[11,336,337,338,341],{},"The panel ",[27,339,340],{},"Test run"," hangs below the trigger card.",[343,344,345],"warning",{},[11,346,347,348,350],{},"A test run behaves as in production. Anything set to ",[27,349,234],{}," really writes.",[61,352,353,359,362,367,377,387],{},[23,354,65,355,358],{},[27,356,357],{},"Load latest events"," in the panel. The builder fetches real messages from your connected account.",[23,360,361],{},"Select a message.",[23,363,65,364,89],{},[27,365,366],{},"Test with this event",[23,368,369,370,372,373,376],{},"Wait until the run reaches ",[27,371,220],{},". The card then shows ",[27,374,375],{},"Waiting for your approval"," with the real values.",[23,378,65,379,382,383,386],{},[27,380,381],{},"Approve"," or ",[27,384,385],{},"Reject"," on the card.",[23,388,389],{},"Check the result line below each card.",[11,391,392,393,396,397,400,401,404],{},"There are no invented test emails. With ",[27,394,395],{},"Trigger only"," in the menu next to the button, the test runs only as far as past the trigger. ",[27,398,399],{},"Stop"," aborts a running test. The ▶ on a card (",[27,402,403],{},"This step only",") repeats this step against the current draft without restarting the run.",[11,406,407,408,411],{},"If the panel blocks, it names the reason itself. All test runs collect in the drawer ",[27,409,410],{},"Runs"," at the bottom edge of the canvas.",[15,413,415],{"id":414},"publish-the-workflow","Publish the workflow",[61,417,418,431],{},[23,419,65,420,423,424,427,428,89],{},[27,421,422],{},"Publish"," at the top right. The saved draft becomes an immutable version. The display next to the button changes from ",[27,425,426],{},"Draft"," to ",[27,429,430],{},"v1",[23,432,65,433,436,437,440,441,444],{},[27,434,435],{},"Set up for me"," in the dialog ",[27,438,439],{},"Version 1 published",". ",[27,442,443],{},"Later"," postpones it.",[11,446,447],{},"Publishing starts nothing and stops nothing.",[11,449,450],{},"If the workflow is not executable, lowcloud refuses with \"Workflow cannot be published: …\", followed by the findings, such as open fixed values. Further reasons for a refusal include:",[20,452,453,456,459],{},[23,454,455],{},"The workflow uses a deleted agent.",[23,457,458],{},"A workflow that the team sees contains a private agent, skill or bucket.",[23,460,461],{},"The trigger is a webhook.",[15,463,465],{"id":464},"set-it-up-for-yourself","Set it up for yourself",[467,468,469],"note",{},[11,470,471],{},"A published workflow does nothing until at least one person sets it up for themselves.",[11,473,474],{},"A setup belongs to one person, is tied to exactly one version and runs through that person's accounts.",[61,476,477,494,504],{},[23,478,65,479,481,482,485,486,489,490,493],{},[27,480,435],{},". The button is in the dialog after publishing, as ",[27,483,484],{},"Set up"," in the row on the page ",[27,487,488],{},"Agents",", and in the tab ",[27,491,492],{},"Setups"," on the workflow page.",[23,495,496,497,500,501,89],{},"The dialog lists every service. Choose your account in each row under ",[27,498,499],{},"Choose account",". If you have none for a service yet, click the button with its name, for example ",[27,502,503],{},"Connect Outlook Mail",[23,505,65,506,508],{},[27,507,484],{},". From now on the workflow runs through your accounts.",[11,510,511,512,89],{},"If you publish a new version later, every setup stays on its version, yours too. Each person switches with ",[27,513,514],{},"Update to v2",[15,516,518],{"id":517},"view-the-first-run","View the first run",[11,520,521],{},"The trigger checks once a minute. The first check after setup processes nothing yet. So about two minutes can pass before the first real run.",[523,524,525,538],"table",{},[526,527,528],"thead",{},[529,530,531,535],"tr",{},[532,533,534],"th",{},"Place",[532,536,537],{},"What it shows",[539,540,541,552,562,576],"tbody",{},[529,542,543,549],{},[544,545,546,548],"td",{},[27,547,410],{}," in the sidebar",[544,550,551],{},"The latest runs across all workflows, with status, workflow, input, time and duration",[529,553,554,559],{},[544,555,556,548],{},[27,557,558],{},"Approvals",[544,560,561],{},"Your open approvals and questions. The number on the entry is their count.",[529,563,564,570],{},[544,565,566,567],{},"Workflow page, tab ",[27,568,569],{},"Overview",[544,571,572,573,575],{},"The section ",[27,574,410],{}," with the history of this workflow",[529,577,578,583],{},[544,579,580,581],{},"Builder, drawer ",[27,582,410],{},[544,584,585,586,589],{},"Test runs and production runs of this workflow, with a timeline and ",[27,587,588],{},"Replay"," on the diagram",[11,591,592,593,595,596,598,599,89],{},"A run whose email did not fit the ",[27,594,299],{}," appears as ",[27,597,312],{}," in the history and is hidden there by default. What a run shows is described under ",[100,600,410],{"href":601},"\u002Fdocs\u002Fworkflows\u002Fruns",{"title":603,"searchDepth":604,"depth":604,"links":605},"",2,[606,607,608,609,610,611,612,613,614],{"id":17,"depth":604,"text":18},{"id":58,"depth":604,"text":59},{"id":106,"depth":604,"text":107},{"id":153,"depth":604,"text":154},{"id":241,"depth":604,"text":242},{"id":333,"depth":604,"text":334},{"id":414,"depth":604,"text":415},{"id":464,"depth":604,"text":465},{"id":517,"depth":604,"text":518},"Describe a workflow in the chat, test it, publish it and set it up for yourself.","md",{},true,"\u002Fdocs\u002Fworkflows\u002Ffirst-workflow",{"title":6,"description":615},"docs\u002F4.workflows\u002F1.first-workflow","Y0EhlyCtZ6M426wAe1r8-rzm-0zw_k6RGSbmWcCP5kg",[624],{"title":625,"path":626,"stem":627,"children":628,"page":-1},"Docs","\u002Fdocs","docs",[629,632,650,655,680,701,705,719,724],{"title":630,"path":626,"stem":631},"Documentation","docs\u002Findex",{"title":633,"icon":634,"path":635,"stem":636,"children":637,"page":649},"Getting started","i-lucide-compass","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",[638,641,645],{"title":569,"path":639,"stem":640},"\u002Fdocs\u002Fgetting-started\u002Foverview","docs\u002F1.getting-started\u002F1.overview",{"title":642,"path":643,"stem":644},"Quickstart","\u002Fdocs\u002Fgetting-started\u002Fquickstart","docs\u002F1.getting-started\u002F2.quickstart",{"title":646,"path":647,"stem":648},"Glossary","\u002Fdocs\u002Fgetting-started\u002Fglossary","docs\u002F1.getting-started\u002F3.glossary",false,{"title":651,"path":652,"stem":653,"icon":654},"Chat","\u002Fdocs\u002Fchat","docs\u002F2.chat","i-lucide-message-circle",{"title":488,"icon":656,"path":657,"stem":658,"children":659,"page":649},"i-lucide-bot","\u002Fdocs\u002Fagents","docs\u002F3.agents",[660,664,668,672,676],{"title":661,"path":662,"stem":663},"Building agents","\u002Fdocs\u002Fagents\u002Fbuilding","docs\u002F3.agents\u002F1.building",{"title":665,"path":666,"stem":667},"Knowledge","\u002Fdocs\u002Fagents\u002Fknowledge","docs\u002F3.agents\u002F2.knowledge",{"title":669,"path":670,"stem":671},"Skills","\u002Fdocs\u002Fagents\u002Fskills","docs\u002F3.agents\u002F3.skills",{"title":673,"path":674,"stem":675},"Sharing and access","\u002Fdocs\u002Fagents\u002Fsharing","docs\u002F3.agents\u002F4.sharing",{"title":677,"path":678,"stem":679},"Microsoft Teams","\u002Fdocs\u002Fagents\u002Fteams","docs\u002F3.agents\u002F5.teams",{"title":681,"icon":682,"path":683,"stem":684,"children":685,"page":649},"Workflows","i-lucide-workflow","\u002Fdocs\u002Fworkflows","docs\u002F4.workflows",[686,687,689,691,695,699],{"title":6,"path":619,"stem":621},{"title":103,"path":102,"stem":688},"docs\u002F4.workflows\u002F2.builder",{"title":188,"path":187,"stem":690},"docs\u002F4.workflows\u002F3.steps",{"title":692,"path":693,"stem":694},"Triggers","\u002Fdocs\u002Fworkflows\u002Ftriggers","docs\u002F4.workflows\u002F4.triggers",{"title":696,"path":697,"stem":698},"Publishing and setup","\u002Fdocs\u002Fworkflows\u002Fpublishing","docs\u002F4.workflows\u002F5.publishing",{"title":410,"path":601,"stem":700},"docs\u002F4.workflows\u002F6.runs",{"title":558,"path":702,"stem":703,"icon":704},"\u002Fdocs\u002Fapprovals","docs\u002F5.approvals","i-lucide-check-check",{"title":706,"icon":707,"path":708,"stem":709,"children":710,"page":649},"Integrations","i-lucide-cable","\u002Fdocs\u002Fconnections","docs\u002F6.connections",[711,715],{"title":712,"path":713,"stem":714},"Connecting services","\u002Fdocs\u002Fconnections\u002Fservices","docs\u002F6.connections\u002F1.services",{"title":716,"path":717,"stem":718},"Custom integrations and MCP","\u002Fdocs\u002Fconnections\u002Fcustom","docs\u002F6.connections\u002F2.custom",{"title":720,"path":721,"stem":722,"icon":723},"Sovereignty","\u002Fdocs\u002Fsovereignty","docs\u002F7.sovereignty","i-lucide-shield-check",{"title":725,"icon":726,"path":727,"stem":728,"children":729,"page":649},"Workspace","i-lucide-users","\u002Fdocs\u002Fworkspace","docs\u002F8.workspace",[730,734,738],{"title":731,"path":732,"stem":733},"Workspace and roles","\u002Fdocs\u002Fworkspace\u002Froles","docs\u002F8.workspace\u002F1.roles",{"title":735,"path":736,"stem":737},"Credit and costs","\u002Fdocs\u002Fworkspace\u002Fcosts","docs\u002F8.workspace\u002F2.costs",{"title":739,"path":740,"stem":741},"Partner","\u002Fdocs\u002Fworkspace\u002Fpartner","docs\u002F8.workspace\u002F3.partner",[743,745],{"title":677,"path":678,"stem":679,"description":744,"children":-1},"Let an agent answer in a 1:1 chat in Microsoft Teams through a Teams bot.",{"title":103,"path":102,"stem":688,"description":746,"children":-1},"Build a workflow in the chat or by hand, test it and publish versions.",1791184597181]