Create an Agent

Last updated: April 27, 2026

You can create a custom Agent from a blank configuration using the Agent Builder. From the builder, you can edit inputs and outputs, add nodes as steps, and run tests.

Click “Agents” in the left navigation bar, then click “+ New Agent” to open an empty Agent in the editor.

You don’t have to build an Agent from a blank configuration. You can use a pre-built Agent as is or customize it further.

Configure Inputs

All agents begin with an Input block. Agents use inputs as initial variables that are passed through the first steps of the Agent. Input variables remain accessible to all later steps.

Add Inputs

Click the Input step to configure inputs. Clicking any step opens the step menu. Select “+ Add input” to add new inputs to the Agent.

wf-1.png

When adding an input, you must configure three settings:

  • Label - The name you will use to reference the input variable in later steps.

  • Type - Inputs can be either number or text.

  • Required - Specifies whether the Agent requires this input or whether it is optional.


Add Nodes as Steps

After defining inputs, you can begin adding new nodes as steps. Each step represents an action and must be placed in the correct order within the Agent.

You can add a node by clicking the “+” icon in the Agent Editor or by dragging an Agent action from the left navigation bar into the editor.

wf-2.png

Each node has its own required inputs and outputs. For example:

  • Prompting an answer engine requires you to configure the prompt and label the response as an output.

  • Retrieving data from Answer Engine Insights requires specifying the report type, metrics, and other relevant parameters.


Use Variables in Steps

Variables allow you to pass information between steps. You can reference variables as part of a step’s inputs, and you can generate new variables from a step’s outputs.

Use a Variable as an Input

Any input field that accepts variables includes an “(x) Add variable” icon. Click this icon and select the desired variable to include it in the field.

You can also combine static text with a variable. For example, when creating a prompt for an answer engine, you might use an input such as:

“Please write a short description of {custom variable}.”

workflow-var.gif

Label Output Variables

You must label output variables so they can be referenced in later steps. All steps that produce outputs include an Output Label field in their configuration.

Use clear, descriptive variable labels. These become the variable names you select when configuring subsequent steps. 

Note that you cannot reference an output variable in any step that occurs before it is created.


Add Conditionals

Conditionals are decision points that branch your Agent workflow based on variable values.

Learn how to add and configure Conditional nodes, define comparison expressions, and set up multi-condition logic to route your Agent down different paths depending on inputs or previously generated values.


Add Iterations

Iterations let your Agent repeat the same sequence of steps across every item in a list — taking multiple inputs and producing multiple outputs in a single run.

Learn how to add and configure Iteration nodes, define your list input, build steps inside the loop, and structure your output for bulk processing use cases.


Final Output

The final step in an Agent is the Output step. Unlike outputs generated by individual steps, the final output signifies the completion of the entire Agent.

The Output step can return a final result, such as generated content. Alternatively, the key action of the Agent may occur in an earlier step, with the Output step simply marking the end of the run.

You can add a final Output step and end the Agent by selecting the "End" node.

Screen Shot 2025-12-09 at 4.22.22 PM.png

Publish a Agent

New Agents start as a draft. This allows you to make edits and indicate that the Agent is in testing. Once the Agent is in a production ready state, simply click “Publish” to make the Agent live.