Scheduled tasks

A scheduled task allows Pér to perform scheduled work on your behalf. Once you create and enable a scheduled task, Pér runs the task’s prompt automatically on the specified schedule. You can choose to receive an email with a status notification and/or the results of the scheduled task each time it runs. You can view notifications for newly completed scheduled task runs on the Tasks page. The scheduled task detail page shows a list of the task’s recent runs and their details.

Scheduled tasks and their results are private; each can only be viewed, edited, and run by its owner. Scheduled tasks can interface with Amperity and external MCPs in a read-only capacity (a scheduled task will never write to your Amperity tenant).

Example scheduled task use cases:

  • Generate a weekly Amps spend summary and get alerted if Amps spend exceeds a threshold for the week.

  • Create and update a report showing progress toward KPIs at the end of each month.

  • Check failed workflows each morning and provide instructions to resolve any failures that occurred.

  • Measure campaign performance for all campaigns sent in the past week.

Scheduled task list

You can view all of your scheduled tasks on the Tasks page, which can be accessed by clicking Tasks in the navigation sidebar. The Tasks page includes a New task button, a dismissible section of suggested tasks, a list of new results, and all scheduled tasks you have created.

The New task button allows you to create a new scheduled task from scratch (see Creating a scheduled task).

The Suggested tasks section contains a collection of fully configured sample tasks, each of which you can create with one click. These suggested tasks are intended to provide inspiration and be a starting point for creating your own scheduled tasks. When you click on a suggested task, it will disappear from the suggested list and appear in your list of scheduled tasks below. A single test run of the new task is automatically launched so you can understand how it works. Click on the newly created task to view its details, edit it, or see the status/results of the initial run. You can dismiss the entire Suggested tasks section by clicking the X in its upper right-hand corner.

Tip

If a suggested task is similar to your use case but not exactly what you’re looking for, you can edit it after creating it.

The New results section provides a list of notifications showing new scheduled task results since your last visit. Click on a notification in the list to see the full results. If you don’t have any notifications, this section will not be present.

Below Suggested tasks and New results is a grid showing an overview of each of your scheduled tasks. Each card in the grid includes a brief summary of the scheduled task including its name, status (enabled/paused), prompt, schedule, next run, and last run. Click on a card to view a task’s details, see a list of recent runs, or edit the task.

Scheduled task details

The detail page for a scheduled task includes a set of action buttons, settings, any artifacts the task has generated, and run history.

Task action buttons

The task action buttons include:

  • Open conversation: open the conversation to which the task results get written (tip: you can send follow-up questions to this conversation)

  • Run now: trigger a manual run of the task

  • Edit: edit the task

  • Pause/Enable: toggle the status of the task

  • Delete: delete the task

Task settings

The task settings include:

  • Status: enabled or paused; enabled tasks run according to their schedule, and paused tasks do not (but they can still be run manually)

  • Name: a brief, descriptive name for the task

  • Prompt: instructions that tell Pér what to do each time the task runs

  • Skill: an optional skill to use alongside the prompt each run

  • Schedule: when and how often the task runs (hourly, daily, weekly, or monthly)

  • Timezone: the timezone that is applied to the schedule

  • Next run: the day and time of the next scheduled run

  • Last run: the day and time the most recent scheduled run started (excludes manual runs)

  • Email: whether or not you will receive an email when a run completes

Task artifacts

If the task’s prompt instructs Pér to create or update an artifact, the artifact will be shown in the Artifacts section on the task detail page. Click on the artifact name to view it. You may share the artifact with all users in the tenant by clicking the “Share with team” button (always review the content first before sharing).

Run history

The task Run history section includes a list of all recent task runs and their results. Each run summary includes the run status (succeeded, failed, or degraded), the day and time it completed, whether it was a manual or scheduled run, duration, and results (click Show full output to expand the results).

The task run status can be one of:

  • Queued: the task run has been scheduled but is not yet running

  • Running: Pér is working on the task run

  • Succeeded: the task run completed as expected

  • Degraded: Pér was able to complete some but not all of the requests in the prompt (a common cause is a prompt that asks Pér to take actions you do not have permission to perform or which are not allowed by scheduled tasks; see Scheduled task limits)

  • Failed: the task could not be completed due to an error or a prompt which Pér was unable to complete (the error message will help you understand how to fix the problem)

Creating a scheduled task manually

