次の方法で共有


クイック スタート: テキスト用の保護されたマテリアルの検出

テキスト用の保護されたマテリアル機能は、AI によって生成されたコンテンツに関連するリスクを管理するための包括的なソリューションを提供します (英語のコンテンツのみ)。 保護されたマテリアルの開示を検出して防止することで、組織は知的財産法に確実に準拠し、コンテンツの独創性を維持し、評判を保護することができます。 保護されたマテリアルとは、曲の歌詞、記事、レシピ、その他の選ばれた Web コンテンツなど、著作権で保護されたソースからの既知のテキストと一致するコンテンツを指します。

AI によって生成されたコンテンツを対象とするテキスト用の保護されたマテリアルの検出機能の主な目的は次のとおりです。

  • AI モデルによって生成された保護されたコンテンツの開示を検出して防止するため。
  • AI によって生成されたコンテンツに関連するリスクを組織が管理できるようにするため。
  • AI によって生成されたコンテンツが、法的、倫理的、コンテンツ ポリシーのガイドラインに準拠していることを確認するため。

保護されたマテリアルの検出の詳細については、保護されたマテリアルの検出の概念ページを参照してください。 API 入力の制限については、「概要」の「入力の要件」セクションを参照してください。

前提条件

  • Azure サブスクリプション - 無料アカウントを作成します
  • Azure サブスクリプションを入手したら、Azure portal で Content Safety リソースを作成し、キーとエンドポイントを取得します。 リソースの一意の名前を入力し、サブスクリプションを選択して、リソース グループ、サポートされているリージョン (「利用可能なリージョン」を参照)、サポートされている価格レベルを選択します。 [作成] を選択します。
    • リソースのデプロイには数分かかります。 完了したら、[リソースに移動] を選びます。 左ペインの [リソース管理] で、[サブスクリプション キーとエンドポイント] を選びます。 エンドポイントといずれかのキーが、API の呼び出しに使われます。
  • インストールされた [cURL](https://curl.haxx.se/)

保護済み素材の検出のためにテキストを分析する

次のセクションでは、cURL を使ったサンプル要求について説明します。 以下のコマンドをテキスト エディターに貼り付け、次の変更を加えます。

  1. <endpoint> を、リソースに関連付けられたエンドポイント URL に置き換えます。
  2. <your_subscription_key> を、リソースに付属するキーのいずれかに置き換えます。
  3. 必要に応じて、本文の "text" フィールドを、分析する独自のテキストに置き換えます。

    ヒント

    最大テキスト長の制限については、「入力要件」を参照してください。 保護済み素材検出は、ユーザー プロンプトではなく、LLM 完了時に実行されることを意図しています。

curl --location --request POST '<endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2024-09-01' \
--header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "text": "Kiss me out of the bearded barley Nightly beside the green, green grass Swing, swing, swing the spinning step You wear those shoes and I will wear that dress Oh, kiss me beneath the milky twilight Lead me out on the moonlit floor Lift your open hand Strike up the band and make the fireflies dance Silver moon's sparkling So, kiss me Kiss me down by the broken tree house Swing me upon its hanging tire Bring, bring, bring your flowered hat We'll take the trail marked on your father's map."
}'

URL には以下のフィールドを含める必要があります。

名前 必須 説明 種類
API バージョン 必須 これは確認する API のバージョンです。 現在のバージョン: api-version=2024-09-01。 例: <endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2024-09-01 String

要求本文のパラメーターは、次の表のように定義されています。

名前 必須 説明 種類
text 必須 これは、確認する生のテキストです。 他の非 ASCII 文字も含めることができます。 String

次のサンプル要求本文を参照してください。

{
  "text": "string"
}

コマンド プロンプト ウィンドウを開き、cURL コマンドを実行します。

API 応答を解釈する

保護済み素材の検出結果は、コンソール出力に JSON データとして表示されるはずです。 次に例を示します。

{
  "protectedMaterialAnalysis": {
    "detected": true
  }
}

出力の JSON フィールドは次のように定義されています。

名前 Description Type
protectedMaterialAnalysis API によって予測される各出力クラス。 String
detected 保護済みが検出されたかどうか。 ブール型

リソースをクリーンアップする

Azure AI サービス サブスクリプションをクリーンアップして削除したい場合は、リソースまたはリソース グループを削除することができます。 リソース グループを削除すると、それに関連付けられている他のリソースも削除されます。