在 API 主控台中使用自訂字詞清單進行仲裁

發行項
01/18/2024

Azure Content Moderator 中預設的全域字詞清單足以滿足大部分的 con帳篷模式ration 需求。不過，您可能需要篩選組織特定的字詞。例如，您可能想要標記競爭對手名稱，以便進一步檢閱。

使用清單管理 API 來建立要與文字仲裁 API 搭配使用的自訂條款清單。文字 - 螢幕 作業會掃描您的文字是否不雅，也會比較文字與自訂和共用封鎖清單。

注意

每個清單的字詞清單上限 為 5 個，不能 超過 10,000 個字詞 。

您可以使用清單管理 API 來執行下列工作：

建立清單。
將字詞新增至清單。
根據清單中的字詞篩選字詞。
從清單中刪除字詞。
刪除清單。
編輯清單資訊。
重新整理索引，讓清單的變更包含在新的掃描中。

使用 API 主控台

在線上主控台中測試 API 之前，您需要訂用帳戶金鑰。此金鑰位於 [Ocp-Apim-Subscription-Key ] 方塊中的 [設定 ] 索引標籤上。如需詳細資訊，請參閱概觀。

重新整理搜尋索引

對字詞清單進行變更之後，您必須重新整理其索引，以供日後掃描包含的變更。此步驟類似于桌面上的搜尋引擎（如果已啟用），或 Web 搜尋引擎會持續重新整理其索引，以包含新的檔案或頁面。

在字詞清單管理 API 參考中，選取左側功能表中的 [字詞清單 ]，然後選取 [ 重新整理搜尋索引 ]。

[字詞清單 - 重新 整理搜尋索引] 頁面隨即開啟。
針對 [ 開啟 API 測試主控台 ]，選取最接近您位置的區域。

[字詞清單 - 重新 整理搜尋索引 API] 主控台隨即開啟。
在 listId 方塊中，輸入清單識別碼。輸入您的訂用帳戶金鑰，然後選取 [ 傳送 ]。

建立字詞清單

移至字詞清單管理 API 參考。

[ 字詞清單 - 建立 ] 頁面隨即開啟。
針對 [ 開啟 API 測試主控台 ]，選取最接近您位置的區域。

[ 字詞清單 - 建立 API] 主控台隨即開啟。
在 [ Ocp-Apim-Subscription-Key] 方塊 中，輸入您的訂用帳戶金鑰。
在 [ 要求本文 ] 方塊中，輸入 [名稱 ] 和 [描述 ] 的值 。
使用索引鍵/值組預留位置，將更具描述性的中繼資料指派給您的清單。
```
{
    "Name": "MyExclusionList",
    "Description": "MyListDescription",
    "Metadata": 
    {
        "Category": "Competitors",
        "Type": "Exclude"
    }
}
```
將清單中繼資料新增為索引鍵/值組，而不是實際詞彙。
請選取傳送。您的清單已建立。請注意與新清單相關聯的識別碼值。您需要此識別碼才能用於其他字詞清單管理功能。
將字詞新增至 MyList。在左側功能表中的 [字詞] 底下，選取 [ 新增字詞 ]。

[ 字詞 - 新增字詞 ] 頁面隨即開啟。
針對 [ 開啟 API 測試主控台 ]，選取最接近您位置的區域。

[ 字詞 - 新增字詞 API] 主控台隨即開啟。
在 listId 方塊中，輸入您產生的清單識別碼，然後選取語言的值。輸入您的訂用帳戶金鑰，然後選取 [ 傳送 ]。
若要確認字詞已新增至清單，請在左側功能表中選取 [字詞 ]，然後選取 [ 取得所有字詞 ]。

[ 字詞 - 取得所有字詞 API 主控台] 隨即開啟。
在 listId 方塊中，輸入清單識別碼，然後輸入您的訂用帳戶金鑰。請選取傳送。
在 [ 回應內容] 方塊中，確認您輸入的字詞。
再新增一些字詞。既然您已建立自訂字詞清單，請嘗試使用自訂字詞清單來掃描某些文字。

刪除字詞和清單

刪除字詞或清單很簡單。您可以使用 API 來執行下列工作：

刪除字詞。（ 字詞 - 刪除 ）
刪除清單中的所有字詞，而不刪除清單。（ 字詞 - 刪除所有條款 ）
刪除清單及其所有內容。（ 字詞清單 - 刪除 ）

此範例會刪除單一字詞。

在字詞清單管理 API 參考中，選取左側功能表中的 [ 字詞 ]，然後選取 [ 刪除 ]。

[字詞 - 刪除 ] 隨即 開啟。
針對 [ 開啟 API 測試主控台 ]，選取最接近您位置的區域。

[字詞 - 刪除 API 主控台] 隨即 開啟。
在 listId 方塊中，輸入您要從中刪除字詞的清單識別碼。此識別碼是在字詞清單 - 取得 MyList 的詳細 資料主控台中 傳回的數位（在我們的範例中為 122 ）。輸入字詞並選取語言。
輸入您的訂用帳戶金鑰，然後選取 [ 傳送 ]。
若要確認字詞已刪除，請使用 字詞清單 - 取得所有 主控台。

變更清單資訊

您可以編輯清單的名稱和描述，以及新增中繼資料專案。

在 [ 字詞清單管理 API 參考 ] 的左側功能表中，選取 [字詞清單 ]，然後選取 [ 更新詳細資料 ]。

[ 字詞清單 - 更新詳細資料 ] 頁面隨即開啟。
針對 [ 開啟 API 測試主控台 ]，選取最接近您位置的區域。

[ 字詞清單 - 更新詳細資料 API 主控台] 隨即開啟。
在 listId 方塊中，輸入清單識別碼，然後輸入您的訂用帳戶金鑰。
在 [ 要求本文 ] 方塊中，進行編輯，然後選取 [ 傳送 ]。

下一步

在您的程式碼中使用 REST API，或從字詞清單 .NET 快速入門開始，以與您的應用程式整合。