用途:在 LLM 可观测性链路中保护敏感数据,重点是在把提示词与响应写入日志或发送至追踪系统之前完成 PII 检测与脱敏。
主要能力: 1)基于正则的轻量脱敏,覆盖信用卡号、邮箱、电话号码、SSN 等模式,替换为 [REDACTED_CC]、[REDACTED_EMAIL] 等类型标记,便于调试。 2)Langfuse 集成,推荐在客户端初始化时传入 mask 回调,示例:langfuse = Langfuse(mask=mask_pii)。 3)Microsoft Presidio 管道,使用 AnalyzerEngine 检测、AnonymizerEngine 匿名化,支持语言参数与企业级检测,并可扩展自定义识别器。 4)LLM Guard 清理,输入侧用 Anonymize 扫描器做匿名化,输出侧用 Sensitive 扫描器按实体类型(如 PERSON、EMAIL)脱敏,配合 Vault 存储原值以支持反向还原。 5)日志前置脱敏,针对 structlog / loguru 的处理模式。
使用方式:按敏感度与吞吐选择检测引擎——简单场景用正则,企业合规用 Presidio,LLM 管道用 LLM Guard;Langfuse 场景通过 mask 回调统一拦截。高吞吐场景建议使用异步或批处理。
限制与注意事项:资料未提供具体安装命令、依赖版本、性能基准与各引擎的检测准确率数据,这些信息暂未提供。该技能强调切勿记录原始 PII,也不要把未脱敏数据发送到可观测性系统;反向还原仅在确有需要时使用 Vault。