Creating a tool
Go to Tools and click the + button. Choose Add new tool to start with a blank canvas, or Import to load a tool that was exported earlier.
A new tool opens with a setup card. Give it a name and a description, then click Proceed. These two fields decide when agents will use your tool; see How agents use your tool for how to write them.
The builder
The canvas shows your tool as a flow of steps, from Start to Return result. The panel on the right shows whatever you select: click a step to configure it, or open Settings for the tool's name, description, and parameters.
Click Save in the top right to save your changes. If something in the flow needs attention, an issues indicator appears in the bottom left. Click it to jump to the problem.
Input parameters
Parameters are the information your tool receives when it runs. Define them under Settings in the Input parameters section: a name, a description, a type (String, Number, Integer, or Boolean; use String when unsure), and whether the parameter is required.
Parameter descriptions are read by the agent, not just by you; see How agents use your tool. For how parameter values move through your steps, see Parameters, variables, context and data flow.
Adding steps
Click the + button between steps. The step menu groups steps by what they do, shows a short description for each, and is searchable. See Steps, branches and outputs for every step type.
A new step opens in the panel on the right, ready to configure.
To manage a step, open its ⋯ menu. You can Copy and Paste steps, within a tool or into another one, run the tool from that step, or Delete it. When you delete a step, the steps around it reconnect automatically.
Testing your tool
Press the play button at the bottom of the page to run the tool with test values. The debugger walks through the flow step by step and shows each step's output. See Testing your tool.
Example: order status lookup
-
The tool has one required input parameter,
order_id. -
A Call API step asks the order system for the status.
-
A Return result step sends the status back to the agent, which answers the customer.