{"versionId":"97555fce-692d-4e81-4f93-08df145bf3e9","articleId":"cd655812-b03b-49b9-8d04-08de8b9ac8a7","title":"Scheduled jobs | User guide","tags":["Automation","All articles"],"content":"<html><head></head><body><div class=\"mce-toc\">\n<h2>Quick links</h2>\n<ul>\n<li><a href=\"#what-scheduled-jobs-do\">What scheduled jobs do</a></li>\n<li><a href=\"#set-up-a-scheduled-job\">Set up a scheduled job</a>\n<ul>\n<li><a href=\"#pause-a-schedule\">Pause a schedule</a></li>\n<li><a href=\"#write-an-effective-initial-prompt\">Write an effective initial prompt</a></li>\n<li><a href=\"#choose-a-run-mode\">Choose a run mode</a></li>\n</ul>\n</li>\n<li><a href=\"#manage-your-schedules\">Manage your schedules</a></li>\n<li><a href=\"#worked-example-daily-planner\">Worked example: daily planner</a>\n<ul>\n<li><a href=\"#daily-planner-assistant-set-up\">Assistant set-up</a></li>\n<li><a href=\"#daily-planner-schedule-configuration\">Schedule configuration</a></li>\n<li><a href=\"#daily-planner-initial-prompt\">Initial prompt</a></li>\n<li><a href=\"#daily-planner-how-it-works\">How it works</a></li>\n</ul>\n</li>\n<li><a href=\"#worked-example-document-processing-pipeline\">Worked example: document processing pipeline</a></li>\n<li><a href=\"#trigger-a-scheduled-job-from-power-automate\">Advanced: trigger a scheduled job from Power Automate</a>\n<ul>\n<li><a href=\"#mcetoc_1k2pc3762p\">Before you start:</a></li>\n<li><a href=\"#mcetoc_1k2pc3762q\">Step by step</a></li>\n</ul>\n</li>\n</ul>\n</div>\n<h2 id=\"what-scheduled-jobs-do\">What scheduled jobs do</h2>\n<p>Scheduled jobs run an assistant automatically at a time you choose. Use them for repeatable work such as daily briefings, weekday reports and recurring file-processing tasks.</p>\n<p>When a schedule runs, Theta Assist sends the saved prompt to the assistant, uses its configured tools and connected services, and saves the result in a thread.</p>\n<p>Scheduled jobs require the <strong>Jobs</strong> feature to be enabled by your administrator.</p>\n<h2 id=\"set-up-a-scheduled-job\">Set up a scheduled job</h2>\n<ol>\n<li>Open the assistant you want to schedule.</li>\n<li>In the left-hand menu, select <strong>Schedules</strong> under <strong>Automation &amp; API</strong>.</li>\n<li>Select <strong>Create scheduled job</strong>.</li>\n<li>Complete the schedule details.</li>\n<li>Select <strong>Save</strong>.</li>\n</ol>\n<p>The schedule becomes active immediately and runs at the next matching time.</p>\n<table style=\"width: 100%; border-collapse: collapse; border: 1px solid #b7b7b7;\">\n<thead>\n<tr>\n<th style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Field</th>\n<th style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">What to enter</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\"><strong>Job name</strong></td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Use a clear label, such as “Daily morning brief”. This helps you identify the schedule on the <strong>Jobs</strong> page.</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\"><strong>Initial prompt</strong></td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Enter the instructions the assistant should follow each time the schedule runs.</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\"><strong>Schedule</strong></td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Use the visual builder to choose the frequency, days and time. Choose weekdays when the task should run Monday to Friday. Set the schedule to <strong>Never</strong> to save it without running it automatically.</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\"><strong>Run mode</strong></td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Choose how the assistant should complete the job each time it runs.</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\"><strong>Time zone</strong></td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">This is set from your browser when you create the schedule and is shown for reference.</td>\n</tr>\n</tbody>\n</table>\n<h3 id=\"pause-a-schedule\">Pause a schedule</h3>\n<p>To keep a schedule but stop automatic runs, edit it and set the schedule to <strong>Never</strong>. You can still run it manually from <strong>Jobs &gt; Scheduled</strong>.</p>\n<h3 id=\"write-an-effective-initial-prompt\">Write an effective initial prompt</h3>\n<p>Scheduled jobs run without back-and-forth, so the initial prompt needs to contain everything the assistant needs to complete the task.</p>\n<ul>\n<li><strong>State the task clearly.</strong> Say what the assistant needs to do.</li>\n<li><strong>List steps in order.</strong> Number multi-step tasks.</li>\n<li><strong>Include exceptions.</strong> Explain when the assistant should stop or take a different action.</li>\n<li><strong>Define the output.</strong> Specify whether the result should be a thread summary, report, email or another outcome.</li>\n<li><strong>Set completion rules.</strong> Explain what to do when no results are found or a step fails.</li>\n<li><strong>Keep standing instructions in the system prompt.</strong> Use the initial prompt for the recurring task only.</li>\n</ul>\n<h3 id=\"choose-a-run-mode\">Choose a run mode</h3>\n<p>Choose how Theta Assist completes the scheduled job.</p>\n<ul>\n<li><strong>Agentic loop (default):</strong> The assistant works through the task in steps. A completion checker prompts it to continue until the task is complete. Reasoning is off. Choose a creativity preset; new jobs use <strong>Low</strong> by default for predictable, repeatable results.</li>\n<li><strong>Reasoning only:</strong> The assistant uses its configured reasoning and completes the task in one pass. There is no completion checker. Use this for simple tasks that can reliably finish in a single response.</li>\n<li><strong>Agentic loop with reasoning:</strong> The assistant uses reasoning and works through the task in steps. A completion checker runs after each step. Use this for complex tasks that need more thorough analysis. This option takes longer and costs more.</li>\n</ul>\n<p><strong>Recommended:</strong> Use <strong>Agentic loop</strong> with <strong>Low</strong> creativity for most unattended scheduled jobs.</p>\n<h2 id=\"manage-your-schedules\">Manage your schedules</h2>\n<p>Go to <strong>Jobs &gt; Scheduled</strong> to view your schedules.</p>\n<p>Each schedule shows its description, last run, next run and linked assistant. A paused schedule shows <strong>Never</strong>.</p>\n<table style=\"width: 100%; border-collapse: collapse; border: 1px solid #b7b7b7;\">\n<thead>\n<tr>\n<th style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Action</th>\n<th style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">What it does</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\"><strong>Run now</strong></td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Starts a one-off run immediately, regardless of the saved schedule.</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\"><strong>Edit</strong></td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Changes the name, schedule or initial prompt.</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\"><strong>Delete</strong></td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Permanently removes the schedule.</td>\n</tr>\n</tbody>\n</table>\n<p>After a schedule runs, open the related job to view the full thread and output.</p>\n<h2 id=\"worked-example-daily-planner\">Worked example: daily planner</h2>\n<p>This example creates a weekday morning brief that checks Teams, email, meeting transcripts and your calendar, then emails you a structured summary.</p>\n<h3 id=\"daily-planner-assistant-set-up\">Assistant set-up</h3>\n<table style=\"width: 100%; border-collapse: collapse; border: 1px solid #b7b7b7;\">\n<thead>\n<tr>\n<th style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Setting</th>\n<th style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Value</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\"><strong>Assistant name</strong></td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Daily planner</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\"><strong>MCP server</strong></td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">M365 Tools</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\"><strong>System prompt</strong></td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Define the output structure and standing formatting rules. If the assistant sends an email, include the email format it should use.</td>\n</tr>\n</tbody>\n</table>\n<h3 id=\"daily-planner-schedule-configuration\">Schedule configuration</h3>\n<table style=\"width: 100%; border-collapse: collapse; border: 1px solid #b7b7b7;\">\n<thead>\n<tr>\n<th style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Field</th>\n<th style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Value</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\"><strong>Name</strong></td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Daily morning brief</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\"><strong>Schedule</strong></td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Every weekday at 7:00 am</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\"><strong>Initial prompt</strong></td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Use the example below.</td>\n</tr>\n</tbody>\n</table>\n<h3 id=\"daily-planner-initial-prompt\">Initial prompt</h3>\n<pre><code>Use the M365 tools to help me plan my day.\n\n1. Check my Teams chats for open loops, including unanswered requests, commitments, blockers and follow-up actions.\n2. Check unread overnight emails. Ignore transactional emails unless they appear critical. Ignore Microsoft 365 quarantine notifications.\n3. Review accessible meeting transcripts from the previous day and identify actions assigned to me or commitments I made.\n4. Review my upcoming meetings for today and suggest preparation needed. Ignore daily recurring meetings.\n5. Prepare a prioritised summary with links where available.\n\nWhen complete, email the summary to me.</code></pre>\n<h3 id=\"daily-planner-how-it-works\">How it works</h3>\n<ol>\n<li>At 7:00 am each weekday, Theta Assist sends the prompt to the Daily planner assistant.</li>\n<li>The assistant checks the configured Microsoft 365 sources.</li>\n<li>It prepares and sends the summary.</li>\n<li>The completed run appears in <strong>Jobs</strong>. Open the related thread to review the result.</li>\n</ol>\n<h2 id=\"worked-example-document-processing-pipeline\">Worked example: document processing pipeline</h2>\n<p>Scheduled jobs can run a multi-step workflow, such as finding documents, processing them in batches, sending results to another system and notifying stakeholders.</p>\n<ol>\n<li>List files from SharePoint or OneDrive.</li>\n<li>Start a batch processing job to analyse each file.</li>\n<li>Wait for the batch job to finish.</li>\n<li>Send the results to an external endpoint, such as a Power Automate flow or API.</li>\n<li>Send a completion summary by email.</li>\n</ol>\n<table style=\"width: 100%; border-collapse: collapse; border: 1px solid #b7b7b7;\">\n<thead>\n<tr>\n<th style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Capability</th>\n<th style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Tool required</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">List or read SharePoint and OneDrive files</td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">M365 Tools MCP server</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Process documents in batches</td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Batch processing built-in tools</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Send results to an external endpoint</td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">cURL Executor MCP server</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">Send an email notification</td>\n<td style=\"border: 1px solid #b7b7b7; text-align: left; vertical-align: top; padding: 2px;\">M365 Tools MCP server</td>\n</tr>\n</tbody>\n</table>\n<p>All tools must be enabled by your administrator and added to the assistant. Configure the cURL Executor with appropriate URL restrictions and credentials for the destination system.</p>\n<h2 id=\"trigger-a-scheduled-job-from-power-automate\">Advanced: trigger a scheduled job from Power Automate</h2>\n<p>Use an advanced trigger when you want Power Automate to start a saved scheduled job in response to an event, rather than waiting for its normal run time. For example, you could start an assistant when a new email meets selected criteria.</p>\n<h3 id=\"mcetoc_1k2pc3762p\">Before you start</h3>\n<ul>\n<li>Set up the assistant with the tools and instructions it needs.</li>\n<li>Create and save the scheduled job on that assistant.</li>\n</ul>\n<h3 id=\"mcetoc_1k2pc3762q\">Step by step</h3>\n<ol>\n<li>Open the assistant and select <strong>Schedules</strong>.</li>\n<li>Create or open the scheduled job you want Power Automate to start.</li>\n<li>Select <strong>Save</strong>. The <strong>Advanced trigger</strong> option becomes available after the schedule is saved.<br><img src=\"https://portal.helpfruit.com/api/images/0d5220bc9ad14992d05108dccd460f35/files/pasted_image_article_scheduled-jobs-user-guide_034dec2f-8226-43d9-b98d-fb4588e452aa.png?width=1000&amp;height=\" width=\"600\"></li>\n<li>In <strong>Advanced trigger</strong>, select <strong>Create trigger URL</strong>.</li>\n<li>Copy the trigger URL and the assistant API key.</li>\n<li>In Power Automate, create a flow with the event that should start the job, such as receiving an email that matches your criteria.<br><img src=\"https://portal.helpfruit.com/api/images/0d5220bc9ad14992d05108dccd460f35/files/ig_00eda5a7c12d0454006aacb8351af087d0b81e9f90875b4e08.png?width=1000&amp;height=\" width=\"800\"></li>\n<li>Add an HTTP action that sends a request to the trigger URL.</li>\n<li>Add the assistant API key using the authentication method shown in the schedule’s advanced trigger settings.</li>\n<li>Test the flow and check <strong>Jobs</strong> to confirm that the job started.</li>\n</ol>\n<p>When the flow starts the job, Theta Assist can return a shared link to the completed thread. Use this link in a later flow action, such as sending a Teams message, email or approval request.</p>\n<p>The shared link opens the full job thread and its output. Recipients must sign in to access it.</p>\n<p><strong>Important:</strong> The job runs with the permissions and access of the person who created the schedule. Review the assistant’s connected tools and data access before enabling an external trigger.</p></body></html>","description":"Set up, run and manage recurring assistant tasks in Theta Assist.","isMarkdown":false,"publishedOnUtc":"2026-09-22T04:05:16.6669215","modifiedOnUtc":"2026-03-27T03:15:34.2608999"}