> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuralfactory.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflows

> What a workflow is, when to use one instead of an agent, and who can see, build and run it.

A workflow runs a business process as fixed steps, in the same order every time. Use one when a process must always follow the same path, needs a person to approve something along the way, or must leave a record someone can review later.

> [!NOTE]
>
> **Who:** Admins and Members (Viewers do not have the page) · \*\*Where:\*\***Workforce** › **Workflows** in the sidebar · **Works on:** Enterprise and SaaS

> [!NOTE]
>
> **Workflows** carries a **Beta** badge in the sidebar, and the page opens with the notice **Workflows is in beta**. The feature still changes, so screens, options and defaults may move.

## What a workflow is

You describe a process in plain language, and the builder turns it into steps. A step can ask a model to write something, call a tool, run code, check a value, or wait for a person to approve. Every run then follows those steps in order.

Take an expense claim. The workflow reads the claim, checks the amount against the policy, asks a manager to approve anything over the limit, and drafts the reply to the employee. Each run records what every step received and produced, who approved what, and what the run cost.

## Workflows and agents

| | Agent | Workflow |
| - | - | - |
| How it works | Decides for itself what to do next, in a conversation | Runs the steps you defined, in the order you defined |
| What you give it | A message | The inputs its form asks for |
| Same input, same path | Not guaranteed | Yes: the steps and the rules between them are fixed |
| People in the loop | Can ask you a question | Can stop at an **Approval** step until someone approves or rejects |
| Versions | Agent versions | Numbered revisions; one of them is the published one |

Use an agent for open-ended work and conversation. A workflow can still use a model or a bounded agent inside one of its steps. An agent can also be given workflows to run (see [Configuring agents](https://docs.neuralfactory.ai/user-guide/agents/configuring-agents.md)).

## Find a workflow in the list

The list shows the workflows you can see. Click a row to open the workflow.

Above the table you can search by name and filter with **All workflows**, **Favourites**, **Has pending approval** or **Failing** (the last run failed or timed out). When any workflow carries tags, you can also filter by **Tag**. Click a column header to sort.

![The Workflows list with Expense approval, marked Published r1 with a completed last run, and Leave request approval, marked Draft, below the Workflows is in beta notice.](https://mintcdn.com/neuralfactory/y-MI7aIFykaw0cY2/images/app/workflows-list.png?fit=max\&auto=format\&n=y-MI7aIFykaw0cY2\&q=85\&s=d11887a43cb52669c9078ea9871bf8c1)

| Column | What it shows |
| - | - |
| Star | Adds the workflow to your favourites. Favourites also move to the top of the worker picker on **New task**. |
| **Name** | The name, its state (see below) and its description. |
| **Last run** | The status of the most recent run and when it finished. Click the status to open that run. |
| **Runs (30d)** | How many runs started in the last 30 days. |
| **Health** | One square per recent run, newest first, up to 10: green completed, red failed, amber awaiting approval, blue running, grey pending or skipped. A **pending** badge counts runs waiting for an approval. |
| **Cost (30d)** | What the runs of the last 30 days cost. A dash means no run in that window was priced. |
| **Created by** | The owner. Not shown on a personal account. |

| Badge | Meaning |
| - | - |
| **Draft** | Never published. Only its owner and admins can run it. |
| **Published r3** | Revision 3 is the one runs use. |
| **Published r3** **draft r5** | Revision 3 is published. Revision 5 is a newer draft that is not published yet. |
| **Awaiting approval** | At least one run is paused on an approval step. |
| **Archived** | Kept with its runs and revisions, but it cannot be run or scheduled. The row is dimmed. |

## Row actions

Open a row's menu for these actions.

| Action | What it does |
| - | - |
| **Run** | Opens the workflow page to run it. Not offered for an archived workflow. |
| **Duplicate** | Makes a private draft copy named "Copy of ...", owned by you. Its history, sharing and published state are not copied. The copy counts against your plan like any new workflow. |
| **Copy ID** | Copies the workflow's ID, for use with the API. |
| **Archive** / **Restore** | Owner and admins. An archived workflow keeps its runs and revisions, but nobody can run or schedule it until it is restored. |
| **Delete** | Owner and admins. Deletes the workflow with its revisions, schedules and pending approvals. Its past runs are kept. This cannot be undone. |

> [!WARNING]
>
> Delete is refused while a run of the workflow is in progress or waiting for an approval. Cancel those runs or let them finish first.

## Share a workflow

A new workflow is **Private**. Its owner or an admin changes this on the workflow page under **More actions** › **Settings & sharing**.

* **Private**: only the owner and the organization's admins can access it. An admin can also grant access to specific **Users** and **Groups**.
* **Public**: every member of the organization can access it.

Only an admin can pick specific users and groups. A member who owns a workflow can switch it between private and public.

## Who can do what

| | Admin | Member | Viewer (Enterprise) |
| - | - | - | - |
| Open the **Workflows** page | Yes | Yes | No (redirected to **New task**) |
| Build a workflow | Yes | Yes | No |
| See a workflow | Every workflow in the organization | Their own, public ones, and those shared with them | No |
| Run the published revision | Every workflow | Every workflow they can see | No |
| Edit, publish, archive, restore, delete, schedule | Every workflow | Their own workflows | No |
| Test-run the draft or run an older revision | Every workflow | Their own workflows | No |
| Decide an approval | Yes, for any approver requirement | When they match the step's approver requirement | No |

A member who opens a workflow someone else owns sees it read-only. They get the published revision only, with **Run**, **Overview** and **Run analytics**. If it was never published, the page says **This workflow isn't published yet**.

Viewers cannot build or run workflows. The worker picker on **New task** offers them agents only, and the **Inbox** is not in their sidebar.

## Enterprise and SaaS

Workflows work the same on both deployment types. The differences are limits and accounts.

* **Enterprise**: no limit on the number of workflows. By default, up to 25 workflow runs can be in progress at once in the organization, unless your installation sets another value.
* **SaaS**: on the Free plan, agents and workflows together count as workers, and the plan allows 3. At the limit, **Build a workflow** is disabled and its tooltip says **Worker limit reached (agents and workflows)**. Each plan also sets how many workflow runs can be in progress at once. See [Plans and limits](https://docs.neuralfactory.ai/user-guide/admin/billing.md).
* **SaaS personal account**: you are the only person on the account. There is no sharing, the menu item is **Settings** instead of **Settings & sharing**, and the **Created by** column is hidden. Since nobody else can decide an approval, you can decide an **Approval** step only when it allows self-approval (see [Approval steps](https://docs.neuralfactory.ai/user-guide/workflows/building-a-workflow.md#approval-steps)).

## Related

* [Building a workflow](https://docs.neuralfactory.ai/user-guide/workflows/building-a-workflow.md): describe a process and turn it into steps, inputs and approvals.
* [Running a workflow](https://docs.neuralfactory.ai/user-guide/workflows/running-a-workflow.md): run it, follow the run and decide approvals.
* [Agents and workflows](https://docs.neuralfactory.ai/user-guide/concepts/agents-and-workflows.md): when to choose which.
* [Build your first workflow](https://docs.neuralfactory.ai/user-guide/guides/first-workflow.md): a step-by-step example.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.