Tools
Functions an agent can call to look things up and take actions, including custom webhook tools you define without code.
A tool is a function the agent can call during a conversation to fetch data or take an action. Unlike a skill, which only adds instructions, a tool actually runs and returns a result the agent then uses in its answer.
Using tools
- Browse — select Tools in the sidebar to see built-in and custom tools.
- Attach — open an agent's Tools tab and enable the ones it may call.
- Test — use the Test button on a tool's detail view before attaching it.
An agent can only call tools you have explicitly enabled for it. This is enforced by the runtime, not just by instructions.
Built-in tools
KlicForge ships a large catalog of built-in tools, grouped by area. Broadly they cover:
| Area | What the tools do |
|---|---|
| Data tables | Read, create, update, search and import records in your data tables |
| Knowledge | Search and manage knowledge sources |
| Contacts | Look up and update contact records |
| Search, read, draft and send mail through a connected Gmail account | |
| Send templates and manage WhatsApp messaging | |
| Scheduling | Create and manage scheduled tasks |
| Assets | Store, retrieve and send files and images |
| Handoff | Escalate a conversation to a human |
| Utilities | Calculation, web search, weather, image generation |
Built-in tools are read-only in the dashboard. Which ones are available depends on your plan and on which integrations you have connected.
Custom webhook tools
You can turn any external HTTP API into an agent tool without writing code.
- Select Tools → New Tool.
- Fill in the tool ID, name, description, HTTP method and endpoint URL.
- Define path parameters, query parameters, body fields and auth headers.
- Select Test Tool to send a live request and confirm it works.
- Save. The tool is immediately available to attach to any agent.
You can also paste a curl command and let the importer populate the form.
The description is what the agent reads to decide when to call the tool. Write it as instructions to the agent — "Look up an order by its order number" — not as an API summary. A vague description is the most common cause of a tool being called at the wrong moment.
Supported methods and input mapping
GET, POST, PUT, PATCH, DELETE.
| Input type | How it maps |
|---|---|
| Path parameters | Substituted into the URL template: {paramName} |
| Query parameters | Appended to the URL as ?key=value |
| JSON body | Sent as an application/json request body |
| Auth headers | Sent as HTTP headers, stored encrypted |
How a tool call works
- The agent decides to call a tool and supplies arguments.
- KlicForge checks the tool is enabled for that agent.
- Arguments are validated against the tool's input schema.
- The tool runs.
- Output is sanitised before it re-enters the agent's context.
- The agent continues its answer with the result available.
Tool calls do not consume extra allowance — a turn is one interaction no matter how many tools it calls.
Security
- Auth headers and credentials are stored encrypted and never returned in any API response.
- An agent can only call tools on its own enabled list.
- Tool output is treated as data — instruction-like patterns are stripped before it reaches the model, so a compromised endpoint cannot issue commands to your agent.