語言 - 標註文字工作

Language - Annotate Text 工作可讓您使用 Cloud Natural Language，對指定文字執行多項自然語言作業，例如情緒分析、實體分析和語法分析。

如需支援的 Natural Language 作業相關資訊，請參閱支援的 Natural Language 作業。

事前準備

請務必先在 Google Cloud 專案中執行下列工作，再設定「Language - Annotate Text」(語言 - 註解文字) 工作：

啟用 Cloud Natural Language API (language.googleapis.com)。
啟用 Cloud Natural Language API
建立驗證設定檔。Application Integration 會使用驗證設定檔，連線至「語言 - 註解文字」工作的驗證端點。
如要瞭解如何授予服務帳戶其他角色或權限，請參閱「授予、變更及撤銷存取權」。

設定「語言 - 註解文字」工作

前往 Google Cloud 控制台的「Application Integration」頁面。
前往「Application Integration」
在導覽選單中，按一下「整合」。
系統隨即會顯示「整合」頁面，列出 Google Cloud 專案中可用的所有整合功能。
選取現有整合，或按一下「建立整合」建立新整合。
如要建立新的整合項目：
1. 在「建立整合」窗格中輸入名稱和說明。
2. 選取整合作業的區域。
  注意：「區域」下拉式選單只會列出 Google Cloud 專案中佈建的區域。如要佈建新區域，請按一下「啟用區域」。詳情請參閱「啟用新區域」。
3. 選取整合的服務帳戶。如要變更或更新整合的服務帳戶詳細資料，請隨時前往整合工具列的「整合摘要」窗格。
  注意：只有在您為所選區域啟用整合控管功能時，系統才會顯示選取服務帳戶的選項。
4. 按一下「建立」，新建立的整合服務會在整合服務編輯器中開啟。
在整合編輯器的導覽列中，按一下「Tasks」(工作)，即可查看可用工作和連結器的清單。
在整合服務編輯器中，點按並放置「Language - Annotate Text」(語言 - 註解文字) 元素。
在設計工具中，按一下「Language - Annotate Text」(語言 - 註解文字) 元素，即可查看「Language - Annotate Text」(語言 - 註解文字) 任務設定窗格。
前往「驗證」，然後選取要使用的現有驗證設定檔。
(選用步驟) 如果您尚未建立驗證設定檔，請在設定工作前按一下「+ 新增驗證設定檔」，然後按照「建立新的驗證設定檔」一文中的步驟操作。
前往「Task Input」(任務輸入內容)，然後使用下列「Task input parameters」(任務輸入參數) 表格，設定顯示的輸入欄位。
系統會自動儲存輸入欄位的變更。

工作輸入參數

下表說明「語言 - 註解文字」工作的輸入參數：

資源	資料類型	說明
區域	字串	您要執行註解作業的地區。例如 `us-central1`。
ProjectsId	字串	您的 Google Cloud 專案 ID。
要求	JSON	請參閱要求 JSON 結構。

工作輸出

「Language - Annotate Text」工作會根據執行的作業傳回回應輸出內容。以下是執行語法分析時的輸出範例：

{
    "sentences": [
        ... Array of sentences with sentence information
    ],
    "tokens": [
        ... Array of tokens with token information
    ]
}

支援的 Natural Language 作業

「Language - Annotate Text」工作可讓您執行下列 Natural Language 作業：

情緒分析: 使用情緒分析功能，識別並判斷指定文字的情緒態度 (正面、負面或中立)。如要執行這項作業，請將要求 JSON 的 extractDocumentSentiment 欄位設為 true。
實體分析: 使用實體分析檢查及擷取指定文字中的實體，例如專有名詞和普通名詞。如要執行這項作業，請將要求 JSON 的 extractEntities 欄位設為 true。
語法分析: 使用語法分析從指定文字中擷取語言資訊。如要執行這項作業，請將要求 JSON 的 extractSyntax 欄位設為 true。

錯誤處理策略

工作錯誤處理策略會指定工作因暫時性錯誤而失敗時，系統應採取的動作。如要瞭解如何使用錯誤處理策略，以及不同類型的錯誤處理策略，請參閱「錯誤處理策略」。

配額與限制

如要瞭解配額和限制，請參閱配額和限制。