内容审核
内容审核可对数据库文本和存储桶图片进行审核,具体能力取决于环境开关、资源配置和审核服务。数据库文本支持同步前置及符合条件的异步审核;存储图片在上传后按配置进行审核。
界面参考:测试项目尚未配置平台内容安全凭据;各环境的配置状态可能不同。
功能概述
在企业对外提供智能客服工单提交、用户社区评论或知识库图片附件上传服务(如示例项目 企业智能客服与知识中台 enterprise-ai-hub-210 中的工单表 customer_tickets 与多媒体存储桶 agent_multimedia_bucket)时,防范涉政、色情、暴恐、违禁及辱骂等违规内容进入生产数据库和对象存储是企业合规的刚性底线。
Agentbase Moderation 无需业务研发人员在每个接口中手动编写第三方内容安全 SDK 调用代码,直接在底层数据面网关与存储引擎上实现透明门禁:
双域精准覆盖(数据库文本 + 存储桶图片):
Database 文本审核:针对开启审核的数据表,在单行新增或更新时自动提取所有字符串类型字段的文本内容送审。
存储图片审核:当平台、项目和存储桶的图片审核配置均生效时,上传路径读取图片字节,通过 Base64 适配器送审。文件已先写入存储设备;审核拒绝或不可用时请求失败,执行到相应步骤时会尝试清理,但清理结果需要核查。
三模审核策略与审核二期异步状态机(2.9.0 / 2.10.0):
pre(同步前置模式):数据表文本在写入前审核;存储图片先上传至存储设备,再按配置审核。审核拒绝或不可用时请求失败,不能据此保证未写入或清理成功。post(异步后置模式)与hybrid(长短文本混合分流模式):写入先持久化并标记为审核中(checking),后台异步完成审核;未正式发布(published)前对普通读取请求执行审核状态检查,并支持违规转人工复核(quarantined)或私密扣留(private_hold)及周期任务自愈。
凭据优先级与模型网关解耦:项目 AK/SK 齐全时优先使用项目密钥对,否则回退平台密钥对;Endpoint 单独选择项目配置,未配置时回退平台端点。审核凭据与模型推理凭据分别配置。
| 核心功能视图 | 控制台路由路径 | 覆盖能力与配置项 | 所需权限 / 角色边界 |
|---|---|---|---|
| Moderation 首页(概览与凭据) | /console/project-{region}-{project}/moderation | 查看近 30 天调用总量(拆分平台凭据 vs 项目凭据调用);切换凭据模式、配置阿里云 AK/SK、超时(1–10s)、日志保留天数(1–365 天)与单图大小上限(1–20 MB) | 查看:任意项目成员;修改项目凭据:projects.write(owner/admin/developer/editor) |
| Moderation 全局日志页 | /console/project-{region}-{project}/moderation/logs · .../logs/{log} | 按资源类型(表/桶)、资源 ID、审核结果(pass/blocked/review/error)与时间范围检索;查看命中风险标签(Labels)、置信度与建议动作 | 任意项目成员可读(日志仅记录受限文件名与 ≤2000 字符文本预览,不存原始图片字节) |
| 数据表级审核配置与日志 | /databases/database-{db}/table-{table}/moderation | 为指定数据表开启文本审核,选择模式(pre / post / hybrid)与违规转人工复核开关,查看该表专属审核日志 | 数据库表写权限 |
| 存储桶级审核配置与日志 | /storage/bucket-{bucket}/moderation | 为指定存储桶开启图片(image)审核,查看该桶专属审核日志 | 存储桶写权限 |
核心概念与架构
1. 四种单次审核判定结果与系统动作对照表
无论底层调用阿里云 Green MultiModalGuard 返回何种详细分类,Agentbase 都会将其归一为以下四种标准判定结果,并在审核日志中完整记录命中的风险标签(Labels)、置信度(Confidence)与模型建议动作(Suggestion:pass / review / block / mask):
| 审核结果标识 | 含义说明 | pre 同步前置模式下的数据库写入行为 | 存储桶(Storage image/*)上传行为(Fail-Closed) |
|---|---|---|---|
pass(通过) | 未检测到违规风险或置信度低于拦截阈值 | 正常放行:数据行成功写入 OceanBase 表 | 正常保留:图片文件完成上传并持久化至存储桶 |
block(拦截) | 明确命中高风险内容 | 拒绝写入 | 拒绝上传:执行到清理步骤时尝试删除已上传对象;结果需核查 |
review(人工复核) | 模型建议人工复核 | 按配置处理:同步模式下拦截;异步模式可能进入待复核状态 | 拒绝上传:执行到清理步骤时尝试删除对象;结果需核查 |
error(错误) | 凭据、网络、读取或大小限制导致审核无法完成 | 按审核配置处理 | 上传失败:执行到对应步骤时尝试清理;上游异常或清理失败时需核查实际状态 |
2. 审核二期:异步后置(post)、混合分流(hybrid)与文档审核状态机
在平台管理员开启审核二期开关的环境中(二期关闭时,新建或更新配置不接受 post / hybrid;已有配置的执行路径回退到同步前置审核),数据表文本审核支持异步状态流转:
| 核心属性或状态值 | 枚举值 / 默认值 | 精确业务语义与读写可见性规则 |
|---|---|---|
审核模式(mode) | pre · post · hybrid | • pre:保存前同步检查;• post:先落库保存,后台异步送审;• hybrid:按平台配置的文本长度阈值自动分流——短文本留在同步路径即时返回,超长文本转入异步路径避免阻塞写入响应。 |
| 违规转人工复核开关 | requireManualReviewOnViolation(默认 true) | • 开启(true)时:违规记录进入 quarantined(已拦截) 隔离态等待复核;• 关闭( false)时:违规记录进入 private_hold(审核异常),进入私密扣留,仍须按下述规则和原有权限判断可见性。 |
moderationStatus 状态流转 | checking → pending → published / quarantined / private_hold / action_error | 数据表行内直观展示中文状态徽标(审核中 / 待审核 / 已拦截 / 审核异常 / 审核失败);对于偶发网络抖动导致卡在 checking 的记录,平台内置周期巡检任务按当前配置语义自动重判自愈,无需人工干预。 |
| 未发布内容读隔离与事件延后 | 针对非 published 状态的所有记录 | 处于 checking、pending、quarantined、private_hold 或 action_error 的数据行,对普通用户的审核状态检查允许创建者或最后修改者通过;API Key 与项目管理特权身份可豁免此检查。所有读取仍受适用的身份认证和数据库权限约束。含属性过滤条件的列表 total 只扣减当前页隐藏行,可能高估;发布后按配置处理延后事件。 |
角色、入口与关联关系
1. 资源级配置状态语义与覆盖范围边界
在为具体数据表或存储桶开启内容审核时,资源配置对象(/v1/moderation-configs)具有以下三种运行状态:
active(生效中):项目级审核已开启,且当前数据表或存储桶的资源级审核开关也已开启。inactive(未生效):当前数据表或存储桶的资源级审核开关处于关闭状态。disabled_by_project(项目侧关闭):虽然该表或存储桶配置了审核规则,但项目全局审核总开关被关闭,因此暂时不执行拦截。
覆盖范围明确边界:
支持审核:Database 表中的字符串类型列(String columns);Storage 桶中 MIME 类型为
image/*的图片文件。不在审核范围内:数值/布尔/日期等非字符串列,以及上传到 Storage 的视频(
video/*)、音频(audio/*)、压缩包或 PDF/Markdown 文档等非图片对象。
2. 内容审核凭据与模型 Provider 凭据的严格区分
在企业配置过程中,切勿将 Moderation(内容审核凭据) 与 Models(LLM Gateway 模型推理凭据) 混淆。两者对接的云服务、鉴权协议与配置入口完全独立:
| 对比维度 | 内容审核凭据(Moderation Credentials) | 模型 Provider 凭据(LLM Gateway Providers) |
|---|---|---|
| 控制台配置入口 | 项目侧边栏 Moderation(内容审核) 首页配置表单 | 项目侧边栏 模型(/llm-gateway) → Providers |
| 对接的目标云服务 | 阿里云内容安全(Green MultiModalGuard) | 大模型推理服务(如阿里云百炼 DashScope dashscope-prod、OpenAI、Anthropic 等) |
| 必填凭据字段 | 阿里云内容安全 HTTPS 审核端点(Endpoint) + AccessKey ID / AccessKey Secret(AK/SK 对) | 模型推理 Base URL + API Key(如 <DASHSCOPE_API_KEY>) + 模型能力目录 |
| 隔离原则 | 专门用于数据表写路径与存储桶图片上传风控,不可用于大模型对话或向量化 | 专门用于 Chat、Embedding、Rerank、Vision 推理,不可用于内容审核 |
功能详解与操作指南
1. 配置项目级内容审核凭据与高级风控参数
登录 Console 并进入项目
企业智能客服与知识中台(enterprise-ai-hub-210),在左侧边栏点击 Moderation(内容审核)(路径/console/project-default-enterprise-ai-hub-210/moderation,如图 1 所示)。审阅顶部近 30 天审核用量卡片:
页面上方展示三项关键统计:近 30 天审核调用总量、平台凭据调用量与项目自定义凭据调用量,并标注当前生效的凭据来源徽标。
选择凭据模式并配置参数(底层对应
PATCH /v1/projects/{projectId}/moderation):在配置表单中,可在 「使用平台凭据(Use platform credentials)」 与 「使用项目自定义凭据(Use custom project credentials)」 之间切换。
凭据与端点回退规则:项目 AK/SK 齐全时使用项目密钥对,否则使用平台密钥对;Endpoint 独立解析,项目端点为空时回退平台端点。因此项目密钥可能与平台端点组合,请核实最终凭据来源和目标端点。
若选择使用项目自定义凭据,请按表填写以下字段:
| 配置表单字段 | 取值范围 / 约束 | 默认值与生产配置建议 |
|---|---|---|
| Endpoint(审核服务端点) | 合法的 https:// 阿里云内容安全接入地址 | 例如 https://green-cip.cn-shanghai.aliyuncs.com。保存时校验 HTTPS URL 格式;请使用可信端点,并根据部署网络策略核实目标访问范围。 |
| AccessKey ID & Secret | 阿里云具备 Green 内容安全权限的 RAM 子账号 AK/SK | 保存后服务端加密存储、界面单向掩码不回显;支持随时点击清除后重新输入新密钥对。 |
| Timeout(审核超时时间) | 1 ~ 10 秒(整数) | 建议设为 3 ~ 5 秒,防止外部网络抖动长时间阻塞数据库写入或图片上传。 |
| Log retention(审核日志保留天数) | 1 ~ 365 天(整数) | 建议生产环境设为 90 或 180 天,满足合规审计回溯要求。 |
| Max image size(单图大小上限) | 1 ~ 20 MB(整数) | 设定允许送审的单张图片最大体积;超限时上传失败。执行到清理步骤时尝试删除已上传对象,清理结果需核查。 |
2. 为业务数据表与存储桶逐资源开启审核开关
完成项目级凭据确认后,需前往具体需要保护的数据表(如客户工单表 customer_tickets)或存储桶(如 agent_multimedia_bucket)开启资源级审核配置(底层对应 /v1/moderation-configs 系列端点):
A. 开启数据表(Database Table)文本审核
点击左侧边栏 数据库 → 进入数据库
enterprise_biz_db→ 点击数据表customer_tickets→ 切换到表详情顶部的 内容审核 页签(路径.../table-customer_tickets/moderation)。打开该表的文本审核开关(内容类型固定为
text)。选择审核模式:
默认选择
pre(保存前同步检查):任何包含违规词汇的工单提交都会在写入时被直接拦截。若平台已开启审核二期能力,可按需选择
post(异步后置审核) 或hybrid(长短文本混合分流),并勾选是否开启 违规时转人工复核(requireManualReviewOnViolation)。
保存后,可在数据表的 Rows(数据行) 列表中直观看到每条记录的审核状态徽标,并在表的 内容审核 页签下查看仅属于该表的审核拦截日志。
B. 开启存储桶(Storage Bucket)图片审核
点击左侧边栏 存储 → 点击进入目标存储桶(如
agent_multimedia_bucket) → 切换到桶详情顶部的 内容审核 页签(路径/storage/bucket-agent_multimedia_bucket/moderation)。打开该存储桶的图片审核开关(内容类型固定为
image)并保存。验证图片审核行为:确认平台、项目和桶的图片审核配置均已生效。该上传路径读取图片字节并以 Base64 送审;违规、超出审核上限或审核不可用时上传失败。执行到相应清理步骤时会尝试删除已上传对象,发生异常时请核查清理结果。
3. 查询与审计内容审核日志(Moderation Logs)
当终端用户反馈“工单提交被拒”或“图片上传失败”时,管理员可通过全局或资源级审核日志在 1 分钟内定位拦截原因:
进入项目侧边栏 Moderation → Logs 页签(路径
/console/project-default-enterprise-ai-hub-210/moderation/logs,对应接口/v1/moderation-logs)。使用顶部组合筛选栏缩小范围:
资源类型(Resource type):选择数据表(Table)或存储桶(Bucket)。
资源 ID(Resource ID):输入如
customer_tickets或agent_multimedia_bucket。审核结果(Result):筛选
pass(通过)、blocked(拦截)、review(复核拦截)或error(调用异常)。时间范围(Time range):框定发生拦截的时间段。
点开任意一条拦截记录进入日志详情页(
/moderation/logs/{log}),核对以下关键取证字段:基础上下文:时间戳、所属资源类型与 ID、内容类型(
text/image)、底层 Provider 与阿里云请求 ID(Request ID)。隐私安全内容预览:文本审核展示不超过
2000字符的截断文本预览;图片审核仅记录受限的文件名预览,绝不在日志中存储原始图片字节、Base64 编码或完整内部对象路径,严格保护用户数据隐私。判定依据:命中的风险 Labels(标签)、Confidence(置信度分值)、Suggestion(模型建议动作:
pass/review/block/mask) 以及具体的错误信息。
常见问题与排障
Q1:为什么在存储桶开启图片审核后,上传 PDF 文档或 MP4 视频没有触发审核记录,而上传一张 15 MB 的高清 PNG 图片却直接报错且桶里找不到文件?
原因与排查步骤:
PDF / 视频未触发审核:Agentbase Storage 内容审核的作用对象严格限定为 MIME 类型匹配
image/*的图片文件;PDF 文档、Markdown 文件、音频与视频不在图片审核覆盖范围内,会按普通文件流程上传。15 MB 图片上传失败:检查项目审核配置的 Max image size(1–20 MB)。若上限为默认
10 MB,15 MB 图片会超限;可调整上限或压缩图片后重新上传。异常后需核查已上传对象及记录的清理状态。
Q2:开启了审核二期的 post(异步后置)模式后,为什么用户 A 刚提交的评论自己刷新能看到,但用户 B 却看不到,而且也没触发 Webhook?
原因与排查步骤: 这是审核二期未发布内容读隔离(Read Isolation)的预期安全机制:
在
post或hybrid异步路径下,新写入的记录初始状态为checking(审核中),如果命中疑似违规还会进入pending(待审核)、quarantined(已拦截)或private_hold(审核异常)。在状态变为
published(已发布) 之前,创建者或最后修改者可以通过审核状态检查,API Key 与项目管理特权身份可豁免此检查;实际读取仍需满足适用认证及数据库权限。其他普通用户的记录会被过滤。含属性过滤条件的列表total可能高估,不应作为精确可见行数。同时,为了防止违规内容通过事件外泄,Realtime 广播、Functions 事件触发与 Webhooks 均会延后,直到后台异步审核通过并切换为
published后才会自动补发。
Q3:我在“模型(LLM Gateway)”页面已经配好了阿里云 DashScope 的 API Key,为什么开启 Moderation 内容审核时还是报错凭据无效?
原因与排查步骤: 内容审核凭据与模型网关凭据是两套完全独立、互不复用的配置:
模型(LLM Gateway
/llm-gateway) 对接的是大模型推理服务(如百炼 DashScopeqwen-plus),使用的是推理 API Key。内容审核(Moderation
/moderation) 对接的是阿里云内容安全(Green MultiModalGuard),使用的是阿里云 RAM 的 AccessKey ID + AccessKey Secret(AK/SK) 与 Green 专属接入端点。 请前往项目 内容审核 首页,切换为“使用平台凭据”(若平台管理员已全局配置),或填入开通了阿里云内容安全 Green 服务的专属 AK/SK 对。
