[{"data":1,"prerenderedAt":511},["ShallowReactive",2],{"navigation":3,"/chats-and-tasks/tasks":200,"/chats-and-tasks/tasks-surround":506},[4,22,50,83,120,156,189],{"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],{"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,"children":124,"icon":126},"Connect Your Tools","/connect-your-tools","5.connect-your-tools/1.index",[125,127,132,137,142,147,151],{"title":28,"path":122,"stem":123,"icon":126},"i-ph-plug",{"title":128,"path":129,"stem":130,"icon":131},"Telegram","/connect-your-tools/telegram","5.connect-your-tools/2.telegram","i-ph-telegram-logo",{"title":133,"path":134,"stem":135,"icon":136},"Discord","/connect-your-tools/discord","5.connect-your-tools/3.discord","i-ph-discord-logo",{"title":138,"path":139,"stem":140,"icon":141},"Slack","/connect-your-tools/slack","5.connect-your-tools/4.slack","i-ph-slack-logo",{"title":143,"path":144,"stem":145,"icon":146},"Connectors","/connect-your-tools/connectors","5.connect-your-tools/5.connectors","i-ph-link",{"title":148,"path":149,"stem":150,"icon":100},"Secrets","/connect-your-tools/secrets","5.connect-your-tools/6.secrets",{"title":152,"path":153,"stem":154,"icon":155},"Audit log","/connect-your-tools/secret-audit-log","5.connect-your-tools/7.secret-audit-log","i-ph-scroll",{"title":157,"path":158,"stem":159,"children":160,"icon":188},"Account & Team","/account-and-team","6.account-and-team/1.index",[161,164,169,174,179,183],{"title":162,"path":158,"stem":159,"icon":163},"Signing in","i-ph-sign-in",{"title":165,"path":166,"stem":167,"icon":168},"Team members","/account-and-team/teams","6.account-and-team/3.teams","i-ph-users",{"title":170,"path":171,"stem":172,"icon":173},"Roles & permissions","/account-and-team/roles-and-permissions","6.account-and-team/4.roles-and-permissions","i-ph-shield",{"title":175,"path":176,"stem":177,"icon":178},"Invitations","/account-and-team/invitations","6.account-and-team/5.invitations","i-ph-envelope-simple",{"title":180,"path":181,"stem":182,"icon":21},"Billing & upgrades","/account-and-team/billing","6.account-and-team/6.billing",{"title":184,"path":185,"stem":186,"icon":187},"Support","/account-and-team/support","6.account-and-team/7.support","i-ph-lifebuoy","i-ph-user",{"title":190,"path":191,"stem":192,"children":193,"icon":195},"Apps","/apps","7.apps/1.index",[194,196],{"title":190,"path":191,"stem":192,"icon":195},"i-ph-squares-four",{"title":197,"path":198,"stem":199,"icon":119},"Building an app","/apps/building-an-app","7.apps/2.building-an-app",{"id":201,"title":202,"body":203,"description":499,"extension":500,"links":501,"meta":502,"navigation":503,"path":65,"seo":504,"stem":66,"__hash__":505},"docs/3.chats-and-tasks/3.tasks.md","Tasks overview",{"type":204,"value":205,"toc":489},"minimark",[206,210,219,243,250,255,258,274,278,305,366,379,383,392,427,434,455,459,480,484],[207,208,64],"h1",{"id":209},"tasks",[211,212,213,214,218],"p",{},"A ",[215,216,217],"strong",{},"task"," is a unit of work you hand to an agent without sitting in a live chat. You write\nthe instructions once; the agent runs them and reports progress and deliverables. Each run\ngets its own chat, so you can always open it and read exactly what the agent did.",[211,220,221,222,225,226,230,231,234,235,238,239,242],{},"Tasks live under ",[215,223,224],{},"Scheduled tasks"," in the left rail (the ",[227,228,229],"code",{},"/tasks"," route). The overview lists\nyour recurring schedules — split into ",[215,232,233],{},"Active"," and ",[215,236,237],{},"Paused"," — with their cadence, next\nrun, and agent. A ",[215,240,241],{},"Live / Offline"," pill shows whether the list is receiving real-time updates.",[211,244,245],{},[246,247],"img",{"alt":248,"src":249},"the Scheduled tasks overview listing active and paused schedules","/screenshots/tasks-overview.png",[251,252,254],"h2",{"id":253},"one-time-vs-recurring","One-time vs recurring",[211,256,257],{},"Every task is one of two kinds:",[259,260,261,269],"card-group",{},[262,263,266],"card",{"icon":264,"title":265,"to":65},"i-ph-play","One-time tasks",[211,267,268],{},"Run once. Created with instructions and an agent, then queued for the agent to pick up.",[262,270,271],{"icon":72,"title":69,"to":70},[211,272,273],{},"Run automatically on a cron schedule, in the timezone you choose. Trigger them manually too.",[251,275,277],{"id":276},"create-a-task","Create a task",[211,279,280,281,284,285,288,289,292,293,296,297,300,301,304],{},"Both ",[215,282,283],{},"New task"," (on the overview) and ",[215,286,287],{},"New scheduled task"," (in the sidebar) open the full\n",[215,290,291],{},"scheduler"," for a recurring task. For a quick ",[215,294,295],{},"one-time"," task, press ",[227,298,299],{},"c"," — that opens a\ncompact dialog with a ",[215,302,303],{},"Recurring task"," toggle (leave it off for a one-time run).",[306,307,308,315,324,335,342,351],"ol",{},[309,310,311,312,314],"li",{},"Open ",[215,313,224],{}," from the left rail.",[309,316,317,318,320,321,323],{},"Click ",[215,319,283],{}," for the scheduler, or press ",[227,322,299],{}," for the one-time quick dialog.",[309,325,326,327,330,331,334],{},"Write the ",[215,328,329],{},"instructions"," — what the agent should do. The quick dialog also lets you attach\ninput files for a one-time run — ",[215,332,333],{},"recurring tasks don't accept attachments",".",[309,336,337,338,341],{},"Pick the ",[215,339,340],{},"agent"," that will run it.",[309,343,344,345,347,348,334],{},"To make it recurring, set a schedule (in the quick dialog, tick ",[215,346,303],{}," first). See\n",[349,350,69],"a",{"href":70},[309,352,353,354,357,358,361,362,365],{},"Save. The one-time dialog offers ",[215,355,356],{},"Save to Backlog"," or ",[215,359,360],{},"Create & Start","; a recurring task\nis ",[215,363,364],{},"Create & Schedule"," and begins on its next scheduled time.",[367,368,369],"note",{},[211,370,371,372,374,375,378],{},"The ",[215,373,224],{}," overview and sidebar list your ",[215,376,377],{},"recurring schedules"," only. A one-time\ntask doesn't appear in these lists — it runs in its own chat, which you open to follow it.",[251,380,382],{"id":381},"how-a-one-time-task-runs","How a one-time task runs",[211,384,385,386,388,389,391],{},"When you create a one-time task you choose how it starts — ",[215,387,360],{}," runs it right\naway, or ",[215,390,356],{}," parks it without running. From the task's detail view you can move\nit between states:",[393,394,395,405,415],"ul",{},[309,396,397,400,401,404],{},[215,398,399],{},"Backlog"," — captured but not started. Click ",[215,402,403],{},"Move to Ready"," to queue it for the agent.",[309,406,407,410,411,414],{},[215,408,409],{},"Ready"," — queued; the agent picks it up. You can ",[215,412,413],{},"Move to Backlog"," to park it again.",[309,416,417,420,421,424,425,334],{},[215,418,419],{},"Running → Success / Failure"," — a task that ",[215,422,423],{},"failed"," can be re-queued with ",[215,426,403],{},[211,428,429,430,433],{},"Each run happens in its ",[215,431,432],{},"own chat",", where you follow it live:",[393,435,436,442,448],{},[309,437,213,438,441],{},[215,439,440],{},"progress bar"," with live status while the agent works.",[309,443,213,444,447],{},[215,445,446],{},"Result"," section with any deliverables once it finishes.",[309,449,450,451,454],{},"A collapsible ",[215,452,453],{},"Timeline"," of the agent's progress updates.",[251,456,458],{"id":457},"how-a-recurring-task-runs","How a recurring task runs",[211,460,461,462,465,466,469,470,473,474,477,478,334],{},"A recurring task fires on its schedule and keeps a ",[215,463,464],{},"run history",". From its detail view you\ncan ",[215,467,468],{},"Run now",", ",[215,471,472],{},"pause/resume"," with the toggle, ",[215,475,476],{},"edit the schedule"," or instructions, and\nopen any past run's chat. See ",[349,479,69],{"href":70},[251,481,483],{"id":482},"results","Results",[211,485,486,487,334],{},"Open any task to read the agent's progress and download what it produced. See\n",[349,488,74],{"href":75},{"title":490,"searchDepth":491,"depth":492,"links":493},"",1,2,[494,495,496,497,498],{"id":253,"depth":492,"text":254},{"id":276,"depth":492,"text":277},{"id":381,"depth":492,"text":382},{"id":457,"depth":492,"text":458},{"id":482,"depth":492,"text":483},"Hand work to an agent as a one-time or recurring task, and run it from Scheduled tasks.","md",null,{},{"title":64,"icon":67},{"title":202,"description":499},"8v0mdlFh5SiV6TM7jhlrE9PESFMwQVa_D9wzpgDLb78",[507,509],{"title":59,"path":60,"stem":61,"description":508,"icon":62,"children":-1},"Share a read-only transcript with anyone via a public link.",{"title":69,"path":70,"stem":71,"description":510,"icon":72,"children":-1},"Schedule work to run automatically on a cron schedule.",1787397457983]