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

# Pular turno

## Visão geral

A ferramenta **Pular turno** permite que seu agente conversacional pause explicitamente e espere o usuário falar ou agir antes de continuar. Essa ferramenta de sistema é útil quando o usuário indica que precisa de um momento, por exemplo, dizendo "Me dê um segundo", "Deixe-me pensar" ou "Um momento, por favor".

## Funcionalidade

* **Pausa iniciada pelo usuário**: a ferramenta foi criada para ser chamada pelo LLM quando ele detecta que o usuário precisa de uma breve pausa sem interrupções.
* **Sem resposta verbal**: depois que essa ferramenta é chamada, o assistente não fala. Ele espera o usuário retomar a interação ou que outra condição de alternância de turno seja atendida.
* **Fluxo de conversa contínuo**: ela ajuda a manter um ritmo natural de conversa ao respeitar a necessidade do usuário por uma breve pausa, sem encerrar a interação ou fazer o agente falar desnecessariamente.

**Objetivo**: Permitir que o agente pause e aguarde a entrada do usuário sem falar.

**Condições de acionamento**: o LLM deve chamar esta ferramenta quando:

* O usuário indicar que precisa de um momento ("Me dê um segundo", "Deixe-me pensar")
* O usuário solicitar uma pausa no fluxo da conversa
* O agente detectar que o usuário precisa de tempo para processar informações

**Parâmetros**:

* `reason` (string, opcional): motivo de formato livre explicando por que a pausa é necessária

**Formato de chamada da função**:

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

**Implementação**: nenhuma configuração adicional é necessária. A ferramenta simplesmente sinaliza ao agente para permanecer em silêncio até que o usuário fale novamente.

### Implementação da API

Ao criar um agente pela API, você pode adicionar a ferramenta Pular turno à configuração do agente. Ela deve ser definida como uma ferramenta de sistema, com o 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" },
          },
        },
      },
    },
  },
});
```

## Configuração pela interface

Você também pode configurar a ferramenta Pular turno diretamente na interface do agente, na seção de ferramentas.

### Etapa 1: adicionar uma nova ferramenta

Acesse a página de configuração do seu agente. Na seção "Tools", clique em "Add tool". A opção `Skip Turn` já estará disponível.

![Opção para adicionar a ferramenta Pular turno](/docs/_fern-img/8b95051da94ada3dae7e42121148ad4509b49413e73bd16351142372ca26a68d.webp)

### Etapa 2: configurar a ferramenta

Opcionalmente, você pode fornecer uma descrição para personalizar quando o LLM deve acionar essa ferramenta ou deixá-la em branco para usar o comportamento padrão.

![Configurar ferramenta Pular turno](/docs/_fern-img/cbb419db630beb4feefc390ef3f3576f7a6dc2df098faec4fbd2d1d5e703364f.webp)

### Etapa 3: ativar a ferramenta

Depois de configurada, a ferramenta `Skip Turn` aparecerá na lista de ferramentas ativadas do agente, e o agente poderá pular turnos.

![Ferramenta Pular turno ativada](/docs/_fern-img/bdb738dc85ff91107cafa5899aad116420aabe9fe794b648bc1f0751729ba5af.webp)