Your first steps in Studio

No technical prerequisites are required. Your first journey is to create a workflow, use the canvas, save it, and test it in Semantics Chat.

1. Create a workflow

1. Open your organization’s workflow list.
2. Click Create a workflow.
3. The editor opens with the Start block, the starting point of each execution.
4. Rename the workflow from the toolbar, for example HR Assistant or Level 1 Support.

You can also open an existing workflow to adapt it. Available actions depend on your role in the organization: creating, editing, importing, exporting, and deleting workflows are reserved for roles allowed to edit them.

2. Use the canvas

• Add a block: click a block in the palette or drag it onto the canvas. The palette shows available blocks in an alphabetical list.
• Connect blocks: draw a link from a block output to the next block.
• Configure a block: select it to open its side panel.
• Zoom: use the mouse wheel.
• Pan: drag the canvas background.
• Delete a block: select it and press Delete.

Block positions are purely visual; execution order is determined by the links.

If your role does not allow editing workflows, the editor opens in read-only mode: you can browse the canvas and view each block’s configuration, but you cannot add, delete, or connect blocks, or edit their fields. A block’s panel shows the message “This block is read-only”, and the Save workflow button is not displayed. Contact an administrator of your organization if you need to edit the workflow.

Your first workflow

100 %

• After success
• After failure
• Data or result

Dashed boxes represent data, services, or results.

Drag to move. Use + / − to zoom, arrow keys to move, and Home to reset.

3. Connect outputs

Most technical blocks offer two paths:

• After success continues the normal path;
• After failure leads to a fallback, usually a user-friendly Simple message.

Handle success and failure

100 %

• After success
• After failure

Drag to move. Use + / − to zoom, arrow keys to move, and Home to reset.

Some blocks offer outputs with business labels. Connect each useful output to the block that should continue the path; the panel then shows an After “label” link.

If a block expects sources or tools, use its Contextual ports section. Source and tool connections prepare that data before the block runs and are distinct from main-path links.

4. Fix issues and save

Studio continuously validates required fields, JSON, variable references, and disconnected blocks. Issues appear next to their fields and in the problems panel at the top right of the screen.

Click Save workflow after fixing the problems. If issues remain, Studio displays a confirmation before saving. Review them before testing the workflow with users.

Users do not see your changes until you save. Studio asks for confirmation if you leave with unsaved changes.

5. Test in Semantics Chat

Every message triggers a full path starting from Start.

1. Link a Semantics App to a workflow.
2. Test the minimal workflow.
3. Add blocks one at a time.
4. To inspect a variable, temporarily add a Simple message containing {{codeblock myVariable}}.
5. Deliberately trigger a failure, such as an invalid URL, and check that the error message is clear.
6. Remove debug messages before production, especially when they could reveal a token or business data.

Test both routes

Verify After failure outputs, the Else case of conditions, business outputs, connected sources and tools, and responses when a variable is empty.

6. Export and import a workflow

Export and import let you duplicate a workflow, keep a copy of it, or reuse it in another organization.

Export: in the workflow list, open the workflow card menu and click Export. Studio downloads a JSON file.

Import:

1. Open the workflow that will receive the content, or create a new one.
2. Click Import in the editor toolbar, then choose the JSON file produced by an export.
3. Confirm: the import replaces the whole content of the open workflow with the file content. The workflow name is kept.
4. Complete the configuration, then click Save workflow.

Configuration to complete after an import

The LLM model and connector of the LLM instruction and LLM request blocks, as well as the embedding model and sources of the Data sources block, are specific to an organization. They are removed on export: select them again after the import. The issues panel reports the fields to complete.