To create a new scheduled task, open the Tasks page, then click New task and provide the following:

  • Name: a brief, descriptive name for the task

  • What should Pér do?: instructions that tell Pér what to do each time the task runs

  • Skill: an optional skill to use alongside the prompt each run (select from a list)

  • Enabled: whether to create the task in an enabled or paused state (defaults to enabled)

  • Schedule: when and how often the task runs (the schedule preview will show the date and time of the next three runs and updates as you change the schedule)

    • Hourly: specify the minute of each hour

    • Daily: specify the time of day

    • Weekly: specify the day of week and time of day

    • Monthly: specify the day of month and time of day (note: if a month does not include the day specified, the task will not be run that month — e.g., the 31st)

  • Timezone: the timezone that is applied to the schedule (defaults to your browser’s local timezone)

  • Email me after each run: whether or not you will receive an email when a run completes

  • Include full task output: whether or not to include the full task output in the email (be mindful that task output may include sensitive information if requested by the task prompt)

  • Include created or updated artifacts as email attachments: whether to attach any artifacts the run creates or updates to the email as PDFs (this option appears only when Email me after each run is turned on)

Tip

Scheduled task email notifications (and any attachments) are sent only to the user that created the task. Scheduled task results and artifacts are AI-generated; they should be reviewed for correctness and sensitive information before sharing. To share emailed scheduled task results or artifacts with other email recipients once you’ve reviewed it, simply forward the email to individuals or a distribution list.

Click Create task to create the task. You will be automatically taken to the task detail page. It is recommended that you test out your newly created task by triggering a manual run of the task using the Run now button. If the results are not as expected, or if the run is degraded or failed, update the task settings accordingly and re-run until you’re happy with the outcome.

Asking Pér to create a scheduled task

You can also ask Pér to create a scheduled task for you via chat. Try asking something like:

  • “Create a report which summarizes my top customers over the past week and their purchase behavior and update it every Friday at 9pm.”

  • “I want to get a summary of recent workflows and their status each morning.”

  • “Summarize campaign performance for the past 30 days on the first day of each month.”

Tip

You don’t need to know ahead of time when starting a chat that you want to create a scheduled task. If you have performed some research or analysis in a conversation and then decide you’d like to repeat it on a cadence, simply tell Pér in the chat that you would like it repeated every hour, day, week, or month, along with any additional schedule details if applicable (for example, “Run this analysis for me every Sunday night”).

Once Pér finishes creating the scheduled task you requested, a card will appear in the chat showing a summary of the task and a View task button which you can click to see the full details. Pér will do its best to use reasonable defaults for the task settings when your request does not provide all of the necessary details for creating a task. If you’d like to change anything about the task, you can either edit the task manually or ask Pér in the chat to make the update for you (for example, “Actually, I want it to run at 10am instead of 8am”).

Editing a scheduled task

You can edit a scheduled task on its detail page. Open the Tasks page and click on the task you would like to edit.

Pausing or enabling a scheduled task

You can pause or enable a task by clicking the Pause/Enable button on the task detail page. Alternatively, you can click Edit and use the Enabled/Paused toggle in the Schedule section.

Editing scheduled task settings

You can edit a task’s settings by clicking the Edit button on the task detail page. See Creating a scheduled task manually for a list of all task settings.

Manually run a scheduled task

You can trigger a manual run of a scheduled task on its detail page. Open the Tasks page and click on the task you would like to run, then click the Run now button. A manual run allows you to try out a task and make sure the results meet your expectations without you having to wait for the next scheduled run. Both Enabled and Paused tasks can be run manually.

Tip

Whenever you create a task or edit its prompt, trigger a manual run to make sure the task works as intended. If the results are not as you expect, iterate by editing the task and re-running it until you’re satisfied with the results.

Permissions

Each scheduled task runs using the permissions and identity of the user who created it. These permissions also apply to data read from Amperity. For example, if you create a task which asks Pér to summarize segments but you do not have permission to read segments in Amperity, segment reads will be blocked and the task will be marked as Failed. If your Amperity permissions do not allow you to view PII, your scheduled tasks will also be unable to read PII.

Scheduled tasks and their results are private to the user who created them.

Scheduled tasks cannot do any of the following regardless of the owner’s permissions:

  • Write to Amperity or any other external systems

  • Create or update memories (existing memories can be read and applied, but new memories cannot be created)

  • Create or update plans

  • Create or update scheduled tasks

  • Configure connectors or MCP servers

  • Send messages to external messaging apps (e.g., Slack, Microsoft Teams)

  • File product feedback

  • Edit company context in Pér or Amperity

  • Spend Amps

Limits

There are a few limits to keep in mind for scheduled tasks:

  • Each user may have up to 25 scheduled tasks. If you need more, please contact your account team.

  • Scheduled task run history is retained for at least 90 days and 50 runs; older runs outside these limits will be deleted.

  • Scheduled tasks are private to their owner and cannot be shared. If a task has an artifact associated with it, you may share the artifact with your team.

  • Scheduled tasks cannot write to your Amperity tenant or any external application connected by MCP or otherwise.