> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Salta turno

## Panoramica

Lo strumento **Salta turno** consente al tuo agente conversazionale di fare esplicitamente una pausa e attendere che l'utente parli o agisca prima di continuare. Questo strumento di sistema è utile quando l'utente indica di aver bisogno di un momento, ad esempio dicendo "Dammi un secondo", "Fammi pensare" o "Un momento, per favore".

## Funzionalità

* **Pausa avviata dall'utente**: lo strumento è progettato per essere richiamato dall'LLM quando rileva che l'utente necessita di una breve pausa senza interruzioni.
* **Nessuna risposta verbale**: dopo la chiamata di questo strumento, l'assistente non parlerà. Attenderà che l'utente riprenda l'interazione o che venga soddisfatta un'altra condizione di alternanza dei turni.
* **Flusso di conversazione naturale**: aiuta a mantenere un ritmo conversazionale naturale rispettando la necessità dell'utente di una breve pausa, senza terminare l'interazione né far parlare l'agente inutilmente.

**Scopo**: consente all'agente di fare una pausa e attendere l'input dell'utente senza parlare.

**Condizioni di attivazione**: l'LLM deve chiamare questo strumento quando:

* L'utente indica di aver bisogno di un momento ("Dammi un secondo", "Fammi pensare")
* L'utente richiede una pausa nel flusso della conversazione
* L'agente rileva che l'utente ha bisogno di tempo per elaborare le informazioni

**Parametri**:

* `reason` (stringa, facoltativo): motivo in formato libero che spiega perché è necessaria la pausa

**Formato della chiamata di funzione**:

```json
{
  "type": "function",
  "function": {
    "name": "skip_turn",
    "arguments": "{\"reason\": \"User requested time to think\"}"
  }
}
```

**Implementazione**: non è necessaria alcuna configurazione aggiuntiva. Lo strumento segnala semplicemente all'agente di rimanere in silenzio finché l'utente non parla di nuovo.

### Implementazione API

Quando crei un agente tramite API, puoi aggiungere lo strumento Salta turno alla configurazione dell'agente. Deve essere definito come strumento di sistema, con il nome `skip_turn`.

```python
from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs

elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")

response = elevenlabs.conversational_ai.agents.create(
    conversation_config=ConversationalConfig(
        agent=AgentConfig(
            prompt={
                "built_in_tools": {
                    "skip_turn": {
                        "type": "system",
                        "name": "skip_turn",
                        # Optional: customize when the tool should be triggered,
                        # or leave blank for the default.
                        "description": "",
                        "params": {"system_tool_type": "skip_turn"},
                    }
                }
            },
        ),
    ),
)
```

```javascript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});

await elevenlabs.conversationalAi.agents.create({
  conversationConfig: {
    agent: {
      prompt: {
        builtInTools: {
          skipTurn: {
            type: "system",
            name: "skip_turn",
            description: "", // Optional: Customize when the tool should be triggered, or leave blank for default.
            params: { systemToolType: "skip_turn" },
          },
        },
      },
    },
  },
});
```

## Configurazione dell'interfaccia

Puoi anche configurare lo strumento Salta turno direttamente nell'interfaccia dell'agente, nella sezione degli strumenti.

### Passaggio 1: aggiungi un nuovo strumento

Vai alla pagina di configurazione del tuo agente. Nella sezione "Strumenti", fai clic su "Aggiungi strumento"; l'opzione `Skip Turn` sarà già disponibile.

![Opzione per aggiungere lo strumento Salta turno](/docs/_fern-img/8b95051da94ada3dae7e42121148ad4509b49413e73bd16351142372ca26a68d.webp)

### Passaggio 2: configura lo strumento

Puoi facoltativamente fornire una descrizione per personalizzare quando l'LLM deve attivare questo strumento, oppure lasciarla vuota per usare il comportamento predefinito.

![Configura lo strumento Salta turno](/docs/_fern-img/cbb419db630beb4feefc390ef3f3576f7a6dc2df098faec4fbd2d1d5e703364f.webp)

### Passaggio 3: abilita lo strumento

Una volta configurato, lo strumento `Skip Turn` apparirà nell'elenco degli strumenti abilitati del tuo agente e l'agente potrà saltare i turni.

![Strumento Salta turno abilitato](/docs/_fern-img/bdb738dc85ff91107cafa5899aad116420aabe9fe794b648bc1f0751729ba5af.webp)