Get started with the Visual Agent Builder
Copy page
Create Agents with a No-Code Visual Agent Builder
Overview
An Agent is the top-level entity you can chat and interact with in the Visual Builder.
An Agent is made up of one or more Sub Agents. The Sub Agents that make up an Agent can delegate or transfer control to each other, share context, or use tools to respond to a user or complete a task.
You can use the Visual Builder to add Sub Agents to an Agent, give Sub Agents tools, and connect Sub Agents with each other to establish their relationships.
Creating your first Agent
-
Go to the Agents tab in the left sidebar. Then select "Create Agent".
-
Provide a name, prompt, and description.
Agent Prompt
You can configure an Agent-level prompt that gets automatically added to all Sub Agents that make up the Agent. This provides consistent context and behavior guidelines so Sub Agents respond and act as one cohesive unit.
Example uses:
- Company-wide policies and tone guidelines
- Domain-specific context that applies to all sub-agents
- Consistent behavior rules across the sub-agent network
Once an Agent is created, you can always edit the prompt by:
- Clicking on the Agent Settings button next to Try it
- Modify your prompt in the "Agent Prompt" field
- Click Save
Default Sub Agent
When you create an Agent, it'll have a Default Sub Agent by default. This is the Sub Agent that first receives and processes a user message.
Configure its name and prompt, then click Save.
Trying the Agent
To try the Agent, ensure it has at least one Sub Agent, then save the Agent by clicking the "Save changes" button in the top right corner.
Then, click the Try it button in the top right corner and type into the chat input.
Adding tools
Tools are used to perform actions in the Agent. You can register MCP tools in the Visual Builder. See the MCP Servers page to get started.
Once you have an MCP Server registered, you can add it to a Sub Agent by dragging and dropping the MCP block from the top left onto the Canvas.
To connect the tool to the Sub Agent, click the "+" icon at the top of the MCP block, then drag the connector to the Sub Agent. A line will appear, indicating that the tool is connected to the Sub Agent.
To delete a tool, click on the tool box and then hit the backspace key.
Add other Sub Agents
When you have tasks that get more complex, you'll likely want to create more Sub Agents that are specialized in narrow tasks and have prompts and tools focused on their roles.
To create more Sub Agents:
- Drag and drop a Sub Agent block from the top left toolbar onto the canvas.
- Configure the Sub Agent with its own prompt and settings
- Connect it to the parent Sub Agent by clicking the connector at the top of the Sub Agent box and dragging it to the main Sub Agent
When connected, a line will appear showing the relationship between the Sub Agents.
A few notes:
- To delete a Sub Agent, click on the Sub Agent box and then hit the backspace key.
- An Agent must have at least one Sub Agent. If you delete the default Sub Agent, add a new one before trying the Agent.
Sub Agent configuration
The following are configurable options for the Sub Agent through the Visual Builder:
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Human-readable name for the Sub Agent |
description | string | No | Brief description of the Sub Agent's purpose and capabilities |
prompt | string | Yes | Detailed behavior guidelines and system prompt for the Sub Agent |
model | string | No | AI model identifier (e.g., "anthropic/claude-sonnet-4-20250514"). Choose a model that you prefer |
providerOptions | object | No | Model-specific configuration options (temperature, maxTokens, etc.) |
Data components | object | No | Data components that the Sub Agent can use. See Data Components for details |
Artifact components | array | No | Artifact components that the Sub Agent can use. See Artifact Components for details |
Adding data components
Data components are used to render rich UI components directly in the chat. Before adding a data component, you will first need to create a data component. See the Data Components page for more information.
Then, add the data component to your Sub Agent by clicking the Sub Agent box and then selecting which data components you want to add.
Adding artifact components
To create artifact components, see the Artifact Components page for details.
Add the artifact component to your Sub Agent by clicking on the Sub Agent box in the Agent, then selecting which artifact components you want to add.
When the Sub Agent uses tools or delegates to other Sub Agents, artifacts will be automatically created according to your defined schema, capturing the source and content of each interaction.