Creating and using custom tools

Custom tools

Creating and using custom tools

Build reusable workflows that your AI Agents can call during execution — instead of repeating logic inside every agent, define it once and reuse it everywhere.

Reusable workflows Visual tool builder Multi-step actions

What are custom tools?

Custom tools are reusable workflows that agents can call during execution. Instead of writing the same logic across multiple agents, you define it once in the Tool Builder and reference it everywhere.

A custom tool can be a single app action or a complete multi-step workflow — making your automation cleaner, more consistent, and scalable.

A custom tool can be

Single action

One specific operation from a connected app

Multi-step workflow

A complete sequence of actions chained together

Creating a custom tool

You can build a custom tool directly from the Agent screen in three steps, or by clicking the + New button on the top right and selecting Tools.

Open your Agent

Go to the Configured Tools section

Click Create Tool — this opens the Tool Builder

Tool builder overview

The Tool Builder is a visual flow with three nodes connected in sequence. Each node has a distinct role in the tool's execution.

Node 01

Input

Defines what data the agent sends in. Acts as the trigger and starting point of the tool.

Node 02

Action(s)

Defines what the tool does. One action or multiple chained steps.

Node 03

Output

Defines what the tool returns to the agent after execution.

Configuring each node

Input node Starting point

Defines what data the agent sends into the tool. Ensures all downstream steps use a consistent data structure.

For each input field, define

Label

Name of the field

Description

What the field represents

Required

Mark if the field is mandatory

Value source

Let you decide — you provide the value · Let agent decide — agent fills it dynamically

Value type

Select the data type (e.g. Text) to ensure proper mapping

Each field has an auto-generated key for internal mapping. Use Add field to add more. All inputs are available in action steps and output mapping.

Import fields from a connected app

New

Instead of manually naming and describing every input field, use the + Add app inputs button to import field definitions directly from any fully-configured downstream action node. The Input node schema is populated automatically.

Click + Add app inputs in the Input node sidebar — appears when at least one downstream app node is fully configured

Select an app from the picker, then choose which fields to import — search, select, or deselect individual fields

Click Add fields to stage, then repeat for additional apps. Click Save & Close to commit all selections atomically

Fields from multiple apps can be imported in a single session. Staged additions can be removed before committing. Changes only apply once you click Save and continue on the Input node itself.

Action node What the tool does

Click on the Action node to configure it. Choose from connected app actions or Konnectify built-in tools. After selecting, configure required fields and map inputs as needed.

Apps

Actions from connected apps — Gmail, Freshdesk, CRM, and more

Konnectify tools

Built-in utilities available directly inside the platform

Multiple actions

Click + to add more nodes. Chain them together to build a complete multi-step workflow inside a single tool.

Output node What the tool returns

Defines what the tool returns to the agent after execution. This is what the agent receives and can use in subsequent steps.

Each output contains

Key

The field name the agent will reference

Value

Data mapped from previous action steps

Add a single output or multiple using Add field.

Single output node — branch-aware mapping

New

When your tool uses conditional branching, all branches must now terminate at a single, permanent Output node. This ensures the agent always receives a consistently structured response — regardless of which path executed.

Output field mapping

Field name

The key the agent will reference

Value source

Which step output or branch result to use

Field type

Text, Number, Boolean, Object, or Array

Description

Optional — helps the agent understand the field

For multi-branch flows, use the branch-aware value picker to define per-branch return values within the same Output node — for example, if Branch A, return X; if Branch B, return Y. The Output node cannot be deleted, duplicated, or moved.

Saving and using your tool

Saving the tool Save

Once your flow is complete:

Click Save

The tool is immediately available for any agent

Using in instructions Reference

After adding the tool to your agent:

Go to the Instructions section

Type / and select your tool

Define when the agent should call it

Key benefits

Custom tools let you design structured workflows using a visual builder — powerful and reusable by every agent in your workspace.

Combine multiple steps

Chain several actions into one reusable tool instead of repeating logic in every agent's instructions

Reuse across agents

Build once — make the same tool available to multiple agents without duplication

Reduce instruction complexity

Reference a named tool instead of writing detailed logic in every agent's instructions

Ensure consistent execution

Every agent calling the tool runs the same validated workflow, every time

Get started

Build your first custom tool.

Open any agent, go to Configured Tools, and click Create Tool.

Get started free

​Creating and using custom tools

Creating and using custom tools

What are custom tools?

Creating a custom tool

Tool builder overview

Configuring each node

Saving and using your tool

Key benefits

Creating and using custom tools