[{"data":1,"prerenderedAt":333},["ShallowReactive",2],{"\u002Fdocs\u002Ftroubleshooting":3,"docs-navigation":258,"docs-surround:\u002Fdocs\u002Ftroubleshooting":330},{"id":4,"title":5,"body":6,"description":249,"extension":250,"meta":251,"navigation":252,"path":253,"seo":254,"stem":256,"__hash__":257},"docs\u002Fdocs\u002F5.troubleshooting.md","Troubleshooting",{"type":7,"value":8,"toc":237},"minimark",[9,13,18,21,45,48,52,54,68,71,75,78,81,98,101,105,108,110,130,133,137,140,143,150,154,157,160,175,178,182,184,204,207,211,214,217,234],[10,11,12],"p",{},"Most workflow problems come from a small set of causes. Start with the failed or paused node, then use the sections below.",[14,15,17],"h2",{"id":16},"integration-connection-failed","Integration connection failed",[10,19,20],{},"Check:",[22,23,24,28,31,34,37],"ul",{},[25,26,27],"li",{},"The account is still connected.",[25,29,30],{},"The provider granted the permissions the workflow needs.",[25,32,33],{},"Credentials are current.",[25,35,36],{},"The integration uses the expected account, workspace, board, folder, or project.",[25,38,39,40,44],{},"The workflow node lists the correct integration ",[41,42,43],"code",{},"referenceId",".",[10,46,47],{},"If the integration has a connection check, run it after changing credentials.",[14,49,51],{"id":50},"the-workflow-cannot-find-a-file-or-record","The workflow cannot find a file or record",[10,53,20],{},[22,55,56,59,62,65],{},[25,57,58],{},"The file, folder, board, sheet, issue, or record still exists.",[25,60,61],{},"The connected account has access to it.",[25,63,64],{},"The workflow is using a stable ID rather than a display name when possible.",[25,66,67],{},"The task instruction tells the agent what to do if the item is missing.",[10,69,70],{},"For documents and folders that workflows use repeatedly, store stable IDs as workflow variables.",[14,72,74],{"id":73},"a-task-node-gave-the-wrong-answer","A task node gave the wrong answer",[10,76,77],{},"Task nodes need clear instructions.",[10,79,80],{},"Improve the instruction by saying:",[22,82,83,86,89,92,95],{},[25,84,85],{},"What source data to inspect.",[25,87,88],{},"Which rules to follow.",[25,90,91],{},"What to return when data is missing.",[25,93,94],{},"Which fields must be present in the output.",[25,96,97],{},"What not to infer or invent.",[10,99,100],{},"If the task is doing too much, split it into two smaller task nodes.",[14,102,104],{"id":103},"a-code-node-failed","A code node failed",[10,106,107],{},"Code nodes expect structured input.",[10,109,20],{},[22,111,112,115,118,121,124],{},[25,113,114],{},"The upstream node returned the fields the code reads.",[25,116,117],{},"The code parses every integration response body.",[25,119,120],{},"The integration path is correct.",[25,122,123],{},"A non-2xx provider response is handled only if it is an expected branch.",[25,125,126,127,44],{},"The output matches the node ",[41,128,129],{},"dataSchema",[10,131,132],{},"If the code is trying to interpret PDFs, images, documents, or email attachments, move that work into a task node first.",[14,134,136],{"id":135},"a-run-is-awaiting-input","A run is awaiting input",[10,138,139],{},"This usually means the run paused for a human node or browser reauthentication.",[10,141,142],{},"Open the run in Activity and complete the requested step.",[10,144,145,146,149],{},"If the human node looks complete but the workflow did not continue, check whether the action returned ",[41,147,148],{},"done: true"," and enough final state for downstream nodes.",[14,151,153],{"id":152},"a-browser-integration-needs-login","A browser integration needs login",[10,155,156],{},"Websites can expire sessions, require MFA, or change their login flow.",[10,158,159],{},"When a browser workflow pauses for reauthentication:",[161,162,163,166,169,172],"ol",{},[25,164,165],{},"Open the requested sign-in flow.",[25,167,168],{},"Complete login or MFA.",[25,170,171],{},"Return to the run.",[25,173,174],{},"Resume or rerun the workflow step.",[10,176,177],{},"If this happens often, add an early auth check to the browser step so the workflow pauses before doing other work.",[14,179,181],{"id":180},"yaml-is-invalid","YAML is invalid",[10,183,20],{},[22,185,186,189,192,195,198,201],{},[25,187,188],{},"There is exactly one YAML document.",[25,190,191],{},"There are no YAML anchors, aliases, or tags.",[25,193,194],{},"Node IDs match their keys.",[25,196,197],{},"Unknown keys have not been added.",[25,199,200],{},"Root JSON schemas are objects.",[25,202,203],{},"Required fields match what downstream nodes read.",[10,205,206],{},"If the workflow was generated by an agent, validate it before publishing.",[14,208,210],{"id":209},"a-workflow-should-have-paused-but-did-not","A workflow should have paused but did not",[10,212,213],{},"Add a human node before the risky action.",[10,215,216],{},"Good places to pause:",[22,218,219,222,225,228,231],{},[25,220,221],{},"Before sending an email.",[25,223,224],{},"Before deleting or overwriting data.",[25,226,227],{},"Before approving money movement.",[25,229,230],{},"When confidence is low.",[25,232,233],{},"When required input is missing.",[10,235,236],{},"Automation is most useful when it knows where not to be automatic.",{"title":238,"searchDepth":239,"depth":239,"links":240},"",2,[241,242,243,244,245,246,247,248],{"id":16,"depth":239,"text":17},{"id":50,"depth":239,"text":51},{"id":73,"depth":239,"text":74},{"id":103,"depth":239,"text":104},{"id":135,"depth":239,"text":136},{"id":152,"depth":239,"text":153},{"id":180,"depth":239,"text":181},{"id":209,"depth":239,"text":210},"Fix common problems with integrations, workflow runs, human input, browser sessions, and YAML.","md",{},"[object Object]","\u002Fdocs\u002Ftroubleshooting",{"title":255,"description":249},"Gondo Troubleshooting","docs\u002F5.troubleshooting","52q2NVJ1KEYIjz7t196WYbuBU8aiCrqcUOUdbDAYIDo",[259],{"title":260,"path":261,"stem":262,"children":263},"Docs","\u002Fdocs","docs",[264,268,273,294,309,329],{"title":265,"path":261,"stem":266,"description":267},"Gondo Docs","docs\u002Findex","Learn the basic ideas behind Gondo, from integrations and workflows to runs, approvals, and workflow YAML.",{"title":269,"path":270,"stem":271,"description":272},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started","Connect an integration, ask Gondo for help, build a workflow, and watch it run.",{"title":274,"path":275,"stem":276,"children":277,"page":293},"Concepts","\u002Fdocs\u002Fconcepts","docs\u002F2.concepts",[278,283,288],{"title":279,"path":280,"stem":281,"description":282},"Integrations","\u002Fdocs\u002Fconcepts\u002Fintegrations","docs\u002F2.concepts\u002F1.integrations","Integrations are the connected apps, accounts, websites, and systems Gondo can use.",{"title":284,"path":285,"stem":286,"description":287},"Workflows","\u002Fdocs\u002Fconcepts\u002Fworkflows","docs\u002F2.concepts\u002F2.workflows","Workflows are repeatable processes made from triggers, AI tasks, code, human review, and edges.",{"title":289,"path":290,"stem":291,"description":292},"Runs and Activity","\u002Fdocs\u002Fconcepts\u002Fruns-and-activity","docs\u002F2.concepts\u002F3.runs-and-activity","Learn what happens when a workflow runs and how to read statuses, approvals, failures, and reauth pauses.",false,{"title":295,"path":296,"stem":297,"children":298,"page":293},"Guides","\u002Fdocs\u002Fguides","docs\u002F3.guides",[299,304],{"title":300,"path":301,"stem":302,"description":303},"Connect an Integration","\u002Fdocs\u002Fguides\u002Fconnect-an-integration","docs\u002F3.guides\u002F1.connect-an-integration","Add a connected app or system so Gondo can use it in chats and workflows.",{"title":305,"path":306,"stem":307,"description":308},"Build Your First Workflow","\u002Fdocs\u002Fguides\u002Fbuild-your-first-workflow","docs\u002F3.guides\u002F2.build-your-first-workflow","A practical walkthrough for turning a plain-English process into a small Gondo workflow.",{"title":310,"path":311,"stem":312,"children":313,"page":293},"Reference","\u002Fdocs\u002Freference","docs\u002F4.reference",[314,319,324],{"title":315,"path":316,"stem":317,"description":318},"Workflow YAML","\u002Fdocs\u002Freference\u002Fworkflow-yaml","docs\u002F4.reference\u002F1.workflow-yaml","The technical shape of Gondo workflow definitions, including version, run display, variables, nodes, edges, and schema rules.",{"title":320,"path":321,"stem":322,"description":323},"Node Types","\u002Fdocs\u002Freference\u002Fnode-types","docs\u002F4.reference\u002F2.node-types","Reference for trigger, task, code, and human nodes, including configs and runtime context.",{"title":325,"path":326,"stem":327,"description":328},"Integration Tools","\u002Fdocs\u002Freference\u002Fintegration-tools","docs\u002F4.reference\u002F3.integration-tools","How integration tools, toolsets, scopes, disabled tools, and custom tools fit together.",{"title":5,"path":253,"stem":256,"description":249},[331,332],{"title":325,"path":326,"stem":327,"children":-1},null,1782191065483]