在智能体使用过程中，用户输入内容可能包含敏感信息。如果这些信息被发送给不合适的模型，或被记录到不该访问的日志和下游系统中，就可能造成隐私泄露、商业信息外传或合规风险。敏感信息防护用于在大模型交互链路中识别并处置这类风险。系统既可以检测个人隐私数据或自定义商业敏感数据，也可以检测文档密级、文件外发和复杂文件相关行为，并根据策略执行放行、仅记录、提醒或拦截。系统会默认创建一条个人敏感信息拦截策略，对所有新增助手生效。如你需要新建对应策略，可参考本文操作。 ## 产品能力敏感信息防护策略包含**行为检测**和**敏感信息检测**两个相互独立、并行生效的检测域。创建规则时可以只启用其中一个，也可以同时启用；同时启用时，系统分别执行两类检测及其对应动作。 |检测域 |检测能力 |主要防护对象 |适合场景 | |---|---|---|---| |行为检测 |文档密级保护 |已配置企业密级标签的飞书文档 |根据文档密级控制访问或外发行为 | |行为检测 |外发文件检测 |通过模型服务或其他服务进行的文件复制、上传、远程发送等行为 |区分外发目标并分别执行放行、仅记录或拦截 | |行为检测 |复杂文件保护 |大文件和特殊文件格式 |对无法按常规内容检测流程处理的文件进行独立管控 | |敏感信息检测 |内置敏感信息检测 |个人隐私数据，即 PII，例如身份证号、银行卡号、手机号、邮箱等 |防止个人身份信息、联系方式、金融账户等在大模型交互中泄露 | |敏感信息检测 |自定义敏感信息检测 |企业商业数据，例如合同、报价单、客户清单、技术白皮书、人事文件、财务文件等 |防止企业内部资料、客户资料、交易信息、业务文档或知识资产被误用、外传 | 自定义敏感信息检测又分为两种方式： |自定义方式 |适合检测内容 |说明 | |---|---|---| |自定义模型检测 |合同、报价单、客户清单、人事文件、财务文件等非固定格式资料 |上传业务样本文件，系统根据样本提取特征，用于识别同类商业数据 | |自定义规则 |内部编号、订单号、项目编号、客户编码等固定格式内容 |通过正则表达式定义检测规则 | ## 注意事项 * 自定义敏感信息能力仅针对高级版防护生效。 * 内置敏感信息检测主要用于防护个人隐私数据（PII）；自定义敏感信息检测主要用于防护企业商业数据。如果同一业务场景既涉及个人隐私数据，又涉及商业数据，建议分别创建对应规则，便于管理、验证和审计。 ## 前提条件 * 你已将助手接入 AgentSentry 服务。接入方式请参考[启用安全防护](https://www.volcengine.com/docs/87732/2277773?lang=zh)。 * 如需使用飞书文档密级保护，还需完成以下准备： 1. 创建或选择一个用于读取文档密级的飞书应用。 2. 为飞书应用开通以下应用身份权限： * drive:drive.metadata:readonly（用于读取文档元数据，如文档标题、所有者等信息） * drive:file.meta.sec_label.read_only（用于读取文档密级标签，以进行权限判断） 3. 将飞书应用添加为文档协作者，添加后，文档应用可根据权限对文档进行自动化操作。 4. 准备飞书应用的 App ID 和 App Secret，并确认企业实际使用的密级标签名称。 5. 给智能体安装飞书 CLI 和 Lark doc skill。将以下内容直接复制到智能体对话窗口中即可安装。 ```Plain Text 安装飞书 CLI 和 Lark doc skill ``` ## 配置行为检测 ### 启用行为检测 1. 登录 ArkClaw 企业版控制台。 2. 在左侧菜单栏，选择**安全管理**。 3. 在**防护**页签下，选择**敏感信息防护**。 4. 单击**添加规则**。 5. 在**规则条件**区域选中**行为检测**，然后根据需要选中以下一个或多个检测项： * **文档密级保护** * **外发文件检测** * **复杂文件保护** ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2b507e26c08b2c0e3a2b517490c64930.png) 5. 如需在同一规则中检测文本敏感信息，同时选中**敏感信息检测**并配置敏感信息类型和执行动作。两类检测相互独立。 6. 设置规则名称、规则描述和生效智能体，确认无误后单击**确定**。 ### 配置文档密级保护文档密级保护根据飞书文档的企业密级标签执行对应动作。该配置对全局所有敏感信息防护策略生效。 1. 在行为检测的**文档密级保护**卡片中，单击**配置密级**。 2. 在**飞书应用对接**区域单击**编辑**，输入已完成权限配置的 App ID 和 App Secret，并完成同步。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5ce5aa5ea9dc830d0da54180f037af27.png) 3. 在**文档密级设置**区域，为每个 AgentSentry 标准密级配置企业密级标签和执行动作。以下取值仅作为参考示例，实际密级标签填写内容请以你的企业后台密级配置为准。 |标准密级 |企业密级标签示例 |可配置动作 | |---|---|---| |L1 公开 |L1\-Public |放行、仅记录或拦截 | |L2 内部 |L2\-Internal |放行、仅记录或拦截 | |L3 秘密 |L3\-Confidential |放行、仅记录或拦截 | |L4 机密 |L4\-Restricted |放行、仅记录或拦截 | |默认 |未匹配上述映射的企业密级标签 |放行、仅记录或拦截 | 4. 单击**确定**。

