Run a workflow

Before you start

  • An agent must be installed and signed in on the computer that has the project. See Set up your first AI agent.
  • In a project someone shared with you, you need Can work access to run workflows.

Steps

  1. Open Workflows

    Select Workflows in your project’s tabs, the row of icons under your projects at the top left of the window. Your workflows are listed under the tabs. In a narrow window, such as on a phone, the tabs sit over the list; if a workflow’s page is open, select Workflows at its top left first. In the iPhone app, open the project and select the Workflows tab.

  2. Find the workflow

    In All, the scheduled workflow that runs next comes first, under Up next. Then come workflows you’ve pinned, under Pinned, your other scheduled workflows, under Scheduled, and each collection’s workflows, one per line. Select the magnifying glass at the top and type to list only the ones that match, or choose Scheduled or a collection from the list’s title, All workflows.

  3. Select Run

    Point at the workflow’s line, and its icon turns into Run, a play button. Select it to run the workflow. On a touch screen, Run always takes the icon’s place. From the keyboard, type in the search: the first match is highlighted, the Down and Up arrow keys highlight another, and Enter runs the highlighted one. Or select the workflow’s name to open its page, then select Run at the top right. In the iPhone app, select Run on the workflow, or open it and select Run workflow.

    The Workflows library, with the pointer on a workflow’s line and its icon turned into Run, a play button. Highlighted: Run.The Workflows library, with the pointer on a workflow’s line and its icon turned into Run, a play button. Highlighted: Run.
  4. Follow the run

    Enjoy switches to the new conversation, named after the workflow. Its first message shows the workflow as a chip, and the agent starts working.

    The new conversation the run opened, with the workflow shown as a chip in the first message. Highlighted: The workflow chip in the first message.The new conversation the run opened, with the workflow shown as a chip in the first message. Highlighted: The workflow chip in the first message.

Good to know

  • Each run is its own conversation with a fresh agent session. Reply in it to steer the agent or ask follow-up questions, like any conversation.
  • A run uses the workflow’s preferred agent if it has one. Otherwise it uses the agent settings you last used in the project. See Choose which agent runs a workflow.
  • The run keeps a copy of the instructions from the moment it starts. Editing or deleting the workflow afterwards doesn’t change a run that’s already going.
  • While a run is still working or waiting for your approval, the line under the workflow’s name says Running, and Run in its icon’s place opens that conversation instead. Run at the top of its page becomes View run. In the iPhone app’s list, the button reads View run.
  • You can’t start the same workflow twice at once. While a run is going, View run opens that conversation instead of starting a new run, and so does Enter in the search field. Once the run finishes, you can start another.
  • Running a workflow yourself doesn’t change its schedule.
  • Selecting Run on a workflow’s page saves any change you just made first, so the run uses it.
  • To run it once with one of your presets or another agent or model, or to start a new conversation with it and add details before sending, use the arrow beside Run on its page. See Run a workflow with another agent.
  • You can also add the workflow to a message you’re writing. See Add a workflow to a message.

If something goes wrong

Run is greyed out, or the icon doesn’t turn into Run

  • The workflow shows Desktop review needed under its name. Enjoy couldn’t confirm the workflow is still the one that was saved, for example because a scheduled workflow’s file was changed outside Enjoy, or because a device that saved it was removed. On your computer, open it and check the instructions. Then select Confirm next to “Desktop review needed before running.” If that shows an error, see Edit a workflow. The web app shows the same notice without Confirm, and in the iPhone app the button reads Review on your computer.
  • You have View only access to the project.

“Workflow no longer exists.”

Someone deleted the workflow, perhaps from another device. If you need it back, see Delete a workflow for how to restore it from an earlier run.

A run fails with “This saved work couldn’t be verified.”

Enjoy couldn’t verify the saved workflow against its separate record on this computer. Older versions say “Saved work changed or its origin record is missing.” This can also happen when the record is missing or unreadable; it does not necessarily mean you edited the workflow’s file.

If Details says the record couldn’t be read, retry after restarting Enjoy on the computer running the project. For other causes, open the workflow, review its instructions and schedule, and save it again. Then run the workflow again. Retrying the old failed request does not repair its record. See A conversation failed for how to include the diagnostic details in feedback.

The conversation opens but the agent doesn’t start

The agent may not be signed in or installed on the computer. See A conversation failed and An agent won’t sign in.

See also

  1. 01What are workflows?Workflows · 6 min
  2. 02Run a workflow with another agentWorkflows · 2 min
  3. 03Pin or duplicate a workflowWorkflows · 3 min
  4. 04Schedule a workflowWorkflows · 5 min
  5. 05Choose which agent runs a workflowWorkflows · 2 min

Did this help?

Service

If Enjoy doesn’t work as this manual describes, a person will help.