> 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.

# Passer le tour

## Vue d’ensemble

L’outil **Passer le tour** permet à votre agent conversationnel de faire explicitement une pause et d’attendre que l’utilisateur parle ou agisse avant de poursuivre. Cet outil système est utile lorsque l’utilisateur indique qu’il a besoin d’un instant, par exemple en disant « Donnez-moi une seconde », « Laissez-moi réfléchir » ou « Un instant, s’il vous plaît ».

## Fonctionnalités

* **Pause initiée par l’utilisateur** : l’outil est conçu pour être appelé par le LLM lorsqu’il détecte que l’utilisateur a besoin d’une courte pause sans interruption.
* **Aucune réponse verbale** : après l’appel de cet outil, l’assistant ne parle pas. Il attend que l’utilisateur reprenne la conversation ou qu’une autre condition de prise de tour soit remplie.
* **Flux conversationnel fluide** : il aide à préserver un rythme de conversation naturel en respectant le besoin de courte pause de l’utilisateur, sans mettre fin à l’interaction ni faire parler l’agent inutilement.

**Objectif** : permettre à l’agent de faire une pause et d’attendre l’entrée de l’utilisateur sans parler.

**Conditions de déclenchement** : le LLM doit appeler cet outil lorsque :

* L’utilisateur indique avoir besoin d’un moment (« Donnez-moi une seconde », « Laissez-moi réfléchir »)
* L’utilisateur demande une pause dans le flux de la conversation
* L’agent détecte que l’utilisateur a besoin de temps pour assimiler les informations

**Paramètres** :

* `reason` (chaîne, facultatif) : raison libre expliquant pourquoi la pause est nécessaire

**Format d’appel de fonction** :

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

**Implémentation** : aucune configuration supplémentaire n’est nécessaire. L’outil signale simplement à l’agent de rester silencieux jusqu’à ce que l’utilisateur parle de nouveau.

### Implémentation de l’API

Lors de la création d’un agent via l’API, vous pouvez ajouter l’outil Passer le tour à la configuration de votre agent. Il doit être défini comme outil système, sous le nom `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" },
          },
        },
      },
    },
  },
});
```

## Configuration de l’interface

Vous pouvez également configurer l’outil Passer le tour directement dans l’interface de l’agent, dans la section des outils.

### Étape 1 : Ajouter un nouvel outil

Accédez à la page de configuration de votre agent. Dans la section « Outils », cliquez sur « Ajouter un outil », l’option `Skip Turn` est déjà disponible.

![Option d’ajout de l’outil Passer le tour](/docs/_fern-img/8b95051da94ada3dae7e42121148ad4509b49413e73bd16351142372ca26a68d.webp)

### Étape 2 : Configurer l’outil

Vous pouvez éventuellement fournir une description pour personnaliser le moment où le LLM doit déclencher cet outil, ou la laisser vide pour utiliser le comportement par défaut.

![Configurer l’outil Passer le tour](/docs/_fern-img/cbb419db630beb4feefc390ef3f3576f7a6dc2df098faec4fbd2d1d5e703364f.webp)

### Étape 3 : Activer l’outil

Une fois configuré, l’outil `Skip Turn` apparaît dans la liste des outils activés de votre agent, qui peut alors passer des tours.

![Outil Passer le tour activé](/docs/_fern-img/bdb738dc85ff91107cafa5899aad116420aabe9fe794b648bc1f0751729ba5af.webp)