最終更新日: 2024-12-10
利用上の注意
このポストは Microsoft 社の Azure 公式ドキュメント(CC BY 4.0 または MIT ライセンス) をもとに生成AIを用いて翻案・要約した派生作品です。 元の文書は MicrosoftDocs/azure-ai-docs にホストされています。
生成AIの性能には限界があり、誤訳や誤解釈が含まれる可能性があります。 本ポストはあくまで参考情報として用い、正確な情報は必ず元の文書を参照してください。
このポストで使用されている商標はそれぞれの所有者に帰属します。これらの商標は技術的な説明のために使用されており、商標権者からの公式な承認や推奨を示すものではありません。
この変更では、APIバージョンが最新のものに更新され、ブロックリストに関連するいくつかの説明が改訂されました。主な新機能としては、ユーザーからの入力に対するブロックリスト設定がより柔軟に行えるよう、“completionBlocklists”のタイトルを”promptBlocklists”に変更できるようになったことです。これにより、AIモデルの応答だけでなく、ユーザーの入力自体にもブロックリストを適用できるようになります。
特に破壊的な変更は見当たりませんが、APIバージョンの更新に伴い、既存の実装に影響を与える可能性があるため、確認が必要です。
この変更は、主にユーザーエクスペリエンスの向上と誤解を減らすことを目的としています。APIバージョンの更新は、通常、新機能や改善された機能を含みますが、具体的な機能の改良についてはここで明示されていません。しかしながら、バージョンの更新に伴う対応を行うことで、APIを利用する開発者はより効率的で効果的な開発が可能になるでしょう。
また、ブロックリストの名称変更オプションにより、ユーザーはコンテンツフィルタリングをより柔軟に管理できるようになります。これにより、特にスパムや不適切なコンテンツをプロンプトレベルで事前に防止することが容易になります。ブロックリスト名称に関するガイドラインの明確化も、APIの設定時に不必要なエラーを防ぎ、スムーズな利用を促進するものです。これらの変更は、開発者にとってのハードルを下げ、API利用の利便性を向上させます。
| Filename | Type | Title | Status | A | D | M |
|---|---|---|---|---|---|---|
| use-blocklists.md | minor update | APIバージョンの更新とブロックリストの説明の変更 | modified | 5 | 4 | 9 |
@@ -49,7 +49,7 @@ Copy the cURL command below to a text editor and make the following changes:
1. Optionally replace the value of the "description" field with a custom description.
```bash
-curl --location --request PUT 'https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/raiBlocklists/{raiBlocklistName}?api-version=2024-03-01-preview' \
+curl --location --request PUT 'https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/raiBlocklists/{raiBlocklistName}?api-version=2024-04-01-preview' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data-raw '{
@@ -72,10 +72,11 @@ To apply a **completion** blocklist to a content filter, use the following cURL
1. Replace {accountName} with your resource name.
1. Replace {raiPolicyName} with the name of your Content Filter
1. Replace {token} with the token you got from the "Get your token" step above.
-1. Replace "raiBlocklistName" in the body with a custom name for your list. Allowed characters: `0-9, A-Z, a-z, - . _ ~`.
+1. Optionally change the `"completionBlocklists"` title to `"promptBlocklists"` if you want the blocklist to apply to user prompts instead of AI model completions.
+1. Replace `"raiBlocklistName"` in the body with a custom name for your list. Allowed characters: `0-9, A-Z, a-z, - . _ ~`.
```bash
-curl --location --request PUT 'https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/raiPolicies/{raiPolicyName}?api-version=2024-03-01-preview' \
+curl --location --request PUT 'https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/raiPolicies/{raiPolicyName}?api-version=2024-04-01-preview' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data-raw '{
@@ -105,7 +106,7 @@ Copy the cURL command below to a text editor and make the following changes:
1. Replace the value of the `"blocking pattern"` field with the item you'd like to add to your blocklist. The maximum length of a blockItem is 1000 characters. Also specify whether the pattern is regex or exact match.
```bash
-curl --location --request PUT 'https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/raiBlocklists/{raiBlocklistName}/raiBlocklistItems/{raiBlocklistItemName}?api-version=2024-03-01-preview' \
+curl --location --request PUT 'https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/raiBlocklists/{raiBlocklistName}/raiBlocklistItems/{raiBlocklistItemName}?api-version=2024-04-01-preview' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data-raw '{ {
"modification_type": "minor update",
"modification_title": "APIバージョンの更新とブロックリストの説明の変更"
}この変更は、APIバージョンのアップデートと、ブロックリストに関連するいくつかの説明の修正を含んでいます。具体的には、いくつかのcURLコマンドで使用されているAPIバージョンが、“2024-03-01-preview”から”2024-04-01-preview”に変更されました。また、ユーザーがプロンプトに適用されるブロックリストをより柔軟に扱えるように、“completionBlocklists”のタイトルを”promptBlocklists”に変更するオプションが追加されました。これにより、利用者はAIモデルの回答ではなく、ユーザーからの入力に対してブロックリストを設定できるようになります。
さらに、ブロックリスト名に関するガイドラインの説明が明確化され、ブロックリスト名には使用できる許可された文字が列挙されています。これらの改訂は、ユーザーがAPIを利用する際の使いやすさを向上させ、誤解を減らすことを目的としています。