Agent - Workflows

Agent - Workflows

This page outlines how to create, run, and manage Workflows and Tasks in Agent. It describes required fields, configuration options, and current limitations.

Workflows are currently only available in the desktop layout of Agent, not on mobile.

Users can view all created Workflows in a list, including the number of tasks associated with each Workflow.

image-20251017-102923.png

Files used to test or run a Workflow must be uploaded to Agent first. It is not possible to upload them directly on the Task Test or File Assignment pages.

Run a Workflow

To run a Workflow, select it, choose the files it should process, and then start the run. The following steps describe this process in the Agent UI.

Step 1: Select Workflow

Navigate to the Workflow tab and click the Run button for the Workflow you want to execute.

image-20260203-092238.png

Step 2: Select Files

In the file selection area, browse the list of available files and file groups. Select the files or groups that contain information relevant to your Workflow tasks so that Agent has the necessary context.

Basic Task Chain

A Basic Task Chain runs each of its Tasks for each of the selected files.

image-20251017-103332.png

Basic Workflows can only be run with up to 10 files at a time.

Flexible Workflow

A Flexible Workflow supports assigning files to individual Tasks using the matrix table.

  1. For each selected file, use the table to assign it to relevant Tasks.

  2. Each Task in the matrix must have at least one file assigned.

  3. Files can be assigned to multiple Tasks if they are relevant to more than one Task.

image-20251017-105345.png

 

Step 3: Run the Workflow

Review your file selections and click Run to start the Workflow.

image-20260203-092432.png

Create a Workflow

When creating a new Workflow, you can choose between two types: Basic Task Chain and Flexible Workflow.

  1. Add a Workflow Title: Enter a descriptive title for your workflow.

image-20260203-092636.png
  1. Choose Workflow type: Select either Basic Task Chain or Flexible Workflow.

    1. Basic Task Chain: Tasks run one by one, applying the same actions consistently across each selected file.

    2. Flexible Workflow: Allows different inputs per task and supports dependent tasks that use results from previous steps.

If a task exists in the Workflow, the Workflow type is locked and cannot be changed.

  1. Choose model: Select the LLM that will process the Workflow’s Tasks.

  2. Create Task sequence: Map out the actions your Workflow will take. Tasks can be rearranged unless they are dependent tasks.

image-20260203-092751.png
  1. Add a description (optional): If added here, the description is displayed to users before they run the Workflow.

Task Options

  • Preview: View the task details.

  • Edit: Modify the task configuration.

  • Delete: Remove the task.

You cannot delete a task if it is a dependent task.

Create and Edit Tasks

Create/Edit Basic Task Chain

  1. Define the Task: Provide a title and instructions.

  2. Result Output: Specify the type of result output.

  3. Test: Run a test to preview the task outcome.

Create/Edit Flexible Workflow

  1. Define the Task: Provide a title, instructions, and a knowledge base (sources for the knowledge base, result from previous task, and/or additional information).

  2. Result Output: Specify the type of result output. You can also choose not to show this result in the final output and add additional format specifications (optional).

  3. Test: Hidden when using Result from previous Task as a knowledge base.

image-20260203-092954.png

 

image-20260203-093024.png

 

image-20260203-093116.png

 

Basic Task Chain

A Basic Task Chain runs its tasks one by one against all input documents.

Required Components:

  • Title: A clear and descriptive title (up to 100 characters).

  • Instructions: Detailed instructions on how the task should be carried out (up to 30,000 characters).

  • Result Output: Choose one:

    • Detailed Explanation: Comprehensive text responses with explanations and context.

    • Numerical Value: Specific numbers or quantitative data.

    • Confirmation Statement: Straightforward yes/no or true/false responses.

Flexible Workflow

A Flexible Workflow lets you assign specific files or results from previous tasks to each task. Use this for workflows where tasks depend on different inputs or on earlier outputs.

Required Components:

  • Title: A clear and descriptive title (up to 100 characters).

  • Instructions: Detailed instructions on how the task should be carried out (up to 30,000 characters).

  • Knowledge Base: Enhance the task's context and resources by including one or more of:

    • Files: Use uploaded documents as context.

    • Result from Previous Task (Dependent Tasks): Incorporate outputs from earlier tasks. At least one previous task must exist. When this option is selected, the Test section is unavailable.

  • Additional Information: Add any relevant information (up to 30,000 characters). If this option is selected, the field is required.

  • Result Output: Choose one:

    • Detailed Explanation

    • Numerical Value

    • Confirmation Statement

  • Do not show the result in the final result: Option to hide the task result from the final Workflow output.

  • Additional format specifications: (Optional) Custom format specifications describing how the task result should be presented.

Manage Workflows

Editing a Workflow (from the Workflows list)

To edit a Workflow, hover over its entry in the list. The Edit (pencil) and Delete (trash can) icons are displayed. Click the Edit icon.

image-20250611-074739.png

Reorder Tasks in a Workflow

You can reorder tasks within a Workflow. However, tasks that depend on previous tasks must remain after the tasks they depend on.

  • Constraints:

    • Dependent tasks must be placed after their dependencies. Attempting to move a dependent task in a way that would break this constraint will result in an error message:

"You can't move this task because the dependent task must be placed after its dependencies."

Identifying Dependent Tasks

Dependent tasks within a workflow are marked with a connection icon. This indicates that the task relies on a previous task in the sequence.

  • Connection Icon:

    • The connection icon is displayed next to dependent tasks, helping users quickly identify tasks that have dependencies.

Edit a Workflow (from the Run screen)

On the Run Workflow screen, an Edit Workflow button appears next to Run in the upper-right corner. It provides the same editing options as the Edit button on the Workflows list.

obraz-20250612-130126.png

Delete a Workflow

To delete a Workflow, hover over its entry in the list. The Edit (pencil) and Delete (trash can) icons are displayed. Click the Delete icon.

image-20250611-074851.png

A confirmation dialog will then appear.

Deleting a Workflow is irreversible.