[{"data":1,"prerenderedAt":631},["ShallowReactive",2],{"navigation":3,"/workflows/running-and-scheduling":261,"/workflows/running-and-scheduling-surround":626},[4,22,50,83,125,161,194,205,231],{"title":5,"path":6,"stem":7,"children":8,"icon":16},"Getting Started","/getting-started","1.getting-started/1.index",[9,12,17],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-ph-house",{"title":13,"path":14,"stem":15,"icon":16},"Quickstart","/getting-started/quickstart","1.getting-started/2.quickstart","i-ph-rocket",{"title":18,"path":19,"stem":20,"icon":21},"Plans","/getting-started/plans","1.getting-started/3.plans","i-ph-credit-card",{"title":23,"path":24,"stem":25,"children":26,"icon":29},"Agents","/agents","2.agents/1.index",[27,30,35,40,45],{"title":28,"path":24,"stem":25,"icon":29},"Overview","i-ph-robot",{"title":31,"path":32,"stem":33,"icon":34},"Creating an agent","/agents/creating-an-agent","2.agents/2.creating-an-agent","i-ph-plus",{"title":36,"path":37,"stem":38,"icon":39},"Agent settings","/agents/settings","2.agents/3.settings","i-ph-gear",{"title":41,"path":42,"stem":43,"icon":44},"Memory","/agents/memory","2.agents/4.memory","i-ph-database",{"title":46,"path":47,"stem":48,"icon":49},"Residential proxy","/agents/proxy","2.agents/5.proxy","i-ph-globe-hemisphere-west",{"title":51,"path":52,"stem":53,"children":54,"icon":57},"Chats & Tasks","/chats-and-tasks","3.chats-and-tasks/1.index",[55,58,63,68,73,78],{"title":56,"path":52,"stem":53,"icon":57},"Chats","i-ph-chats-circle",{"title":59,"path":60,"stem":61,"icon":62},"Sharing chats","/chats-and-tasks/sharing-chats","3.chats-and-tasks/2.sharing-chats","i-ph-share-network",{"title":64,"path":65,"stem":66,"icon":67},"Tasks","/chats-and-tasks/tasks","3.chats-and-tasks/3.tasks","i-ph-list-checks",{"title":69,"path":70,"stem":71,"icon":72},"Recurring tasks","/chats-and-tasks/recurring-tasks","3.chats-and-tasks/4.recurring-tasks","i-ph-repeat",{"title":74,"path":75,"stem":76,"icon":77},"Results & deliverables","/chats-and-tasks/results-and-deliverables","3.chats-and-tasks/5.results-and-deliverables","i-ph-package",{"title":79,"path":80,"stem":81,"icon":82},"Save a chat as a skill","/chats-and-tasks/save-chat-as-skill","3.chats-and-tasks/6.save-chat-as-skill","i-ph-sparkle",{"title":84,"path":85,"stem":86,"children":87,"icon":90},"Models & Skills","/models-and-skills","4.models-and-skills/1.index",[88,91,96,101,105,110,115,120],{"title":89,"path":85,"stem":86,"icon":90},"LLM configuration","i-ph-cpu",{"title":92,"path":93,"stem":94,"icon":95},"Providers & models","/models-and-skills/providers","4.models-and-skills/2.providers","i-ph-stack",{"title":97,"path":98,"stem":99,"icon":100},"Bring your own key","/models-and-skills/byok","4.models-and-skills/3.byok","i-ph-key",{"title":102,"path":103,"stem":104,"icon":29},"ChatGPT subscription","/models-and-skills/chatgpt-subscription","4.models-and-skills/4.chatgpt-subscription",{"title":106,"path":107,"stem":108,"icon":109},"Skills","/models-and-skills/skills","4.models-and-skills/5.skills","i-ph-puzzle-piece",{"title":111,"path":112,"stem":113,"icon":114},"Installing skills","/models-and-skills/installing-skills","4.models-and-skills/6.installing-skills","i-ph-download-simple",{"title":116,"path":117,"stem":118,"icon":119},"Custom skills","/models-and-skills/custom-skills","4.models-and-skills/7.custom-skills","i-ph-code",{"title":121,"path":122,"stem":123,"icon":124},"Local models","/models-and-skills/local-models","4.models-and-skills/8.local-models","i-ph-desktop-tower",{"title":126,"path":127,"stem":128,"children":129,"icon":131},"Connect Your Tools","/connect-your-tools","5.connect-your-tools/1.index",[130,132,137,142,147,152,156],{"title":28,"path":127,"stem":128,"icon":131},"i-ph-plug",{"title":133,"path":134,"stem":135,"icon":136},"Telegram","/connect-your-tools/telegram","5.connect-your-tools/2.telegram","i-ph-telegram-logo",{"title":138,"path":139,"stem":140,"icon":141},"Discord","/connect-your-tools/discord","5.connect-your-tools/3.discord","i-ph-discord-logo",{"title":143,"path":144,"stem":145,"icon":146},"Slack","/connect-your-tools/slack","5.connect-your-tools/4.slack","i-ph-slack-logo",{"title":148,"path":149,"stem":150,"icon":151},"Connectors","/connect-your-tools/connectors","5.connect-your-tools/5.connectors","i-ph-link",{"title":153,"path":154,"stem":155,"icon":100},"Secrets","/connect-your-tools/secrets","5.connect-your-tools/6.secrets",{"title":157,"path":158,"stem":159,"icon":160},"Audit log","/connect-your-tools/secret-audit-log","5.connect-your-tools/7.secret-audit-log","i-ph-scroll",{"title":162,"path":163,"stem":164,"children":165,"icon":193},"Account & Team","/account-and-team","6.account-and-team/1.index",[166,169,174,179,184,188],{"title":167,"path":163,"stem":164,"icon":168},"Signing in","i-ph-sign-in",{"title":170,"path":171,"stem":172,"icon":173},"Team members","/account-and-team/teams","6.account-and-team/3.teams","i-ph-users",{"title":175,"path":176,"stem":177,"icon":178},"Roles & permissions","/account-and-team/roles-and-permissions","6.account-and-team/4.roles-and-permissions","i-ph-shield",{"title":180,"path":181,"stem":182,"icon":183},"Invitations","/account-and-team/invitations","6.account-and-team/5.invitations","i-ph-envelope-simple",{"title":185,"path":186,"stem":187,"icon":21},"Billing & upgrades","/account-and-team/billing","6.account-and-team/6.billing",{"title":189,"path":190,"stem":191,"icon":192},"Support","/account-and-team/support","6.account-and-team/7.support","i-ph-lifebuoy","i-ph-user",{"title":195,"path":196,"stem":197,"children":198,"icon":200},"Apps","/apps","7.apps/1.index",[199,201],{"title":195,"path":196,"stem":197,"icon":200},"i-ph-squares-four",{"title":202,"path":203,"stem":204,"icon":119},"Building an app","/apps/building-an-app","7.apps/2.building-an-app",{"title":206,"path":207,"stem":208,"children":209,"icon":211},"Workflows","/workflows","8.workflows/1.index",[210,212,216,221,226],{"title":28,"path":207,"stem":208,"icon":211},"i-ph-flow-arrow",{"title":213,"path":214,"stem":215,"icon":82},"Create a workflow","/workflows/creating-a-workflow","8.workflows/2.creating-a-workflow",{"title":217,"path":218,"stem":219,"icon":220},"Edit sections","/workflows/editing-sections","8.workflows/3.editing-sections","i-ph-pencil-simple",{"title":222,"path":223,"stem":224,"icon":225},"Run and schedule","/workflows/running-and-scheduling","8.workflows/4.running-and-scheduling","i-ph-clock",{"title":227,"path":228,"stem":229,"icon":230},"Workflow directory","/workflows/directory","8.workflows/5.directory","i-ph-compass",{"title":232,"path":233,"stem":234,"children":235,"icon":119},"Agent API","/agent-api","9.agent-api/1.index",[236,237,241,246,251,256],{"title":28,"path":233,"stem":234,"icon":119},{"title":13,"path":238,"stem":239,"icon":240},"/agent-api/quickstart","9.agent-api/2.quickstart","i-ph-rocket-launch",{"title":242,"path":243,"stem":244,"icon":245},"Authentication","/agent-api/authentication","9.agent-api/3.authentication","i-ph-lock-key",{"title":247,"path":248,"stem":249,"icon":250},"Endpoints","/agent-api/endpoints","9.agent-api/4.endpoints","i-ph-list-bullets",{"title":252,"path":253,"stem":254,"icon":255},"Streaming","/agent-api/streaming","9.agent-api/5.streaming","i-ph-broadcast",{"title":257,"path":258,"stem":259,"icon":260},"Errors","/agent-api/errors","9.agent-api/6.errors","i-ph-warning-circle",{"id":262,"title":222,"body":263,"description":619,"extension":620,"links":621,"meta":622,"navigation":623,"path":223,"seo":624,"stem":224,"__hash__":625},"docs/8.workflows/4.running-and-scheduling.md",{"type":264,"value":265,"toc":604},"minimark",[266,270,279,284,291,298,301,307,323,326,330,340,399,405,418,421,424,437,443,447,454,476,485,489,504,511,518,523,526,556,563,567,574,601],[267,268,222],"h1",{"id":269},"run-and-schedule",[271,272,273,274,278],"p",{},"You can run a workflow by hand at any time. To run it on a schedule, set a schedule and\n",[275,276,277],"strong",{},"Publish"," it.",[280,281,283],"h2",{"id":282},"run-it-now","Run it now",[271,285,286,287,290],{},"Click ",[275,288,289],{},"Run now"," in the top bar. The run carries out the workflow for real, so anything it\nsays it sends is sent. Manual runs use the latest saved version of the document, even if you\nhaven't published it yet.",[271,292,293,294,297],{},"If the workflow has inputs, the ",[275,295,296],{},"Inputs"," form opens first so you can check the values.",[280,299,296],{"id":300},"inputs",[271,302,303,304,306],{},"Inputs are settings the workflow uses on every run, such as a recipient address or a\nthreshold. When a workflow has inputs, an input count appears at the top of the document. Click\nit to open ",[275,305,296],{},".",[308,309,310,317],"ul",{},[311,312,313,316],"li",{},[275,314,315],{},"Save"," stores the values with the workflow. Every later run uses them, including\nscheduled runs.",[311,318,319,322],{},[275,320,321],{},"Run Now"," saves the values, then starts a run.",[271,324,325],{},"To apply saved inputs to scheduled runs, publish the workflow.",[280,327,329],{"id":328},"set-a-schedule","Set a schedule",[271,331,332,333,336,337,306],{},"Click the schedule control at the top of the document. It reads ",[275,334,335],{},"Only when you run it"," until\nyou set a schedule. This opens ",[275,338,339],{},"When does it run?",[341,342,343,382,385,392],"ol",{},[311,344,345,346],{},"Pick a cadence:\n",[308,347,348,352,357,362,367,372,377],{},[311,349,350],{},[275,351,335],{},[311,353,354],{},[275,355,356],{},"Every few hours",[311,358,359],{},[275,360,361],{},"Every day",[311,363,364],{},[275,365,366],{},"Every weekday",[311,368,369],{},[275,370,371],{},"Once a week",[311,373,374],{},[275,375,376],{},"Once a month",[311,378,379],{},[275,380,381],{},"A cron expression",[311,383,384],{},"Set the time, day, or interval the cadence needs.",[311,386,387,388,391],{},"Choose the ",[275,389,390],{},"timezone",". The schedule fires at that time in this zone.",[311,393,394,395,398],{},"Check the summary (\"We read that as …\") and ",[275,396,397],{},"The next three runs would be"," preview.",[271,400,401,402,306],{},"To see the raw cron expression, open ",[275,403,404],{},"Show the cron expression",[406,407,408],"note",{},[271,409,410,411,414,415,306],{},"If a workflow has a schedule but no timezone, publishing gives it the ",[275,412,413],{},"agent's timezone",". If\nthe agent has no timezone, the schedule runs in UTC. A timezone you choose yourself is never\nreplaced. See ",[416,417,36],"a",{"href":37},[271,419,420],{},"Scheduled runs never overlap. If a run is still going when the next one is due, the new one is\nskipped.",[280,422,277],{"id":423},"publish",[271,425,426,427,430,431,433,434,436],{},"Scheduled runs use the ",[275,428,429],{},"published"," version of the document. Click ",[275,432,277],{}," in the top bar\nto make your current draft the version the schedule runs. Publishing also turns the workflow\non. The ",[275,435,277],{}," button appears whenever the draft has changed since the last publish.",[271,438,439,440,442],{},"If something must be fixed before the workflow can run, such as a connector that isn't\nconnected, ",[275,441,277],{}," is disabled. The list at the top of the document shows what to fix.",[280,444,446],{"id":445},"turn-a-workflow-on-or-off","Turn a workflow on or off",[271,448,449,450,453],{},"Once a workflow is published and scheduled, an ",[275,451,452],{},"On / Off"," switch appears next to its title in\nthe top bar. It also appears on its row in the Workflows list.",[308,455,456,466],{},[311,457,458,461,462,465],{},[275,459,460],{},"Off"," stops scheduled runs. A banner says the workflow is turned off. You can still read\nit, edit it, and run it by hand. Click ",[275,463,464],{},"Turn it back on"," to resume.",[311,467,468,471,472,475],{},[275,469,470],{},"Paused automatically."," After three failed runs in a row, the schedule pauses itself. The\nlist shows ",[275,473,474],{},"paused by us"," and explains why. Fix what broke, then turn the workflow back on\nor publish it again.",[477,478,479],"tip",{},[271,480,481,484],{},[275,482,483],{},"Turn on a workflow"," is a step in the Getting Started checklist. You complete it by\npublishing a workflow and leaving it switched on. Drafts and freshly installed directory\nworkflows start off, so they don't count until you publish them.",[280,486,488],{"id":487},"read-a-run","Read a run",[271,490,491,492,495,496,499,500,503],{},"Switch the top bar to ",[275,493,494],{},"Run"," to see the same document with a run's data filled in. Use the run\npicker to choose a run. Each run is labeled with its number and when it started. The header\nshows the run's status, whether it ran ",[275,497,498],{},"on schedule"," or ",[275,501,502],{},"you started it",", and how long it\ntook.",[271,505,506,507,510],{},"Each section shows how far the run got. Expand a section to see the values it wrote and the\ncalls it made. If a value is too big to show inline, click ",[275,508,509],{},"See the whole value"," to open it in a side panel. Failed\nsections open automatically.",[271,512,513,514,517],{},"To open a workflow's run history from the list, click ",[275,515,516],{},"Logs"," on its row. Run history is kept\nfor 90 days.",[519,520,522],"h3",{"id":521},"debug-one-section","Debug one section",[271,524,525],{},"These options help you fix a single step without paying for the whole run again:",[308,527,528,534,540,546],{},[311,529,530,533],{},[275,531,532],{},"Run this section"," (Template view): runs only this section. Values from the sections above\nit are reused from the last run, at no cost.",[311,535,536,539],{},[275,537,538],{},"Replay from here"," (Run view): returns the values this section produced last time, without\ncalling anything.",[311,541,542,545],{},[275,543,544],{},"Re-run from here"," (Run view): runs this section and every section after it, for real.",[311,547,548,551,552,555],{},[275,549,550],{},"Freeze this value"," (Run view): debug runs reuse this section's value instead of working it\nout again. Scheduled runs ignore frozen values. Click ",[275,553,554],{},"Unfreeze"," to stop.",[271,557,558,559,562],{},"Debug runs are labeled ",[275,560,561],{},"This was a debug run"," and aren't part of the workflow's history.",[280,564,566],{"id":565},"approvals","Approvals",[271,568,569,570,573],{},"When a run reaches a section marked ",[275,571,572],{},"asks you first",", it stops and waits. Nothing is sent\nuntil someone decides. You can answer:",[308,575,576,591],{},[311,577,578,579,582,583,586,587,590],{},"on the workflow's row in the Workflows list (",[275,580,581],{},"Approve and carry on"," / ",[275,584,585],{},"Don't do it","), or\nchoose ",[275,588,589],{},"See everything first"," to open the full approval request, or",[311,592,593,594,582,597,600],{},"in Run view, on the waiting section (",[275,595,596],{},"Go ahead",[275,598,599],{},"Don't send it",").",[271,602,603],{},"Approving continues the run from that section. Declining stops the run there. An approval that\nnobody answers expires after 24 hours.",{"title":605,"searchDepth":606,"depth":607,"links":608},"",1,2,[609,610,611,612,613,614,618],{"id":282,"depth":607,"text":283},{"id":300,"depth":607,"text":296},{"id":328,"depth":607,"text":329},{"id":423,"depth":607,"text":277},{"id":445,"depth":607,"text":446},{"id":487,"depth":607,"text":488,"children":615},[616],{"id":521,"depth":617,"text":522},3,{"id":565,"depth":607,"text":566},"Run a workflow now, save its inputs, schedule it in a timezone, publish it, and read what each run did.","md",null,{},{"icon":225},{"title":222,"description":619},"y4nYnX8duS-uGvjctjnSz-jAr7o9pA-Zs-2lKb3iovA",[627,629],{"title":217,"path":218,"stem":219,"description":628,"icon":220,"children":-1},"Reword sections, redraft their contracts, change reads, writes and connectors, and add or remove sections.",{"title":227,"path":228,"stem":229,"description":630,"icon":230,"children":-1},"Browse ready-made workflows and install them into your workspace.",1791467820948]