---
title: "react - 内置拦截器（5个）"
---


| 拦截器 | 描述 | 备注 |
| -------- | -------- | -------- |
| HITLInterceptor     | 人工介入拦截器    | 配合 HITL 接口使用     |
| StopLoopInterceptor     | 避免逻辑死循环拦截器    |      |
| ContextCompressionInterceptor     | 语义保护型上下文压缩拦截器     | 配套可定制的 CompressionStrategy     |
| ToolRetryInterceptor     | 工具执行重试拦截器    |       |
| ToolSanitizerInterceptor     | 工具结果净化拦截器     |       |



### HITLInterceptor（人工介入拦截器）

- **作用**：在 ReAct 执行过程中触发人工介入（Human-In-The-Loop），支持外部审批或干预
- **注册方式**：通过 `.defaultInterceptorAdd(new HITLInterceptor(...))` 或通过 `HarnessEngine` 的 `hitlInterceptor` 配置
- **触发时机**：当需要人工确认时，可由内部逻辑或外部代码调用 `session.pending(true, reason)` 挂起

### StopLoopInterceptor（防循环拦截器）

- **作用**：防止 ReAct 陷入无限循环，达到最大轮次时强制终止
- **注册方式**：`HarnessEngine` 默认已内置，也可手动创建：`new StopLoopInterceptor(maxLoops, maxTurns)`
- **触发时机**：每次 ReAct 循环时检查，超过阈值则抛出异常终止

### ContextCompressionInterceptor（上下文压缩拦截器）

- **作用**：当上下文过长时，自动压缩历史消息，避免超出模型上下文窗口
- **注册方式**：`HarnessEngine` 默认已内置，也可手动创建
- **触发时机**：每轮推理前检查消息数量，超过阈值时压缩

### ToolRetryInterceptor（工具重试拦截器）

- **作用**：工具调用失败时自动重试
- **注册方式**：`.defaultInterceptorAdd(new ToolRetryInterceptor(maxRetries))`
- **触发时机**：工具执行抛出异常时

### ToolSanitizerInterceptor（工具净化拦截器）

- **作用**：对工具调用的输入输出进行清洗、过滤或转换
- **注册方式**：`.defaultInterceptorAdd(new ToolSanitizerInterceptor(...))`
- **触发时机**：工具调用前后