Tools

Register and list custom tools agents can call mid-conversation.

Tools are HTTP functions an agent can trigger during a call.

List tools

const tools = await voice.tools.get();
tools = client.tools()

Create a tool

const tool = await voice.tools.create({
  name: "book_appointment",
  description: "Books an appointment slot in the CRM.",
  httpEndpoint: "https://hooks.acme.com/book",
  method: "POST",
});
tool = client.create_tool(
    name="book_appointment",
    description="Books an appointment slot in the CRM.",
    http_endpoint="https://hooks.acme.com/book",
    method="POST",
)

Parameters

FieldTypeRequiredDescription
namestringYesTechnical function name the LLM invokes.
descriptionstringYesWhat the tool does (shown to the model).
httpEndpoint / http_endpointstringYesAbsolute URL the tool payload is sent to.
methodstringYesHTTP method, e.g. POST.

On this page