Flow Information Block

The flow information block is used to provide information about the flow. It is the first block on the canvas and is used to give the flow a name and description.

This is a critical step as it will be used by the LLM to understand the flow and the purpose of the flow and when it should be used.

Flow name

This is the name of the flow. It is used to identify the flow in the UI and in the LLM. You should give it a name that is descriptive of the flow but not too long.

Flow description

This is the description of the flow. It is used to give the LLM more information about the flow and the purpose of the flow. The best description will include:

• What the flow does
• Examples of how to use the flow or how it should be called
• Any variable definitions or limitations the LLM should know about.

all of this is optional, but the more information you provide, the better!

Flow Variables Block

The flow variables block is used to define the variables that will be used in the flow.

Variables are a way to pass data in and out of the flow on a per-step basis. They are defined in the flow variables block and can be used in the flow blocks. Any variable defined in the flow variables block can be used in the flow blocks and be used as an input or output for any block.

Variable name

Variable names are used to identify the variable in the flow. You should give it a name that is descriptive of the variable but not too long. eg: HackerNewsPostsPath

Variable default value

Leaving this blank will not affect the flow, but if you provide a default value, it will be used as the value of the variable if no other value is provided. It is possible for the LLM agent to provide a value for the variable, and this would override the default value.

JSON Object Traversal

When working with variables that contain JSON data (for example, responses from API calls), you can access nested values using dot notation or array indexing. This allows you to extract specific pieces of data from complex JSON structures.

For example, if you have an API response stored in a variable called apiResponse that looks like this:

{
  "data": {
    "users": [
      {
        "name": "John",
        "details": {
          "age": 30,
          "city": "New York"
        }
      }
    ]
  }
}

You can access specific values using the following syntax:

• apiResponse.data.users[0].name would return "John"
• apiResponse.data.users[0].details.city would return "New York"

This feature is particularly useful when:

• Working with API responses
• Processing nested JSON data structures
• Extracting specific fields from complex objects
• Chaining multiple API calls where data from one response needs to be used in another

Note: JSON object traversal can be used in any block field that accepts variables.

Flow Complete Block

The flow complete block is used to indicate the end of the flow. It is the last block on the canvas and is used to indicate the end of the flow. This block purely serves as a visual indicator for you.