Build Your First Workflow

This tutorial guides you through building a multi-node workflow with model invocation and output formatting on the visual canvas, demonstrating the core execution model of the FastGPT workflow engine.

Learning Goals and Prerequisites

By completing this tutorial, you will understand how execution edges and data references govern workflow runs, combining nodes into an operational pipeline: "Start → AI Chat (with optional Assigned Reply)".

Before starting, confirm the following prerequisites:

• Resource creation permissions in your current workspace team.
• An active chat model configured in the team.
• Basic familiarity with workspace navigation.

Step 1: Create a Blank Workflow

1. Log in to FastGPT and click "Studio" in the left navigation bar. Click "Create your first Agent" in the center of the page (or the "New" card in the list if applications already exist) to open the "Create Agent" page.
2. Select "Workflow" under "Agent Type", enter Summary Assistant as the name in the icon & name area, and click "Create".
3. The canvas initializes with only a "Start" node (the entry trigger for user messages).

Step 2: Add and Configure the AI Chat Node

1. Add node: Click the black + (Add Node) button on the floating toolbar on the left side of the canvas to open the left node panel, then click or drag "AI Chat" from the "AI Capability" group under the "Basic" tab onto the canvas (you can also click the + on the blue right handle of the "Start" node and choose "AI Chat" in the popup panel). Right-clicking blank canvas space opens a context menu with three items: "Automatic alignment", "Add comment", and "Collapse all" ("Expand all" when all nodes are collapsed).
2. Connect execution edge: Ensure a line connects the right handle of the "Start" node to the left handle of the "AI Chat" node. Execution edges determine execution order.
3. Configure node parameters (matching the screenshot below):
   • AI Model: Keep Manual Select and pick an available chat model (such as qwen3.8-flash).
   • Prompt: Keep Manual Input and enter Summarize the user's text in exactly three bullet points. Preserve names, dates, and quantities..
   • User question: Keep {x} Variable Citation selected on the right, click the variable dropdown below, and bind it to Start > User Question.

Step 3: Configure Response Output Mode

Workflows support two ways to return chat responses to the user:

• Option 1: Direct output from the "AI Chat" node (default, shown in screenshots) By default, the "AI Chat" node streams its generated reply directly to the chat window. Click the gear icon to the right of the "AI Model" dropdown on the "AI Chat" node to open the "AI Settings" dialog; the "Hide AI output" toggle sits at the end of the "Basic settings" section. Keeping it turned off sends the summary directly to the user.
• Option 2: Custom formatting with an "Assigned Reply" node (optional) To wrap the model output with custom prefix or suffix text:
  1. Click the black + (Add Node) button on the left canvas toolbar, and under the "Basic" tab ("tool" group), add an "Assigned Reply" node.
  2. Connect the right handle of the "AI Chat" node to the left handle of the "Assigned Reply" node.
  3. Click the gear icon next to the "AI Model" selector on the "AI Chat" node and turn on "Hide AI output" at the end of the "Basic settings" section so the response is only sent once.
  4. Configure the "Response Content" field on the "Assigned Reply" node (its mode selector on the right defaults to Manual Input):
     • Output model reply only: Switch the mode dropdown next to "Response Content" from Manual Input to {x} Variable Citation, then select AI Chat > AI Response Content.
     • Combine fixed text with model reply: Keep Manual Input, type your introductory text (for example, Here is your 3-point summary:), press / to open the variable picker, and select AI Chat > AI Response Content.

Step 4: Click "Run" for End-to-End Debugging

1. Click the "▷ Run" button in the upper right corner of the canvas to open the "Run Preview" drawer on the right.
2. Enter the following test text in the "Run Preview" input box:

The workshop is on Friday. It starts at 10:00 and lasts two hours. Bring a laptop.

3. Submit the message and inspect the result:
   • The "Run Preview" drawer returns three concise bullet points preserving Friday, 10:00, two hours, and laptop.
   • Click "Run Details" below the response to inspect the input parameters, output values, status, and duration for each node.

Step 5: Save and Publish the Active Version

1. After confirming the output quality, click the "Save" button in the upper right corner and select "Save and Publish" from the dropdown.
2. Enter a version name (such as Summary Assistant v1) in the dialog and click "Confirm".
3. The newly published configuration takes over public channel requests immediately, while draft modifications remain isolated in your workspace.

Orchestration Troubleshooting

Next Steps

• Conditional routing: Split execution paths based on logic in Condition Switch Node.
• Intent classification: Route messages by semantic category in Question Classifier Node.
• Batch processing: Handle collections efficiently in Loop Execution Node and Parallel Execution Node.