> For the complete documentation index, see [llms.txt](https://docs.feathery.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.feathery.io/platform/computer-agents/trigger-a-run.md).

# Trigger a Run

Run an agent on a schedule, from the dashboard, or from a form.

## Run on a Schedule

Set a schedule under **Settings** > **Schedule**.

* **Manual**: the agent never runs on its own.
* **Hourly**, **Daily**, **Weekly**, **Monthly**: select the day and hour. All times are in UTC.
* **Custom**: a [cron expression](https://crontab.guru), such as `0 9 * * 1-5` for 9am on weekdays.

The agent list displays each agent's schedule and its **Next run**.

## Run from the Dashboard

Go to the agent's **Runs** tab and click `Trigger Run`.

## Run from a Form

#### **Logic rule action**

Go to the **Logic** tab of your form, create a rule, and change the action to `Run Computer Agent`, which is available in client-side rules only. Select the agent to run. If you want to give the form filler or a reviewer a way back to the run, also select a text or URL field to receive the link to the run.

#### **From code**

In a JavaScript logic rule or an event handler, call the [Context API](/develop/context-api.md) directly. The promise resolves with the URL of the run, and does not wait for the agent to finish.

```javascript
const runUrl = await feathery.runComputerAgent('<agent_id>');
```

The agent's ID is on its **Settings** > **Properties** page.

## Pass Form Data into the Task

Use `{{field_id}}` anywhere in the task, and Feathery replaces the placeholder with the submission's value before the run starts.

```
File a new claim for policy {{policy_number}} with a loss date of {{loss_date}}.
```

## Save Downloaded Files to a Field

Set **Settings** > **Properties** > **Save downloaded files to** to a [file upload field](/platform/form-fields.md) on your form, and instruct the agent to download the file in its task. Feathery attaches every file the agent downloads to that field on the submission.

{% hint style="info" %}
Field placeholders and file saving both need a submission, so they apply only to runs triggered from a form. Scheduled and dashboard runs have no submission behind them.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.feathery.io/platform/computer-agents/trigger-a-run.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.