注意

请按照企业管理后台设置的实际飞书文档密级标签值填写，企业密级标签必须填写完整名称，包括连字符后的后缀，例如 L4\-Restricted，不能只填写 L4。

系统按照映射后的标准密级执行动作。映射错误会导致文档按错误密级处置，例如将 L4\-Restricted 映射到 L2 后，该文档会执行 L2 对应的动作。

建议先使用测试文档验证每个企业密级标签的映射和动作，再应用于生产环境。

App Secret 属于敏感凭据，请仅在 AgentSentry 配置页面中填写，不要记录在普通文档或日志中。

### 配置外发行为检测外发文件检测用于识别文件复制、上传、远程发送等外发行为，并按外发目标分别处置。该配置对全局所有敏感信息防护策略生效。 1. 在行为检测的**外发文件检测**卡片中，单击**配置规则**。 2. 分别设置以下外发类型的执行动作： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5878b67649f3c3a9b92f4f47fb90398e.png) |外发类型 |说明 | |---|---| |模型服务 |发往模型上下文的内容，默认放行。 | |其他服务 |复制、上传、远程发送等外发场景，默认进入敏感信息检测。 | 3. 单击**确定**。 ### 配置复杂文件保护复杂文件保护用于对大文件和特殊文件格式分别执行保护动作。该配置对全局所有敏感信息防护策略生效。 1. 在行为检测的**复杂文件保护**卡片中，单击**配置规则**。 2. 分别设置以下文件类型的执行动作： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_dfa87b92d12338496cc7f1a573cb7995.png) |文件类型 |说明 | |---|---| |大文件 |文件大小超过 5MB 时，不读取文件正文，按大文件策略执行。 | |特殊文件格式 |压缩包、图片、音视频、数据库文件、密钥文件等暂不支持正文检测，会按特殊文件格式策略执行。 | 3. 单击**确定**。行为检测支持以下执行动作： |执行动作 |处理结果 | |---|---| |放行 |允许当前操作继续执行。 | |仅记录 |允许当前操作继续执行，同时记录命中信息和处置结果，便于后续审计。 | |拦截 |中止当前操作，并在风险事件中记录命中信息和处置结果。 | ## 配置敏感信息检测 ### 配置内置敏感信息防护策略 1. 登录[ ArkClaw 企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 2. 在左侧菜单栏，选择**安全管理**。 3. 在**防护**页签下，选择**敏感信息防护**。 4. 单击**添加规则**，选中**敏感信息检测**，然后配置规则参数。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_47ecb288f04d04ae8664259005d3801d.png) |参数 |是否必填 |说明 | |---|---|---| |规则名称 |必填 |用于标识当前防护策略，建议体现检测对象和处置方式，例如“拦截客户合同信息”“记录个人隐私信息”。 | |规则描述 |选填 |用于说明策略适用场景、保护对象或业务背景。 | |敏感信息 |必填 |选择需要检测的内置敏感信息类型，例如个人隐私信息，身份证号、银行卡号等。 | |执行动作 |必填 |设定 AgentSentry 识别到上述敏感信息时的处置方式：

