ConfigurarFerramentasConfiguração de ferramentas

Interrupções de ferramentas

Controle se os usuários podem interromper o agente enquanto uma ferramenta é executada.

Visão geral

Por padrão, o usuário pode interromper o agente a qualquer momento, inclusive durante a execução de uma ferramenta. Para algumas ferramentas, isso não é desejável: uma confirmação de pagamento ou um aviso de conformidade lido após uma consulta deve ser apresentado por completo.

O campo interruption_mode controla isso para cada ferramenta. Ele está disponível em ferramentas de webhook, ferramentas de cliente, ferramentas do sistema e servidores MCP.

Modos de interrupção

ValorRótulo no dashboardComportamento
allowPermitirO usuário pode interromper o agente a qualquer momento. Este é o padrão.
disable_during_toolDesativar durante a execuçãoAs interrupções são bloqueadas apenas enquanto a ferramenta é executada. A resposta do agente seguinte pode ser interrompida.
disable_during_tool_and_turnDesativar durante todo o turnoAs interrupções são bloqueadas enquanto a ferramenta é executada e durante a resposta do agente que a segue.

Quando várias ferramentas são executadas em paralelo, o modo mais restritivo entre elas se aplica àquele turno.

O campo booleano disable_interruptions foi descontinuado. Use interruption_mode em vez dele. Os dois campos são mantidos em sincronia, portanto disable_interruptions: true equivale a interruption_mode: "disable_during_tool_and_turn", e as integrações existentes continuam funcionando sem alterações.

Configuração

1

Acesse a configuração da ferramenta

Selecione a ferramenta que você quer configurar na aba Ferramentas.

2

Defina o modo de interrupção

Abra Configurações avançadas e escolha uma opção em Interrupções.

3

Salve sua configuração

Clique em Salvar para aplicar a alteração.

Servidores MCP

Um servidor MCP tem seu próprio interruption_mode, que se aplica a todas as ferramentas que ele expõe. Ferramentas individuais podem substituí-lo por meio de tool_config_overrides do servidor, em que o valor definido em uma ferramenta tem precedência sobre o padrão do servidor.

Boas práticas

  • Use disable_during_tool quando a chamada da ferramenta precisar ser concluída, como em uma transferência ou uma sequência de teclado, mas o usuário puder interromper a resposta depois.
  • Use disable_during_tool_and_turn quando a resposta após a ferramenta precisar ser ouvida por completo, como um aviso ou uma confirmação lida em voz alta.
  • Mantenha o padrão allow nos demais casos, pois bloquear interrupções faz com que a conversa pareça menos responsiva.