跳到主要内容

参数​

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

  • match_all_roles

    boolean

    默认值：false

    如果为 true，验证所有角色的消息。如果为 false，仅验证 user 角色的消息。

  • match_all_conversation_history

    boolean

    默认值：false

    如果为 true，则拼接并检查对话历史记录中的所有消息。如果为 false，则仅检查最后一条消息的内容。

    此选项不适用于 Responses API 请求，因为 instructions 和 input 是并列字段，而不是对话历史。

  • allow_patterns

    array[string]

    默认值：[]

    消息应匹配的正则表达式数组。配置后，消息必须至少匹配一个模式才被视为有效。

  • deny_patterns

    array[string]

    默认值：[]

    消息不应匹配的正则表达式数组。如果消息匹配任何模式，请求将被拒绝。

    如果同时配置了 allow_patterns 和 deny_patterns，插件首先确保至少匹配一个 allow_patterns。

  • fail_mode

    string

    默认值：skip

    有效值：

    skip、warn 或 error

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

    自 API7 企业版 3.9.14 起可用。

  • max_req_body_size

    integer

    默认值：67108864

    缓冲到内存中的请求体最大字节数。超过该上限的请求体会被拒绝。自 API7 企业版 3.9.x 系列的 3.9.17 版本起可用，3.10.x 系列自 3.10.4 版本起可用。