For the complete documentation index, see llms.txt. This page is also available as Markdown.

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, 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 directly. The promise resolves with the URL of the run, and does not wait for the agent to finish.

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.

Save Downloaded Files to a Field

Set Settings > Properties > Save downloaded files to to a file upload field 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.

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.

Was this helpful?