跳到主要内容

参数​

有关所有插件均可使用的配置项，请参阅插件通用配置。

该插件支持使用 env:// 前缀从环境变量引用敏感参数值，也支持使用 secret:// 前缀从密钥管理器（例如 HashiCorp Vault 的 KV 密钥引擎）引用敏感参数值。有关更多信息，请参阅插件中的环境变量和密钥。

  • comprehend

    object

    必填

    AWS Comprehend 配置。

    • access_key_id

      string

      必填

      AWS Access Key ID。

    • secret_access_key

      string

      必填

      AWS Secret Access Key。该值在存储到 etcd 前会使用 AES 加密。

    • region

      string

      必填

      AWS 区域。

    • endpoint

      string

      AWS Comprehend 服务端点。未设置时，默认为 https://comprehend.{region}.amazonaws.com。

    • ssl_verify

      boolean

      默认值：true

      如果为 true，启用 TLS 证书验证。

  • moderation_categories

    object

    审核类别及其对应阈值的键值对。

    在每一对中，键应该是 PROFANITY（亵渎）、HATE_SPEECH（仇恨言论）、INSULT（侮辱）、HARASSMENT_OR_ABUSE（骚扰或滥用）、SEXUAL（色情）或 VIOLENCE_OR_THREAT（暴力或威胁）之一；阈值应该在 0 到 1 之间（包含 0 和 1）。

  • moderation_threshold

    number

    默认值：0.5

    有效值：

    介于 0 和 1 之间（含边界值）

    整体毒性阈值。值越高意味着允许的毒性内容越多。

    此选项不同于 moderation_categories 中的单个类别阈值。例如，如果 moderation_categories 设置了 PROFANITY 阈值为 0.5，而请求的 PROFANITY 分数为 0.1，则该请求不会超过类别阈值。但是，如果请求包含其他类别（如 SEXUAL 或 VIOLENCE_OR_THREAT）超过了 moderation_threshold，则该请求将被拒绝。

  • fail_mode

    string

    默认值：skip

    有效值：

    skip、warn 或 error

    当插件绑定到 Consumer 并收到其格式无法识别的请求（例如非 AI 请求）时的行为。取值为 skip 时，未识别的请求将不经检查直接放行。取值为 warn 时，请求将放行并记录一条警告日志。取值为 error 时，请求将以 HTTP 400 被拒绝。

    自 API7 企业版 3.9.14 起可用。