Skip to main content
Skip table of contents

Building a New Tool From Scratch

Tools are essential for performing specific operations and facilitating seamless interactions with your AI agents. This guide walks you through the process of creating a tool from scratch.

Initial Setup

  1. Access the Tools Section:

    • Navigate to ‘Tools’ and click the blue ‘+’ icon.

    • Select ‘Add New Tool.’

      image-20250307-143259.png
  2. Define the Tool:

    • Name the tool and provide a description.

Configuring Input Parameters

  1. Specify Input Parameters in the ‘Start’ Block:

    • Open the ‘Start’ block and click ‘+ Add Parameter’ in the bottom.

      image-20250307-144134.png

    • Define the parameter name and provide a suitable description.

    • Set the correct data type using the dropdown menu.

      image-20250307-144324.png
    • Mark the parameter as mandatory by toggling the switch (blue indicates mandatory).

    • Delete a parameter by clicking the bin icon.

Building the Tool’s Workflow

  1. Adding Steps:

    • Hover under an existing step to reveal the plus icon; click it to add a new step.

      image-20250307-144451.png
    • Choose among options like API Calls, LLM Interaction, or Code Execution. More detailed descriptions can be found here.

  2. Use the Assistant:

    • You can also interact with steps using the text box on the left, called the assistant. In this box, you can communicate with the assistant, allowing you to describe desired actions without writing out the exact code. You can even ask for Python code to be generated.

    • For example, if we want to add the current date and time to the output, we can say, “Add the current date and time to the previous output,” and it will create a step for you.

    • More about the assistant in this article.

Completing and Saving the Tool

  1. Configuring the Output Block:

    • Ensure output variables are correctly formatted and, if necessary, formatted as JSON.

    • Select the appropriate variable for the output at the conclusion of the tool’s execution.

image-20250307-145206.png
  1. Saving Your Work:

    • Regularly save your progress using the save button in the toolbar to prevent data loss.

  2. image-20250307-145359.png

Testing the Tool

  1. Use the play button to test with sample parameters.

    image-20250307-145408.png
  2. Troubleshooting:

    • Use ‘Step Output’ to review any issues.

    • Navigate between steps using the arrows in the top-right corner to troubleshoot.

      image-20250307-150003.png
    • Access individual step testing options via the three dots within each step.

      image-20250307-145521.png

Finalizing the Tool

Upon satisfactory testing and adjustments, save your tool. It will then be ready for integration into your AI agent's operations, enhancing your overall AI strategy.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.