* 拦截：直接切断链路，阻止智能体调用对应工具或返回结果，对应会话同时记录于风险事件和审计日志中。

* 提醒：仅触发安全告警记录，但不阻断当前交互，对应会话同时记录于风险事件和审计日志中。 | |生效对象 |必填 |* 全部：对当前已经添加的全部智能体生效，且后续添加的智能体会自动加入到该规则中。

* 选择智能体：基于智能体维度设置生效范围。

* 选择标签：基于标签维度设置生效范围。 | 4. 确认信息无误后，单击**确定**。 ### 配置自定义敏感信息防护策略 1. 登录[ ArkClaw 企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 2. 在左侧菜单栏，选择 **防护 \> 敏感信息防护**。 3. 在左侧菜单栏，选择**安全管理**。 4. 在**防护**页签下，选择**敏感信息防护**。 5. 单击**添加规则**，选中**敏感信息检测**，然后配置规则参数。 |参数 |是否必填 |说明 | |---|---|---| |规则名称 |必填 |用于标识当前防护策略，建议体现检测对象和处置方式，例如“拦截客户合同信息”“记录个人隐私信息”。 | |规则描述 |选填 |用于说明策略适用场景、保护对象或业务背景。 | |敏感信息 |必填 |1. 选择**自定义\>自定义敏感信息**。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b656d15d02476ce652d92b82aa319e4c.png)

2. 设置自定义类型并配置对应参数。

* 自定义模型检测：添加自定义商业数据，例如采购合同、客户信息、技术方案等内容的 PDF、Word 格式文件，用于模型检测。

* 自定义规则：配置正则匹配规则，通过正则表达式匹配特定敏感信息。

3. 配置完成后，单击**确定**。 | |执行动作 |必填 |设定 AgentSentry 识别到上述敏感信息时的处置方式：

* 拦截：直接切断链路，阻止智能体调用对应工具或返回结果，对应会话同时记录于风险事件和审计日志中。

* 提醒：仅触发安全告警记录，但不阻断当前交互，对应会话同时记录于风险事件和审计日志中。 | |生效对象 |必填 |* 全部：对当前已经添加的全部智能体生效，且后续添加的智能体会自动加入到该规则中。

