Tools & Webhook Tools

Tools extend your agent's capabilities beyond conversation. With tools, your agent can look up information, submit forms, book appointments, or perform any action accessible via an HTTP API.

Types of Tools

Speaknode supports three types of tools:

Creating a Webhook Tool

1. Navigate to Tools in the sidebar.
2. Click + Create Tool.
3. Fill in the tool configuration:

Basic Settings

• Name: A short, descriptive name (e.g., check_order_status). The LLM uses this name to decide when to call the tool.
• Description: Explain what the tool does and when to use it. This is included in the LLM context, so be precise.

HTTP Configuration

• Method: Select the HTTP method (GET, POST, PUT, PATCH, DELETE).
• URL: The endpoint URL. You can use dynamic variables here (e.g., https://api.example.com/orders/{{order_id}}).

Headers

Define request headers using an OpenAPI schema format. Click + Add Header and specify:

• Name: The header name (e.g., Authorization).
• Schema: The OpenAPI property definition for the header value.

Body

For methods that accept a request body (POST, PUT, PATCH), define the body schema using OpenAPI schema format.

The schema describes the JSON structure that the agent will send. Each property should have:

• Name: The field name.
• Type: The data type (string, number, boolean, integer, object, array).
• Description: What this field represents. The LLM uses this to fill in values from the conversation.
• Required: Whether this field must be present.

Attaching Tools to an Agent

1. Open the agent you want to configure.
2. Go to the Tools section.
3. Click + Add Tool.
4. Select the tool from the list of available tools in your workspace.
5. Click Save.

The agent can now use this tool during conversations.

System Tools

System tools are built-in tools that come with Speaknode. You do not need to create them -- just enable or disable them on your agent.

1. In the agent's Tools section, find the System Tools area.
2. Toggle each system tool on or off.
3. Optionally, customize the Description of each system tool to change how the LLM understands when to use it.
4. For a tool that needs more than a description -- the two transfer tools -- click the gear icon next to its switch to open its settings.

The catalogue:

See System Tools for what each one is for, how to configure it, and how transfers to an operator behave on a live call.

Transfer Rules

Transfer rules live inside the two transfer system tools -- open Transfer to another agent or Transfer to a human operator on the agent and add rules there.

A rule pairs a condition in plain language ("Transfer when the caller asks about billing issues") with a destination: another agent, or an operator's phone number. The model reads the conditions to decide whether to transfer and, when there are several rules, which one applies.

Pre-Tool Speech and Progress Speech

You can configure what the agent says before and during tool execution to keep the conversation natural.

Pre-Tool Speech

A phrase the agent speaks before calling the tool. Use this to set expectations.

Example: "Let me look that up for you."

Progress Speech

A phrase the agent speaks while the tool is running, if the tool takes more than a few seconds. This prevents awkward silence.

Example: "I'm still checking on that, one moment please."

Summary