AI Azure Content Safety Configuration

このページは、まだ日本語ではご利用いただけません。翻訳中です。

構成

このプラグインはDBレスモードに対応しています。

互換性のあるプロトコル

AI Azure Content Safetyプラグインは以下のプロトコルに対応しています：

grpc, grpcs, http, https

パラメータ

このプラグインの設定で使用できるすべてのパラメータのリストは次のとおりです。

• name or plugin

  string required

  プラグイン名。この場合は ai-azure-content-safety 。

  • Kong Admin API、Kong Konnect API、宣言型構成、または decK ファイルを使用する場合、フィールドはnameです。
  • Kubernetes で KongPlugin オブジェクトを使用する場合、フィールドはpluginです。

• instance_name

  string

  プラグインのインスタンスを識別するための任意のカスタム名 (例: ai-azure-content-safety_my-service 。

  インスタンス名はKong ManagerとKonnectに表示されるので、 例えば複数のサービスで同じプラグインを複数のコンテキストで実行する場合に便利です。また、Kong Admin API経由で特定のプラグインインスタンスに アクセスするためにも使用できます。

  インスタンス名は、次のコンテキスト内で一意である必要があります。

  • Kong Gateway Enterpriseのワークスペース内
  • Konnectのコントロールプレーン（CP）またはコントロールプレーン（CP）グループ内
  • Kong Gateway (OSS)の全世界

• service.name or service.id

  string

  プラグインが対象とするサービス名または ID。最上位の /plugins エンドポイント. からプラグインをサービスに追加する場合は、これらのパラメータのいずれかを設定してください /services/{serviceName|Id}/plugins を使用する場合は必要ありません。

• route.name or route.id

  string

  プラグインがターゲットとするルート名または ID。最上位の /plugins エンドポイント. を通るルートにプラグインを追加する場合は、これらのパラメータのいずれかを設定してください /routes/{routeName|Id}/plugins を使用する場合は必要ありません。

• enabled

  boolean default: true

  このプラグインが適用されるかどうか。

• config

  record required
  • content_safety_url

    string required referenceable

    Full URL, inc protocol, of the Azure Content Safety instance.

  • azure_api_version

    string required default: 2023-10-01 len_min: 1

    Sets the ?api-version URL parameter, used for defining the Azure Content Services interchange format.

  • azure_use_managed_identity

    boolean default: false

    If checked, uses (if set) azure_client_id, azure_client_secret, and/or azure_tenant_id for Azure authentication, via Managed or User-assigned identity

  • azure_client_id

    string

    If azure_use_managed_identity is true, set the client ID if required.

  • azure_client_secret

    string

    If azure_use_managed_identity is true, set the client secret if required.

  • azure_tenant_id

    string

    If azure_use_managed_identity is true, set the tenant ID if required.

  • content_safety_key

    string referenceable encrypted

    If azure_use_managed_identity is true, set the API key to call Content Safety.

  • text_source

    string default: concatenate_all_content Must be one of: concatenate_all_content, concatenate_user_content

    Select where to pick the ‘text’ for the Azure Content Services request.

  • categories

    array of type record

    Array of categories, and their thresholds, to measure on.

    • name

      string required

    • rejection_level

      integer required

  • reveal_failure_reason

    boolean default: true

    Set true to tell the caller why their request was rejected, if so.

  • output_type

    string default: FourSeverityLevels Must be one of: FourSeverityLevels, EightSeverityLevels

    See https://learn.microsoft.com/en-us/azure/ai-services/openai/concepts/content-filter#content-filtering-categories

  • blocklist_names

    array of type string

    Use these configured blocklists (in Azure Content Services) when inspecting content.

  • halt_on_blocklist_hit

    boolean default: true

    Tells Azure to reject the request if any blocklist filter is hit.