FlowTruxFlowTrux/Docs
Docsgetting started

Quickstart

Create your first AI workflow in 5 minutes.

Build and run your first workflow - a manual trigger that sends a prompt to an AI agent and returns the response.

Prerequisites

  • A FlowTrux account
  • At least one AI provider key configured in Settings > AI Providers (Anthropic, OpenAI, or Google Gemini) - see AI Providers
  • The AI provider assigned to your current workspace in Settings > Workspaces > Edit - see Workspaces

Step 1: Create a New Workflow

From the sidebar, click the + button to create a new workflow. Give it a name like "My First Workflow".

Step 2: Add a Trigger Node

Every workflow starts with a Trigger node. One is added automatically when you create a workflow. Click on it to open the Inspector panel on the right.

Set the trigger type to Manual - this lets you run the workflow on demand with custom input data.

In the Static Data field, add some test input:

{
  "topic": "the history of coffee"
}

Step 3: Add an Agent Node

Open the Node Palette on the left and drag an Agent node onto the canvas.

Step 4: Configure the Agent

Click on the Agent node to open its configuration in the Inspector panel.

  1. Model - select a model from the dropdown (only models from your workspace's assigned providers appear)
  2. System Prompt - tell the agent what to do:
You are a helpful research assistant. Write a concise, informative summary about the given topic in 2-3 paragraphs.
  1. User Prompt - reference the trigger data using template variables:
Write about: {{trigger.data.topic}}

Step 5: Connect the Nodes

Drag from the Trigger node's output handle (bottom) to the Agent node's input handle (top). A connection line appears between them.

Step 6: Run the Workflow

Click the Run button in the toolbar. The workflow executes - the Trigger fires with your static data, then the Agent processes the prompt.

Each node highlights as it executes. When complete, click on the Agent node to see its output in the Inspector panel.

Step 7: View Execution History

Open the Execution History panel to see past runs. Each execution shows status, duration, and per-node logs with inputs and outputs.

What's Next

Now that you have a basic workflow running:

  • Add an Action node - make an HTTP request or connect to an MCP tool
  • Add Logic nodes - use If-Else or Switch for conditional branching
  • Set up a webhook trigger - let external services trigger your workflow
  • Use template variables - reference outputs from previous nodes with {{steps.nodeId.output.field}}

Explore the full guides:

← IntroductionCore Concepts→