* 选择智能体：基于智能体维度设置生效范围。 | 6. 确认信息无误后，单击**确定**。 ## 效果验证与生效范围内的智能体发起对话，测试防护策略效果。 ### 内置敏感信息防护 * 发起对话： ```Bash # 使用真实数据格式对话，本示例中脱敏展示我的身份证号是 430703************ ``` * 防护效果： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7bd5ab6a81ae2bf86361962b94c49a02.png) * 风险事件详情： ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/28074fb8d95d4c5d9de9d3492169828d) ### 自定义敏感信息防护 * 规则配置： 1. 新建自定义敏感信息标签并上传敏感信息文件样本。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_13a0c4ab17781afeecc0c0644f661e03.png) 2. 在敏感信息防护规则中引用该自定义标签。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4f1c069475f6eab79ff0a4e5f6a63d09.png) 3. 创建完成后，敏感信息防护规则列表可以查看到新建的规则。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5f51fc5e5a223ae53a4b1f7ef904b4f5.png) * 发起对话：使用文件相关内容发起对话 ```Bash # 使用真实文件路径和 TOS 地址测试把 /root/年度经营复盘.pdf 上传到以下 TOS 地址：https://****.tos-cn-beijing.volces.com/public ``` * 防护效果： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6818e04cbec5d9f45da753a78f7e1f19.png) * 风险事件详情： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4a749e576a7c785bbc923f546020223d.png) ## 常见问题 ### 如何将应用添加为云文档协作者？ 1. 打开云文档，点击 ••• \> **更多** \> **添加文档应用**。 2. 搜索并选择目标应用，为应用分配 **可管理**、**可编辑** 或 **可阅读** 权限。 3. 点击 **添加**。该应用将出现在当前云文档的协作者列表，你也可以[修改其权限](https://www.feishu.cn/hc/zh-CN/articles/360049067490#tabs0%7Clineguid-kQWpz)。 ### 使用文件密级保护有哪些前置操作？ #### 一创建飞书应用并配置权限 1. 在[飞书开放平台](https://open.feishu.cn/app)创建或选择一个用于读取文档密级的飞书应用。 2. 为应用添加机器人应用能力。 1. 在左侧导航栏，选择**应用能力 \> 添加应用能力**。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_eb6cc7a86c94d57128ac4004550fe34f.png) 2. 在机器人对应卡片下方，单击**添加**。 3. 为飞书应用开通以下应用身份权限。 1. 在左侧导航栏，选择**开发配置 \> 权限管理**。 2. 单击**开通权限**。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3bcc4caf78778dbc31c77561d51c4dc5.png) 3. 搜索并添加以下权限。 * drive:drive.metadata:readonly（用于读取文档元数据，如文档标题、所有者等信息） ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_fa75a6e2defb3fc89d7da925cf99c2c8.png) * drive:file.meta.sec_label.read_only（用于读取文档密级标签，以进行权限判断） ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_463fc7f05fed2dbd9ae04c77d0ee4e70.png) 4. 发布飞书应用。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_76522073f5f48fa1f155f6429363645a.png) 5. 获取飞书应用的 App ID 和 App Secret。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_845b054d7c256c9c137732f6e11e8267.png) #### 二将需要保护的文档关联至飞书应用将飞书应用添加为待保护文档的协作者，并授予所需的文档访问权限。该关联行为用于为 AgentSentry 授予文档密级获取权限，以实施对应的策略防护行为。不配置该关联行为，则 AgentSentry 无法获取 L3 和 L4 级别的文档密级及详情信息。L1 和 L2 级别的文档可正常获取。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_10566a56d86efaf4a038d6e13aa31996.png) #### 三确认企业飞书云文档密级确认企业实际使用的密级标签名称，用于指定不同密级文档对应的防护动作。密级标签获取方式参考[管理员设置密级标签](https://www.feishu.cn/hc/zh-CN/articles/681363834397-%E7%AE%A1%E7%90%86%E5%91%98%E8%AE%BE%E7%BD%AE%E5%AF%86%E7%BA%A7%E6%A0%87%E7%AD%BE)。 #### 四确认智能体可以阅读和操作飞书云文档如果智能体本身不具备飞书 CLI 和飞书文档操作权限，文档密级防护策略也无法生效。此时需要为智能体安装飞书 CLI 和 Lark doc skill。将以下内容发送到智能体对话窗口即可安装。 ```Plain Text 安装飞书 CLI 和 Lark doc skill ``` ### 需要为每个待防护文档都添加文档应用吗？ AgentSentry 默认可以访问企业内部 L1 和 L2 级别的飞书云文档，为文档关联文档应用是为了获取 L3 和 L4 级别的文档标签信息。未添加文档应用的 L3 和 L4 文档会自动匹配到默认密级的执行动作。 * 如果你需要区分 L3 和 L4 密级文档的执行动作，则需要分别设置 L3 和 L4 密级文档对应的执行动作且为相关云文档添加文档应用。 * 如果你需要为所有 L3 和 L4 密级文档配置相同的执行动作，则仅配置默认密级的执行动作即可，无需再手动添加文档应用。例如下图中，配置默认密级的执行动作为拦截后，则所有 L3 和 L4 密级的飞书云文档都将在命中外发行为的检测防护策略后被拦截。