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.

Common system tools include:

• End Call: Allows the agent to terminate the call.
• Transfer Call: Allows the agent to transfer to a phone number or SIP endpoint.

Transfer Rules¶

Transfer rules let your agent hand off the conversation to another SpeakNode agent when certain conditions are met.

1. In the agent's Tools section, find Transfer Rules.
2. Click + Add Transfer Rule.
3. Configure the rule:
   • Target Agent: The agent to transfer to.
   • Condition: A natural language description of when the transfer should happen (e.g., "Transfer when the caller asks about billing issues").
4. Click Save.

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¶