[{"data":1,"prerenderedAt":623},["ShallowReactive",2],{"navigation":3,"/workflows/editing-sections":261,"/workflows/editing-sections-surround":618},[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":217,"body":263,"description":611,"extension":612,"links":613,"meta":614,"navigation":615,"path":218,"seo":616,"stem":219,"__hash__":617},"docs/8.workflows/3.editing-sections.md",{"type":264,"value":265,"toc":597},"minimark",[266,270,287,299,304,307,313,317,320,356,359,363,374,381,396,399,405,409,412,491,494,498,509,513,527,534,538,549,553,564,590,594],[267,268,217],"h1",{"id":269},"edit-sections",[271,272,273,274,278,279,282,283,286],"p",{},"Every step of a workflow is a ",[275,276,277],"strong",{},"section",". A section has a number, a name, a contract line, and\nthe text that tells the agent what to do. You edit sections in ",[275,280,281],{},"Template"," view. Use the\n",[275,284,285],{},"Template / Run"," switch in the top bar to change views.",[271,288,289,290,293,294,298],{},"Edits save automatically. A published workflow keeps running its published version until you\n",[275,291,292],{},"Publish"," again. See ",[295,296,222],"a",{"href":297},"/workflows/running-and-scheduling#publish",".",[300,301,303],"h2",{"id":302},"change-what-a-section-says","Change what a section says",[271,305,306],{},"Click into a section's text and type. Write the step the way you'd say it to a colleague.",[271,308,309,310,298],{},"To rename a section, click its name, type the new one, and press ",[275,311,312],{},"Enter",[300,314,316],{"id":315},"the-contract-line","The contract line",[271,318,319],{},"Under each section's name is a line that says how it connects to the rest of the workflow:",[321,322,323,335,341],"ul",{},[324,325,326,329,330,334],"li",{},[275,327,328],{},"reads",": values the section takes in. These can be written by a section above it, come from\nthe workflow's ",[295,331,333],{"href":332},"/workflows/running-and-scheduling#inputs","inputs",", or be something the\nworkflow remembers between runs.",[324,336,337,340],{},[275,338,339],{},"writes",": values the section produces for later sections to read.",[324,342,343,346,347,351,352,355],{},[275,344,345],{},"uses",": the connectors (",[348,349,350],"code",{},"connector:…","), secrets (",[348,353,354],{},"secret:…","), and scripts the section needs.",[271,357,358],{},"If a read is shown in orange with a dotted underline, nothing above the section writes that\nvalue. Change the read or remove it.",[300,360,362],{"id":361},"redraft-a-section-from-its-text","Redraft a section from its text",[271,364,365,366,369,370,373],{},"After you change a section's text, a band appears: ",[275,367,368],{},"Your text has changed. Redraft its\nconnectors, inputs and outputs to match."," Click ",[275,371,372],{},"Redraft",". The agent works out the section's\ncontract again from its text. That covers connectors, secrets, reads, writes, whether it should\nask you first, and any new input it needs.",[271,375,376,377,380],{},"The changes are applied straight away and the section shows ",[275,378,379],{},"Your changes are updated.","\nThen you can:",[321,382,383,390],{},[324,384,385,386,389],{},"click ",[275,387,388],{},"Keep It"," to accept them, or",[324,391,385,392,395],{},[275,393,394],{},"Undo Changes"," to restore the section's previous contract.",[271,397,398],{},"Continuing to edit also keeps the changes.",[271,400,401,402,404],{},"To redraft a section without changing its text, focus the section and click the ",[275,403,372],{},"\nchip next to its name. Use this when the contract doesn't match the words.",[300,406,408],{"id":407},"edit-reads-writes-and-connectors-by-hand","Edit reads, writes, and connectors by hand",[271,410,411],{},"When the text is right and only one name is wrong, edit the contract line directly:",[321,413,414,431,449,458,468,481],{},[324,415,416,419,420,422,423,426,427,430],{},[275,417,418],{},"Change a read",": click the value after ",[275,421,328],{},". Pick another value from ",[275,424,425],{},"Read instead",",\nor choose ",[275,428,429],{},"Stop reading it",". Only values that something above this section provides appear\nin the list.",[324,432,433,419,436,438,439,441,442,445,446,298],{},[275,434,435],{},"Rename a write",[275,437,339],{},", type a new name, and press ",[275,440,312],{},".\n",[275,443,444],{},"Esc"," cancels. Sections further down that read the value are updated to the new name.\nNames are converted to lowercase with underscores, so \"Topic outlines\" becomes\n",[348,447,448],{},"topic_outlines",[324,450,451,454,455,457],{},[275,452,453],{},"Swap a connector",": click a ",[348,456,350],{}," entry and pick a different one.",[324,459,460,463,464,467],{},[275,461,462],{},"Add a connector",": focus the section and click the ",[275,465,466],{},"connector"," chip. Connected tools are\nlisted first. If you pick one that isn't connected, the section asks you to connect it.",[324,469,470,463,473,476,477,480],{},[275,471,472],{},"Add a secret",[275,474,475],{},"secret"," chip. Pick one of the workspace's\nsecrets, or choose ",[275,478,479],{},"A new one…"," to create it on the Secrets page.",[324,482,483,486,487,490],{},[275,484,485],{},"Remove a connector or secret",": click the ",[275,488,489],{},"×"," next to it.",[271,492,493],{},"A section can use up to eight connectors, secrets, and scripts in total. Scripts are part of\nthe workflow and can't be added or removed here.",[300,495,497],{"id":496},"make-a-section-ask-you-first","Make a section ask you first",[271,499,500,501,504,505,298],{},"Focus a section and click ",[275,502,503],{},"asks you first"," to make the section stop and wait for your\napproval before it goes ahead. Click it again to stop asking. Sections that ask first are\nmarked wherever the workflow appears. See ",[295,506,508],{"href":507},"/workflows/running-and-scheduling#approvals","Approvals",[300,510,512],{"id":511},"add-a-section","Add a section",[321,514,515,521],{},[324,516,517,520],{},[275,518,519],{},"At the end",": click the insert point below the last section.",[324,522,523,526],{},[275,524,525],{},"Between two sections",": click the insert point between them.",[271,528,529,530,533],{},"Write what the new section should do in a sentence or two and click ",[275,531,532],{},"Add section",". Its name\nand contract line are worked out from your text when it's added.",[300,535,537],{"id":536},"remove-a-section","Remove a section",[271,539,540,541,544,545,548],{},"Hover over a section and click the ",[275,542,543],{},"trash"," icon. The section is removed straight away and a\nmessage offers ",[275,546,547],{},"Undo"," for a few seconds. If later sections read a value the removed section\nwrote, those reads are marked so you can fix them.",[300,550,552],{"id":551},"choose-accounts-and-secrets","Choose accounts and secrets",[271,554,555,556,559,560,563],{},"Click the ",[275,557,558],{},"connections"," control at the top of the document to open ",[275,561,562],{},"Connections",". It lists\neverything the workflow uses, grouped as connectors, secrets, and scripts, and shows which\nsection uses each.",[321,565,566,573,580],{},[324,567,568,570,571,298],{},[275,569,148],{},": pick which connected account the workflow should use. If a connector isn't\nconnected, the row links to its page in ",[295,572,148],{"href":149},[324,574,575,577,578,298],{},[275,576,153],{},": pick which workspace secret to use for each name. If the workflow's agent can't\nread a secret yet, give it access from here. See ",[295,579,153],{"href":154},[324,581,582,585,586,589],{},[275,583,584],{},"Scripts",": listed as ",[275,587,588],{},"comes with it",". There's nothing to set up.",[300,591,593],{"id":592},"change-the-agent","Change the agent",[271,595,596],{},"In Template view, use the agent picker at the top of the document to move the workflow to\nanother agent. From then on, that agent runs it.",{"title":598,"searchDepth":599,"depth":600,"links":601},"",1,2,[602,603,604,605,606,607,608,609,610],{"id":302,"depth":600,"text":303},{"id":315,"depth":600,"text":316},{"id":361,"depth":600,"text":362},{"id":407,"depth":600,"text":408},{"id":496,"depth":600,"text":497},{"id":511,"depth":600,"text":512},{"id":536,"depth":600,"text":537},{"id":551,"depth":600,"text":552},{"id":592,"depth":600,"text":593},"Reword sections, redraft their contracts, change reads, writes and connectors, and add or remove sections.","md",null,{},{"icon":220},{"title":217,"description":611},"v4mN4B19Fk-dn2daqi6LQSbHIKRNWqBgTJZgLU_DokM",[619,621],{"title":213,"path":214,"stem":215,"description":620,"icon":82,"children":-1},"Describe a job in plain English, review the generated draft, and keep it.",{"title":222,"path":223,"stem":224,"description":622,"icon":225,"children":-1},"Run a workflow now, save its inputs, schedule it in a timezone, publish it, and read what each run did.",1791467820875]