---
title: "[DRAFT] Schedule Interface"
description: "[DRAFT - NOT IN USE] Configure automated agent execution schedules"
draft: true
---

<Warning>
**This is a DRAFT document not intended for public use.**

For active interface documentation, see:
- [Managing Agent Interfaces](/building-and-deploying-agents/interface-options/managing-interfaces)
- [API Interface Configuration](/building-and-deploying-agents/interface-options/api-deployment)
- [Airia Catalog Interface](/building-and-deploying-agents/interface-options/airia-agent)
- [Chat Widget Interface](/building-and-deploying-agents/interface-options/chat-widget)
</Warning>

# Schedule Interface Configuration

The Schedule interface allows you to configure automated execution triggers for your agent, enabling it to run at specified times or intervals.

## Key Features

### Automated Execution
- **Time-based Triggers**: Set your agent to run at specific times or intervals
- **Recurring Schedules**: Configure daily, weekly, or custom recurring patterns
- **Input Configuration**: Define what input your agent receives when triggered

### Schedule Management
- **Schedule Configuration**: Weekly schedule picker with specific days and times
- **Execution Tracking**: Monitor when your scheduled agent executions occur
- **Active Version**: Always executes against your agent's Active version

## Configuration Steps

<Steps>
  <Step title="Access the Interfaces Panel" stepNumber={1}>
    Access the interfaces panel by either:
    - Clicking the **ellipsis (…)** menu to the right of your Agent and selecting **Interfaces**
    - Opening the Agent in Studio and clicking **Settings > Interfaces**
  </Step>
  
  <Step title="Add Schedule Interface" stepNumber={2}>
    In the interfaces panel:
    - Click **+ Add Interface** if this is a new interface
    - Select **Schedule** from the available interface types
    - Or click the edit icon next to an existing Schedule interface to modify its configuration
  </Step>
  
  <Step title="Configure Schedule Settings" stepNumber={3}>
    Configure the following settings for your Schedule interface:
    
    - **Execute Automatically**\
      _Toggle to enable automated execution based on your schedule._
    
    - **Frequency**\
      _Choose how often your agent should execute: Daily, Weekly, or Custom interval._
    
    - **Schedule Days**\
      _Select specific days of the week when your agent should run._
    
    - **Execution Time**\
      _Set the specific time(s) when your agent should execute._
    
    - **Input Configuration**\
      _Define what input your agent will receive when the schedule triggers._
  </Step>
  
  <Step title="Save Configuration" stepNumber={4}>
    Click **Save** to activate your Schedule interface. Your agent will begin executing according to the configured schedule.
  </Step>
</Steps>

## Managing Scheduled Executions

### Monitoring
- **Execution History**: Track when your agent has run via scheduled triggers
- **Success/Failure Tracking**: Monitor the success rate of scheduled executions
- **Output Review**: Review the outputs from scheduled agent runs

### Best Practices
- **Test First**: Verify your agent works correctly before enabling automated scheduling
- **Input Validation**: Ensure your scheduled input is appropriate for your agent's capabilities
- **Monitor Regularly**: Check execution logs to ensure schedules are running as expected

## Troubleshooting

<AccordionGroup>
<Accordion title="How do I ensure my Schedule uses the correct agent version?">
All interfaces execute against the **Active version** of your agent. To ensure your Schedule interface uses the latest version:

1. Navigate to your agent in the agent list
2. Verify the Agent shows the correct **Active Version**
3. If an update is required:
   - Go into the Agent
   - Select the version number in the top left
   - Click **Set Active**
   - Return to the agent list

Your Schedule interface will automatically use the updated Active version.
</Accordion>

<Accordion title="Why isn't my scheduled agent executing?">
If your scheduled executions aren't running:

- **Interface Status**: Verify the Schedule interface is **enabled**
- **Schedule Configuration**: Check that your time and day settings are correct
- **Active Version**: Ensure the agent has an **Active version** published
- **Input Validation**: Verify the scheduled input is valid for your agent
- **Permissions**: Confirm you have appropriate permissions for scheduled execution
</Accordion>
</AccordionGroup>