For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Start buildingGet support
DocumentationAPI ReferenceChangelogDiscord
  • Introduction
    • Welcome to Hume AI
    • Getting your API keys
    • Support
    • Pricing
  • Voice
    • Overview
    • Voice design
    • Voice cloning
    • Voice management
  • Text-to-Speech (TTS)
    • Overview
    • Voice
    • Acting instructions
    • Voice conversion
    • Continuation
    • Timestamps
    • FAQ
  • Speech-to-Speech (EVI)
    • Overview
      • Build a configuration
      • Session settings
      • EVI version
      • Voice
      • System prompt
      • Language model
      • Tools
      • Event messages
      • Turn detection
      • Interruption
      • Timeouts
      • Webhooks
    • FAQ
  • Expression Measurement
    • Overview
    • About the science
    • FAQ
  • Integrations
    • MCP
    • Vercel AI SDK
    • LiveKit
    • Pipecat
    • Vapi
    • Twilio
    • Agora
  • Resources
    • Terms of use
    • Use case guidelines
    • Billing
    • Errors
    • Privacy
    • Status
Start buildingGet support
LogoLogo
LogoLogo
On this page
  • Tool types
  • Function tools
  • Built-in tools
  • Creating tools
Speech-to-Speech (EVI)Configuration

Tools

Equip EVI with Tools to enable function calling during Chats.
Was this page helpful?
Edit this page
Previous

Event Messages

Schedule and author EVI responses for key Chat events.
Next
Built with

EVI supports tool use to enhance conversations. Tools allow EVI to trigger custom logic based on user input, such as searching the web, invoking business logic, calling an API, or updating a database.

Tool use is only supported when specifying certain supplemental LLMs within your configuration. Currently, tool use is supported by Claude, GPT, Gemini, and Moonshot AI models. Function calling is also available if you are using your own custom language model using the OpenAI function calling specification.

For best results, we suggest choosing a fast and intelligent LLM that performs well on function calling benchmarks.

Tool Use Guide

See our guide for defining tools and configuring EVI to use them.

Tool types

Function tools

Also sometimes referred to as client tools, function tools are schemas containing a description and parameters.

When included in your EVI configuration, the model will infer when your function should be called and with which arguments based upon the user’s prompt and the tool schema’s tool and parameter descriptions. You then invoke a function in your application code with the provided arguments and send the result to EVI for response generation.

Function tools are user-defined, and are created and managed via our Platform UI or through the API.

Built-in tools

Often referred to as server tools, are tools which are natively implemented on the server, and therefore do not require you to define or invoke them.

EVI currently supports two built-in tools:

  1. web_search: Searches the web for real-time information when needed.
  2. hang_up: Closes the WebSocket connection with a status code of 1000 (normal closure), typically triggered when the conversation has ended.

Creating tools

You can create and manage Tools through our UI or programmatically using our API.

Tools UI

Visit our Platform UI to create and manage Tools.

Tools API

Explore our API reference for details on how to create and manage Tools through the API.