文字分類

注意

內容與商務AI為測試版。 說明檔案可能會有所變更。

文字分類服務在給定文字片段時,可將其分類為一或多個標籤。 分類可以是單一標籤、多標籤或階層式。

API格式

POST /services/v1/predict

要求

以下請求根據有效載荷中提供的輸入參數對片段中的文本進行分類。 請參閱範例裝載下表,以取得有關所示輸入參數的詳細資訊。

注意

analyzer_id 決定使 Sensei Content Framework 用的項目。請在提出要求之前,先檢查您是否有正確的analyzer_id。 請連絡內容與商務AI測試版團隊,以取得您的analyzer_id服務。

curl -w'\n' -i -X POST https://sensei.adobe.io/services/v1/predict \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Content-Type: multipart/form-data" \
  -H "cache-control: no-cache,no-cache" \
  -H "x-api-key: {API_KEY}" \
  -F file="{
    \"application-id\": \"1234\", 
    \"language\": \"en\", 
    \"content-type\": \"inline\", 
    \"encoding\": \"utf-8\", 
    \"data\": [{
      \"content-id\": \"abc123\", 
      \"content\": \"Server and Workstation Processors, Microcode Update is a self-extracting executable file containing the latest beta microcode updates (System Configuration Data) and software license agreement.\"
      }]
    }" \
  -F 'contentAnalyzerRequests={
    "enable_diagnostics":"true",
    "requests":[{
         "analyzer_id": "Feature:cintel-text-classifier:Service-38a4cc7b286449e6bc1977f59df01b47",
         "parameters": {}
    }]
}'
屬性 說明 必要
analyzer_id 您的請求部署在下的Sensei服務ID。 此ID決定使用哪個Sensei Content Frameworks。 如需自訂服務,請聯絡「內容與商務AI」團隊以設定自訂ID。
application-id 已建立應用程式的ID。
data 包含JSON物件的陣列,其中每個物件都代表檔案。 作為此陣列的一部分傳遞的任何參數都將覆蓋在data陣列外指定的全局參數。 下表中概述的任何其他屬性都可從data中覆寫。
language 輸入文字的語言。 預設值為 en
content-type 用於指出輸入是請求內文的一部分,還是S3儲存貯體的已簽署URL。 此屬性的預設值為inline
encoding 輸入文字的編碼格式。 這可以是utf-8utf-16。 此屬性的預設值為utf-8
threshold 需要傳回結果的分數臨界值(0到1)。 使用0值返回所有結果。 此屬性的預設值為0
top-N 要傳回的結果數(不能是負整數)。 使用0值返回所有結果。 當與threshold搭配使用時,傳回的結果數量會小於任一限制集。 此屬性的預設值為0
custom 要傳遞的任何自訂參數。 此屬性需要有效的JSON物件才能運作。
content-id 回應中傳回之資料元素的唯一ID。 如果未傳遞此資訊,則會指派自動產生的ID。
content 文字分類服務所使用的內容。 內容可以是原始文字(「內嵌」內容類型)。
如果內容是S3('s3-bucket' content-type)上的檔案,請傳遞已簽署的URL。

回應

成功的回應會傳回回應陣列中的分類文字。

{
  "status": 200,
  "cas_responses": [
    {
      "status": 200,
      "analyzer_id": "Feature:cintel-text-classifier:Service-38a4cc7b286449e6bc1977f59df01b47",
      "content_id": "",
      "result": {
        "response_type": "feature",
        "response": [
          {
            "feature_name": "abc123",
            "feature_value": [
              {
                "feature_value": [
                  {
                    "feature_value": 0.6899315714836121,
                    "feature_name": "Embedded & IoT"
                  }
                ],
                "feature_name": "labels"
              },
              {
                "feature_name": "status",
                "feature_value": "success"
              }
            ]
          }
        ]
      }
    }
  ],
  "error": []
}

本頁內容