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:

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

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"},
                    }
                }
            },
        ),
    ),
)

Configuração pela interface

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

1

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.

2

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.

3

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.