- 防止个人身份信息泄露
- 检测并阻止提示注入攻击
- 阻止不当或有害内容
- 执行业务规则和合规要求
- 验证输出质量和准确性

确定性守护机制
使用基于规则的逻辑,如正则表达式模式、关键词匹配或显式检查。快速、可预测且成本效益高,但可能遗漏细微的违规。
基于模型的守护机制
使用 LLM 或分类器通过语义理解评估内容。可以捕获规则遗漏的细微问题,但速度较慢且成本更高。
内置守护机制
PII 检测
LangChain 提供用于检测和处理对话中个人身份信息(PII)的内置中间件。此中间件可以检测常见的 PII 类型,如电子邮件、信用卡、IP 地址等。 PII 检测中间件适用于以下情况:具有合规要求的医疗保健和金融应用程序、需要清理日志的客户服务智能体,以及任何处理敏感用户数据的应用程序。 PII 中间件支持多种处理检测到的 PII 的策略:| 策略 | 描述 | 示例 |
|---|---|---|
redact | 替换为 [REDACTED_{PII_TYPE}] | [REDACTED_EMAIL] |
mask | 部分隐藏(例如,最后 4 位数字) | ****-****-****-1234 |
hash | 替换为确定性哈希 | a8f5f167... |
block | 检测到时引发异常 | 抛出错误 |
内置 PII 类型和配置
内置 PII 类型和配置
内置 PII 类型:
email- 电子邮件地址credit_card- 信用卡号(Luhn 验证)ip- IP 地址mac_address- MAC 地址url- URL
| 参数 | 描述 | 默认值 |
|---|---|---|
pii_type | 要检测的 PII 类型(内置或自定义) | 必需 |
strategy | 如何处理检测到的 PII("block"、"redact"、"mask"、"hash") | "redact" |
detector | 自定义检测器函数或正则表达式模式 | None(使用内置) |
apply_to_input | 在模型调用前检查用户消息 | True |
apply_to_output | 在模型调用后检查 AI 消息 | False |
apply_to_tool_results | 在执行后检查工具结果消息 | False |
人机回圈
LangChain 提供内置中间件,用于在执行敏感操作前要求人工批准。这是针对高风险决策最有效的守护机制之一。 人机回圈中间件适用于以下情况:金融交易和转账、删除或修改生产数据、向外部方发送通信,以及任何具有重大业务影响的操作。自定义守护机制
对于更复杂的守护机制,您可以创建在智能体执行之前或之后运行的自定义中间件。这使您可以完全控制验证逻辑、内容过滤和安全检查。智能体前守护机制
使用“智能体前”钩子在每次调用开始时验证请求。这适用于会话级检查,如身份验证、速率限制或在任何处理开始前阻止不当请求。智能体后守护机制
使用“智能体后”钩子在返回给用户前验证最终输出。这适用于基于模型的安全检查、质量验证或对完整智能体响应的最终合规扫描。组合多个守护机制
您可以通过将多个守护机制添加到中间件数组中来堆叠它们。它们按顺序执行,允许您构建分层保护:其他资源
- 中间件文档 - 自定义中间件完整指南
- 中间件 API 参考 - 自定义中间件完整指南
- 人机回圈 - 为敏感操作添加人工审查
- 测试智能体 - 测试安全机制的策略
连接这些文档 到 Claude、VSCode 等,通过 MCP 获取实时答案。

