# Using Foundry Workspace

The user needs  *Generic Chat in LLM Console* permission of each LLM project to use agents in the Foundry Workspace.

The user can find the  *Foundry Workspace* icon in the TD Console's global menu if they have *Generic Chat* permission in at least one project. The user can see the list of projects-agents that are published to the Workspace in *Home* tab.

The  *Home* screen is divided into two areas, the top area shows the product agents that Treasure Data offers(TD-Managed: Creative Studio in the screenshot case), while the bottom area shows the custom projects and agents.

![](/assets/foundry-workspace-home.45289db854c5b460c448e089c13e56d9fc04ad1f4b7798b65d42f5ad01678b9f.91c26685.png)

## Use an agent in Foundry Workspace

Click an agent icon(a box with a diamond icon and an agent title) to use a particular agent

1. **Click an agent** : Click a particular agent icon in a specific project
2. **Populate a form** : A Form-type agent provides a form to give input to the agent. Populate a form.
3. **Click a Generate button** : A Form-type agent requires clicking a Generate button to generate content


The figure is an example from *Image Generation Agent* in the *Creative Studio* that Treasure Data offers.

![](/assets/foundry-workspace-agent-list.cccb2f63061bdff9bbbb4f335143fabba4e90cf4ab8ab0becf6e0776ac5f34f9.91c26685.png)

## Scheduling agents in Foundry Workspace

### Prerequisites

Scheduling is available only for **form-type agents** that are published to Foundry Workspace.

We also recommend that you first run the form once and confirm that the output looks correct before setting up a schedule.

### Creating a schedule

1. Open **Foundry Workspace** and select the form-type agent you want to automate.
2. Run the form once to confirm the output.
3. From the form view, choose **Set up schedule** (or the equivalent schedule action).
4. Configure the schedule:
  - **Frequency**: Daily, Weekly, or Monthly
  - **Start date / End date** and **Time zone**
  - Whether to **send notification email** to the schedule creator
5. Save the schedule. The schedule will reuse the current form inputs for every run.


![Schedule configuration form](/assets/foundry-workspace-schedule-form.0685b4598154e7c0f6db819b541efadcf492502c63811a035c1e26dbaaab3eb9.91c26685.png)

The agent will then run automatically according to the configured schedule.

### Viewing and managing schedules

Use the **Scheduled Run** view (or tab) in Foundry Workspace to see the schedules you have access to.

![Scheduled runs list](/assets/foundry-workspace-scheduled-runs.9482e2bed27000c7f8dff55a37625b9cb4084382fe8a337d9af21520eecc47ae.91c26685.png)

From the schedule list, you can:

- View schedules per form interface, including basic details such as name, frequency, next run time, and whether email notification is enabled.
- Edit an existing schedule to change the frequency, dates, or email notification setting.
- Delete a schedule to stop future runs.


Any user who has permission to execute the underlying agent can view, edit, or delete its schedules.

### Notifications and history

When a scheduled run completes, the schedule creator can optionally receive an email notification that includes a link back to the generated artifact in Foundry Workspace.

Each scheduled run produces an artifact and a corresponding history entry, similar to running the agent manually.

### Limitations

- Scheduling is currently available only for **form-type agents** in Foundry Workspace.
- You cannot schedule analysis performed by **Audience Agents**.
- Notification emails are sent only to the schedule creator.


### Dynamic date ranges (for example, last 90 days)

When you schedule an agent, the schedule re-runs the same logic each time.
For dynamic periods such as "last 90 days", avoid hard-coding calendar dates and instead:

- In SQL, calculate the window from the current date at run time (for example, `current_date - interval '90 day'`) and use that in your `WHERE` clause.
- In prompts, describe the range relative to "now" (for example, "analyze data from the last 90 days based on the current execution time") so the model interprets it against the execution date.


This way, every scheduled run automatically shifts the window (yesterday becomes today, last month becomes the new last month, and so on) without updating the schedule configuration.

## Uploading and Using Runtime Resources

Workspace offers users to upload resources that can be used in the Agents that support. The screenshot below is the example from the *Brand Guildeline* agent from the *Creative Studio*.

User can choose a uploaded resource from existing resources by the *Text reource* select box.

![](/assets/foundry-workspace-runtime-select.7522e7cce75268c26ee118198aef9ecd8a1ee15c12cda3b1999d21c3b592aed6.91c26685.png)

To upload runtime resource

1. Navigate to **Resources** tab in the Workspace.
![](/assets/foundry-workspace-resources-tab.75998e5537c023a9d3c7c8d1976377740431b47523b546ad81d9253788bb27ae.91c26685.png)
2. Click **Create resource** button.
![](/assets/foundry-workspace-create-resource.c34f4b1cb47556a936aa31ec3ca7067917c781ae5f8afd56a9c62ae1dbfab4a5.91c26685.png)
3. Populate a form.
![](/assets/foundry-workspace-resource-form.9865743f00612221ab330940841ed71304e74cac65b738b7bdab53ab9159abde.91c26685.png)


| Field | Description |
|  --- | --- |
| Name | A name for the resource |
| Description | A description for the rerource |
| Text | Text content for the resource. This data will be used when this reource is selected in the form interface. Supporting Up to 18,000 charactors. |