> For the complete documentation index, see [llms.txt](https://developer.emporix.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.emporix.io/value-stream-modeller/value-stream-designer/creating-value-stream.md).

# Creating a Value Stream

Using the Value Streams dashboard, you can create, edit, and monitor your processes. The value streams are made up of a combination of triggers and process steps. It is required to have at least one trigger in a value stream.

## Prerequisite

Before starting to build your value stream, get familiarized with the concept of the building blocks and how they work. See the [Value Stream Components](/value-stream-modeller/value-stream-designer/process-components.md) guide.

## Building a process - simple flow

The example shows how to build a basic flow with Value Stream Modeller.

{% stepper %}
{% step %}

#### Choose to create a value stream

Go to the Value Streams dashboard and choose **Create Value Stream**. The process creation is initiated, allowing you to either select **Start from a Template** or **Start from Scratch** for the design.

* If you choose **Start from a Template**, you can select the process template from the ones available in the [Value Stream Examples](/value-stream-modeller/value-stream-examples/pl-introduction.md). You can adjust the process to your needs based on the defined template triggers and steps.
* If you choose **Start from Scratch**, you start your configuration with no configured triggers or steps.

The next steps follow the **Start from Scratch** process creation.
{% endstep %}

{% step %}

#### Add a process name

After choosing **Start from Scratch**, add a **Value Stream Name** and a **Description** for the process. The name is required for the process. The description is optional, but recommended as it may help you identify your processes when their number rises.

<figure><img src="/files/MmonhZu7I56I0ngzdL9i" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Choose a process trigger

Every process begins with a trigger event that starts the entire flow. A pre-configured list of events is available out-of-the-box to choose from. For example, the registration of a new customer can serve as such a trigger. The starting trigger can be both a CE event related to any commerce operation, or a custom event created in your tenant.

<figure><img src="/files/wCNCFseN9bepQ6dWp4Tc" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Add a process step

Once the trigger is defined, you can configure the subsequent steps in the workflow by selecting them from a list of available process actions. Use them to build the flow according to your business requirements. To start creating a new step, the **add** icon and then **step**.

<figure><img src="/files/sYkwWRWmBAMOlz12xtgx" alt=""><figcaption></figcaption></figure>

* **Option 1: Add a Scenario**

  From the step type list, select **Scenario** - it represents an action to happen. For example, when a new customer is created you want to welcome them with an email with some first account information. In that case, you use a scenario build for your tenant.

  Decide whether to use a fixed scenario (a predefined setup) or a configurable one (one that allows further adjustments).

  Save your selection to include the scenario in your process.
* **Option 2: Add a Subflow**

  Select **Subflow** as the step type. From the drop-down list, choose one of the value streams already available in your tenant. For example, add a subflow that sends a coupon together with the welcome email for new customers.

  Save your selection to include the scenario in your process.
* **Option 3: Add an AI Agent**

  Choose an AI Agent as the step type. Select the agent that fits your value stream or business need. Available agents include:

  * Agentic Filters Creator Assistant – helps define step and trigger filters with AND/OR conditions on event types
  * Anti-Fraud Agent – detect and prevent fraudulent actions
  * Complaint Agent – handle customer complaints
  * Frontend Agent – assist customers on the storefront with natural language shopping and support
  * Support Agent – assist with customer requests or questions
  * Translation Agent – automatically translate content

  Configure the agent name, description and prompt as needed and save the step.
  {% endstep %}
  {% endstepper %}

Whenever you want to remove a trigger or a process step, you can do so directly in the relevant block by choosing the **Remove** action under the three dots icon.

<figure><img src="/files/YlWx6MNWzO0DsIujh6vV" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Scenarios, subflows and triggers are normally predefined and are used directly within the Value Stream Modeller to build and execute process flows. They are set up using Make. For more detailed and technical information on how they are configured and prepared, see:

* [Triggers](/value-stream-modeller/value-stream-designer/process-components/triggers.md)
* [Process steps](/value-stream-modeller/value-stream-designer/process-components/process-steps.md)
* [VSM and CE Make Modules](/value-stream-modeller/value-stream-designer/make-modules.md)
* [Configuring a connection between VSM and Make modules](/value-stream-modeller/value-stream-designer/configuring-make-connection.md)
  {% endhint %}

## A process with multiple triggers

When creating a value stream, you can choose multiple triggers to start your processes. If multiple triggers are defined at the start, only one of them needs to occur for the process to begin. Once an event has been added as a start trigger, it cannot be added again. The triggers can be of a different type, for example a commerce event together with a timer trigger.

To create a process that starts with multiple triggers:

{% stepper %}
{% step %}

#### Add a first trigger in the process

Configure it in the trigger step sidebar.

<figure><img src="/files/K8ScNT0pbklwy0JfO0RS" alt="Value stream with the first trigger configured in the Trigger step sidebar" width="550"><figcaption><p>First trigger configured in the flow</p></figcaption></figure>
{% endstep %}

{% step %}

#### Add additional triggers for the same process

You can add an additional trigger in two ways—using the three dots icon in the first trigger, or the **Add** icon in the process flow:

* Use the **three dots** icon: Select the three dots icon on the first trigger and choose **Add More Triggers**.

  <figure><img src="/files/vyFWvnjomb2HolACrl2Z" alt="Trigger context menu opened from the first trigger with Add More Triggers selected" width="550"><figcaption><p>Add an additional trigger from the trigger menu</p></figcaption></figure>

  This opens the sidebar, where you can configure the additional trigger type.

  <figure><img src="/files/NnFbpeQ2oleT5TmKnyLz" alt="Trigger step sidebar configuring an additional trigger with Timer Events selected" width="550"><figcaption><p>Configure the additional trigger in the sidebar</p></figcaption></figure>
* Use the **Add** button by hovering over: Select the **Add** button in the process flow to open the configuration sidebar. You can only use this option if you have at least two triggers.

  <figure><img src="/files/LlHHeYQU5mMuy2zra3sT" alt="Value stream with two start triggers and the Add button used to configure another trigger" width="550"><figcaption><p>Add another trigger from the flow canvas</p></figcaption></figure>

**Result**: After saving, the new trigger is added to the start of the value stream and appears in parallel with the other starting triggers.

<figure><img src="/files/6jLkT3iPZQSBtwRQ2cY7" alt="Value stream canvas showing a flow with multiple configured start triggers"><figcaption><p>Value stream with multiple configured triggers</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Using triggers between process steps

If your value stream needs to pause until a specific event occurs, it can enter a dormant or sleeping state. During this time, the process remains active in the background but does not continue to the next steps until a specific event happens.

To wake up a sleeping process instance, you need to add a trigger that allows the process to continue when the expected event occurs. When setting up such a trigger, you can place it between process steps. However, only custom events can serve as intermediate triggers. This means that if you select an event from the drop-down list to configure the trigger, the CE events are not be visible.

You can add a middle trigger only after adding a step. Triggers cannot follow another trigger directly—only a single trigger or multiple triggers at the same level are supported.

## Process conditions

You can control when and how steps run in three ways: **step filters** (run a step only when the event type matches), **conditional steps** (branch into different paths based on conditions), and **looping** (repeat steps until a condition is met). For how to configure and use each option, see [Conditions](/value-stream-modeller/value-stream-designer/process-components/conditions.md).


---

# 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:

```
GET https://developer.emporix.io/value-stream-modeller/value-stream-designer/creating-value-stream.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
