Skip to main content

Overview

An automation runs an agent when a trigger fires. It stores the instructions for that run, and the tools the agent can use. A new automation is Inactive. It does not run until you save a trigger and instructions, then set it to Active. You choose the agent that runs. The default agent is Idalia. You can choose a custom agent instead. The reviewer checks suggestions from the automation. When the reviewer is empty, Idalia uses the person who created the form.

View automations

You can view and manage automations from the Automations page. Search the list, switch between All, Enabled, and Disabled, and open an automation. Open an automation to see Settings and Runs. Settings is where you edit the automation. Runs is the history of each time it fired.

Ask the agent

Open the chat. See Using AI. Tell the agent what starts the automation and what it must do. Example: “When the Site diary form is submitted, create a transport order from the answers.” The agent writes the instructions and saves the automation. The automation stays Inactive until you ask the agent to turn it on, or you set it to Active on the automation page.

Create an automation

On the Automations page, press Create (shortcut C). Idalia opens a new automation named Untitled. It is inactive, and it has no trigger and no instructions. Change the name on the automation page. A name is required when you save.
If your role cannot create automations, the Create button is hidden.

Add a trigger

A trigger is the event that starts a run. An automation needs at least one trigger before you can turn it on. On Settings, press Add trigger. When something happens
  • Form submitted — choose the form. The automation runs when someone submits that form. You can add more than one form. The same form cannot be added twice.
  • Email received — the automation runs when someone on your team sends email to your workspace address from their Idalia account. The address is your workspace slug plus @ai.idalia.app. An automation can have one email trigger. Press Add trigger in the dialog to keep it.
On a schedule Open Every… and choose Hour, Day, or Week.
  • Every hour runs at the start of each hour.
  • Every day runs once a day at midnight.
  • Every week runs once a week on Sunday at midnight.
These times use UTC. Hover a trigger and press the remove control to take it off the automation. Save to keep the change.

Write the instructions

On Settings, write Instructions. Say what should happen when the automation runs. Instructions are required. Press Save (shortcut ⌘ + Enter). The trigger and the instructions are not active until you save them.

Choose the agent and tools

On Settings, set these before you save:
  • Agent — Idalia, or a custom agent that is active.
  • Reviewer — Form creator, or a person in the workspace.
  • Tools — press Add Tool and choose Send Email when the agent may email people. Send Email sends one message to the people you select. Add at least one recipient. The automation cannot turn on while Send Email has no recipients.

Turn an automation on

Save first. Then set the switch to Active. Idalia blocks the switch when the saved automation has no instructions or no trigger. The dialog lists what is missing. If you added them and did not save, the dialog says Save required. Set the switch to Inactive to stop new runs. Past runs stay on Runs.

Read a run

Open Runs on the automation. Each row is one run. The status is Pending, In Progress, Completed, or Failed. Open a run to read what the agent did. The list says No runs yet until the first trigger fires.

Update an automation

Open the automation and change the name, triggers, instructions, agent, reviewer, or tools on Settings. Press Save. If the automation is active, save the change before you expect the next run to use it.

Delete an automation

Delete is permanent. Use it when the automation should leave the workspace.
  1. Open the automation.
  2. Open the ⋯ menu.
  3. Choose Delete.
  4. Confirm in the dialog.
Idalia takes you back to the Automations list.