Jobs
Jobs are scheduled tasks that automatically execute agents with predefined prompts at specified intervals. They enable automation of repetitive workflows, regular data collection, monitoring tasks, and scheduled reporting within the ToothFairyAI platform.
Jobs are available only for Business and Enterprise subscriptions. Please contact us for more information about upgrading your plan to access this feature.
Menu location
Jobs can be created and managed from the following menu:
Settings > Jobs > Create Job
Create a job
Basic Information
- Click on the
Create Job
button. - Job Name - Assign a unique name to identify the job.
- Description - Provide a meaningful description of what the job accomplishes.
Execution Configuration
- Agent - Select the agent that will execute the job. Available agents are pulled from your saved agents in the platform (see Agents for more details).
- Prompt - Choose the prompt that will be sent to the agent. Available prompts are retrieved from your saved prompts (see Prompting for more details).
Schedule Configuration
Active - Toggle to enable or disable the job execution.
Frequency - Select how often the job should run:
- Hourly - Runs every hour at the specified minute
- Daily - Runs once per day at the specified time
- Weekly - Runs once per week on the selected day and time
- Monthly - Runs once per month on the specified day and time
- Yearly - Runs once per year on the specified date and time
Hour - Select the hour (0-23) when the job should run (for daily, weekly, monthly, and yearly frequencies).
Minute - Select the minute (0-59) when the job should run.
Timezone - Select the timezone for the scheduled execution time.
Start date - Define when the job should begin running.
End date - Define when the job should stop running (optional).
Click on the
Save
button to create the job.
Managing jobs
Once created, jobs appear in the jobs list with the following information:
- Agent - The agent assigned to execute the job
- Prompt - The prompt being used
- Status - Shows whether the job is ACTIVE or INACTIVE
- Schedule - Displays the frequency and timing
Edit a job
- Click on an existing job from the list.
- The edit modal displays the job ID and all configuration options.
- Modify any settings as needed.
- Click
Save
to update the job.
Delete a job
- Open the job you want to delete.
- Click the
Delete
button at the bottom of the edit modal. - Confirm the deletion when prompted.
Job outputs
The results from executed jobs are automatically saved and made available in the External chats section under the Agents module. This allows you to:
- Review historical job execution results
- Monitor job performance and success rates
Use cases
Common use cases for scheduled jobs include:
- Daily Reports - Generate business intelligence reports every morning
- Data Monitoring - Check for data anomalies or threshold breaches
- Content Generation - Create regular content like newsletters or summaries
- System Health Checks - Monitor API endpoints or system status
- Market Intelligence - Collect competitive intelligence or market data
- Compliance Checks - Run regular compliance or security audits
Best practices
- Test First - Run your agent and prompt combination manually before scheduling to ensure expected results.
- Clear Naming - Use descriptive job names that indicate purpose and frequency.
- Timezone Awareness - Always verify the timezone setting to ensure jobs run at the intended time.
- End Dates - Consider setting end dates for temporary jobs to prevent unnecessary executions.
- Monitor Outputs - Regularly check the Widgets section to verify job outputs and catch any issues early.
Jobs are subject to the same execution limits as manual agent runs, including token limits, execution timeouts, and rate limits based on your subscription tier.
Only agents that have been previously created and saved in your workspace will appear in the agent selection dropdown. Ensure you have configured the necessary agents before creating jobs.