Skip to main content
Custom tools let an agent do something the built-in tools can’t, such as checking stock in your own system, looking up an order status, or searching your catalogue in a specific way. Only enabled tools reach the agents. Open them from Build → Custom tools. The Custom tools page with an enabled check_unit_availability tool

Create a tool from a task

The quickest way is to describe the job in plain words. Build a tool from a task description
  1. Choose Create from a task.
  2. Describe The task, for example “Check if a unit type is still available in a project”.
  3. Optionally add API details: an endpoint, a curl command or a link to the docs.
  4. Choose who it is Available to: every agent, or one.
  5. Choose Design the tool. Turn on Enable immediately to use it straight away; otherwise it is saved as a draft for you to review.

Create a tool by hand

Choose Manual and fill in: For an HTTP request, set the method and URL (use {{parameter}} placeholders), headers and request body. For a data query, choose the table, the search parameter and a row limit.
Write the description as “what this does and when to use it”. The demo’s tool reads: “Look up which homes and units are in the catalogue and their availability notes. Use when a customer asks whether a type of unit is still available.”
Each tool card shows its status, kind, the agents it is scoped to and how often it has been called. Use the switch to enable or disable it. Tools added by an integration say Managed by ….