Skip turn

Overview

The Skip Turn tool allows your conversational agent to explicitly pause and wait for the user to speak or act before continuing. This system tool is useful when the user indicates they need a moment, for example, by saying “Give me a second,” “Let me think,” or “One moment please.”

Functionality

• User-Initiated Pause: The tool is designed to be invoked by the LLM when it detects that the user needs a brief pause without interruption.
• No Verbal Response: After this tool is called, the assistant will not speak. It waits for the user to re-engage or for another turn-taking condition to be met.
• Seamless Conversation Flow: It helps maintain a natural conversational rhythm by respecting the user’s need for a short break without ending the interaction or the agent speaking unnecessarily.

Custom LLM integration

Purpose: Allow the agent to pause and wait for user input without speaking.

Trigger conditions: The LLM should call this tool when:

• User indicates they need a moment (“Give me a second”, “Let me think”)
• User requests pause in conversation flow
• Agent detects user needs time to process information

Parameters:

• reason (string, optional): Free-form reason explaining why the pause is needed

Function call format:

1
{
2
  "type": "function",
3
  "function": {
4
    "name": "skip_turn",
5
    "arguments": "{\"reason\": \"User requested time to think\"}"
6
  }
7
}

Implementation: No additional configuration needed. The tool simply signals the agent to remain silent until the user speaks again.

API implementation

When creating an agent via API, you can add the Skip Turn tool to your agent configuration. It should be defined as a system tool, with the name skip_turn.

1
from elevenlabs import (
2
    ConversationalConfig,
3
    ElevenLabs,
4
    AgentConfig,
5
    PromptAgent,
6
    PromptAgentInputToolsItem_System
7
)
8
9
# Initialize the client
10
elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")
11
12
# Create the skip turn tool
13
skip_turn_tool = PromptAgentInputToolsItem_System(
14
    name="skip_turn",
15
    description=""  # Optional: Customize when the tool should be triggered, or leave blank for default.
16
)
17
18
# Create the agent configuration
19
conversation_config = ConversationalConfig(
20
    agent=AgentConfig(
21
        prompt=PromptAgent(
22
            tools=[skip_turn_tool]
23
        )
24
    )
25
)
26
27
# Create the agent
28
response = elevenlabs.conversational_ai.agents.create(
29
    conversation_config=conversation_config
30
)

UI configuration

You can also configure the Skip Turn tool directly within the Agent’s UI, in the tools section.

1

Step 1: Add a new tool

Navigate to your agent’s configuration page. In the “Tools” section, click on “Add tool”, the Skip Turn option will already be available.

2

Step 2: Configure the tool

You can optionally provide a description to customize when the LLM should trigger this tool, or leave it blank to use the default behavior.

3

Step 3: Enable the tool

Once configured, the Skip Turn tool will appear in your agent’s list of enabled tools and the agent will be able to skip turns. .