도구 인터럽트

도구 실행 중 사용자가 에이전트를 인터럽트할 수 있는지 제어합니다.

개요

기본적으로 사용자는 도구 실행 중을 포함해 언제든 에이전트를 인터럽트할 수 있습니다. 하지만 일부 도구에서는 이것이 바람직하지 않습니다. 예를 들어 조회 후 안내되는 결제 확인이나 규정 준수 고지는 끝까지 전달되어야 합니다.

interruption_mode 필드는 도구별로 이를 제어합니다. 웹훅 도구, 클라이언트 도구, 시스템 도구 및 MCP 서버에서 사용할 수 있습니다.

인터럽트 모드

값	대시보드 라벨	동작
`allow`	Allow	사용자는 언제든 에이전트를 인터럽트할 수 있습니다. 기본값입니다.
`disable_during_tool`	Disable during execution	도구 실행 중에만 인터럽트가 차단됩니다. 이후의 에이전트 응답은 인터럽트할 수 있습니다.
`disable_during_tool_and_turn`	Disable during whole turn	도구 실행 중 및 그 뒤의 에이전트 응답 동안 인터럽트가 차단됩니다.

여러 도구가 병렬로 실행되는 경우, 해당 턴에는 그중 가장 엄격한 모드가 적용됩니다.

불리언 disable_interruptions 필드는 더 이상 사용되지 않습니다. 대신 interruption_mode를 사용하세요. 두 필드는 동기화되므로 disable_interruptions: true는 interruption_mode: "disable_during_tool_and_turn"와 동일하며, 기존 통합도 변경 없이 계속 작동합니다.

구성

대시보드에서 업데이트

CLI에서 업데이트

API에서 업데이트

도구 구성으로 이동

Tools 탭에서 구성할 도구를 선택하세요.

인터럽트 모드 설정

Advanced settings를 열고 Interruptions 아래에서 옵션을 선택하세요.

구성 저장

Save를 클릭하여 변경 사항을 적용하세요.

MCP 서버

MCP 서버에는 자체 interruption_mode가 있으며, 노출하는 모든 도구에 적용됩니다. 개별 도구는 서버의 tool_config_overrides를 통해 이를 재정의할 수 있으며, 도구에 설정된 값이 서버 기본값보다 우선합니다.

모범 사례

송금이나 키패드 입력처럼 도구 호출 자체는 반드시 완료되어야 하지만 이후 응답은 사용자가 인터럽트할 수 있어야 하는 경우 disable_during_tool을 사용하세요.
고지나 확인 내용 재안내처럼 도구 실행 후 응답을 끝까지 들어야 하는 경우 disable_during_tool_and_turn을 사용하세요.
인터럽트를 차단하면 대화의 반응성이 떨어지는 느낌을 줄 수 있으므로, 그 외에는 기본값인 allow를 유지하세요.