语言 - 为文本添加注解任务

借助语言 - 为文本添加注解任务，您可以使用 Cloud Natural Language 对给定文本执行多项自然语言操作，例如情感分析、实体分析和语法分析。

如需了解支持的 Natural Language 操作，请参阅支持的 Natural Language 操作。

准备工作

在配置语言 - 为文本添加注解任务之前，请确保在您的 Google Cloud 项目中执行以下任务：

启用 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 项目中预配的区域。如需预配新区域，请点击 Enable Region。如需了解详情，请参阅启用新区域。
3. 为集成选择服务账号。您可以随时在集成工具栏的 集成摘要窗格中更改或更新集成的服务账号详细信息。
  注意：仅当您为所选区域启用了集成治理后，系统才会显示用于选择服务账号的选项。
4. 点击创建。
系统随即会在集成编辑器中打开该集成。
在集成编辑器导航栏中，点击任务以查看可用任务和连接器的列表。
点击 Language - Annotate Text（语言 - 为文本添加注解）元素，并将其放入集成编辑器中。
点击设计器上的 Language - Annotate Text（语言 - 为文本添加注解）元素以查看 Language - Annotate Text（语言 - 为文本添加注解）任务配置窗格。
前往身份验证，然后选择您要使用的现有身份验证配置文件。
可选。如果您在配置此任务之前未创建身份验证配置文件，请点击 + New authentication profile（+ 新建身份验证配置文件），然后按照创建新的身份验证配置文件中所述的步骤操作。
前往 Task Input（任务输入），然后使用以下任务输入参数表配置显示的输入字段。
系统会自动保存对输入字段的更改。

任务输入参数

下表介绍了语言 - 为文本添加注解任务的输入参数：

属性	数据类型	说明
区域	字符串	您要在其中运行添加注解操作的区域。例如 `us-central1`。
ProjectsId	字符串	您的 Google Cloud 项目 ID。
请求	JSON	请参阅请求 JSON 结构。

任务输出

语言 - 为文本添加注解任务会根据执行的操作返回响应输出。以下是执行语法分析时的示例输出：

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

支持的 Natural Language 操作

借助语言 - 为文本添加注解任务，您可以执行以下 Natural Language 操作：

情感分析: 使用情感分析来识别和确定给定文本的情绪基调（积极、消极或中立）。如需执行此操作，请将请求 JSON 的 extractDocumentSentiment 字段设置为 true。
实体分析: 使用实体分析来检查和检索给定文本中的实体（例如，专有名词和普通名词）。如需执行此操作，请将请求 JSON 的 extractEntities 字段设置为 true。
语法分析: 使用语法分析从给定文本中提取语言信息。如需执行此操作，请将请求 JSON 的 extractSyntax 字段设置为 true。

错误处理策略

任务的错误处理策略指定当任务因暂时性错误而失败时要执行的操作。如需了解如何使用错误处理策略，以及了解不同类型的错误处理策略，请参阅错误处理策略。

配额和限制

如需了解配额和限制，请参阅配额和限制。