Implementation:Elevenlabs Elevenlabs python SystemToolConfigInput
| Field | Value |
|---|---|
| source | Elevenlabs_Elevenlabs_python |
| domains | Conversational AI, Tool Configuration, System Tools |
| last_updated | 2026-02-15 |
Overview
Description
SystemToolConfigInput is a Pydantic model representing the input configuration for a system tool in the ElevenLabs conversational AI system. A system tool is a tool that is used to call a system method on the server. It defines the tool's type, name, description, timeout, interruption behavior, sound effects, error handling, and a required params field that specifies the system tool parameters. This model is auto-generated by Fern from the ElevenLabs API definition and extends UncheckedBaseModel.
Usage
This model is used when configuring system tools for a conversational agent. System tools allow the agent to invoke built-in server-side methods during a conversation, such as ending the call or transferring to another agent.
Code Reference
Source Location
src/elevenlabs/types/system_tool_config_input.py
Class Signature
class SystemToolConfigInput(UncheckedBaseModel):
"""
A system tool is a tool that is used to call a system method in the server
"""
...
Import Statement
from elevenlabs.types import SystemToolConfigInput
I/O Contract
| Field | Type | Required | Description |
|---|---|---|---|
| type | Optional[Literal["system"]] |
No | The type of tool. |
| name | str |
Yes | The name of the system tool. |
| description | Optional[str] |
No | Description of when the tool should be used and what it does. Leave empty to use the default description optimized for the specific tool type. |
| response_timeout_secs | Optional[int] |
No | The maximum time in seconds to wait for the tool call to complete. |
| disable_interruptions | Optional[bool] |
No | If true, the user will not be able to interrupt the agent while this tool is running. |
| force_pre_tool_speech | Optional[bool] |
No | If true, the agent will speak before the tool call. |
| assignments | Optional[List[DynamicVariableAssignment]] |
No | Configuration for extracting values from tool responses and assigning them to dynamic variables. |
| tool_call_sound | Optional[ToolCallSoundType] |
No | Predefined tool call sound type to play during tool execution. |
| tool_call_sound_behavior | Optional[ToolCallSoundBehavior] |
No | Determines when the tool call sound should play. 'auto' only plays when there's pre-tool speech, 'always' plays for every tool call. |
| tool_error_handling_mode | Optional[ToolErrorHandlingMode] |
No | Controls how tool errors are processed before being shared with the agent. |
| params | SystemToolConfigInputParams |
Yes | The system tool parameters configuration. |
Usage Examples
from elevenlabs.types import SystemToolConfigInput
# Configure a system tool for ending a conversation
system_tool = SystemToolConfigInput(
type="system",
name="end_call",
description="Ends the current conversation gracefully.",
params=SystemToolConfigInputParams(...),
)