在 API 主控台中使用自訂字詞清單進行仲裁
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 快速入門 開始 ,以與您的應用程式整合。