arrow_back

Cloud Natural Language API:Qwik Start

加入 登录

Cloud Natural Language API:Qwik Start

40 分钟 1 个积分

GSP097

Google Cloud 自定进度实验

概览

Cloud Natural Language API 可用于提取文本文档、新闻报道或博文中提及的人物、地点、事件等实体的相关信息。您也可以使用该 API 了解社交媒体上的用户对您产品的感受,或者解析呼叫中心或即时通讯应用中发生的客户对话所体现的意图。您甚至可以上传文本文档进行分析。

Cloud Natural Language API 的功能

语法分析:提取词条和句子、确定词性 (PoS),并为每个句子创建依存语法解析树。

实体识别:识别实体并按类型(例如人物、组织、地点、事件、产品和媒体)进行标记。

情感分析:了解一段文本体现的总体情感。

内容分类:按预定义的 700 多种类别对文档进行分类。

多语言支持:轻松分析多种语言的文本,包括英语、西班牙语、日语、中文(简体和繁体)、法语、德语、意大利语、韩语和葡萄牙语。

集成 REST API:可以通过 REST API 访问。可通过请求上传文本,也可将文本整合到 Cloud Storage 中存储的文档。

在本实验中,您将采用 analyze-entities 这一方法来要求 Cloud Natural Language API 从文本片段中提取“实体”(例如人物、地点和事件)。

设置和要求

点击“开始实验”按钮前的注意事项

请阅读以下说明。实验是计时的,并且您无法暂停实验。计时器在您点击开始实验后即开始计时,显示了 Google Cloud 资源可供您使用多长时间。

Qwiklabs 实操实验可让您在真实的云环境中开展实验活动,免受模拟或演示环境的局限。为此,我们会向您提供新的临时凭据,您可以在该实验的规定时间内通过此凭据登录和访问 Google Cloud。

准备工作

为完成此实验,您需要:

  • 能够使用标准的互联网浏览器(建议使用 Chrome 浏览器)。
  • 为完成实验留出时间。

注意:如果您已有自己的个人 Google Cloud 帐号或项目,请不要在此实验中使用。

注意:如果您使用的是 Chrome 操作系统设备,请在无痕式窗口中运行此实验。

如何开始实验并登录 Google Cloud 控制台

  1. 点击开始实验按钮。如果该实验需要付费,系统会打开一个弹出式窗口供您选择付款方式。左侧是实验详细信息面板,其中包含以下各项:

    • 打开 Google 控制台按钮
    • 剩余时间
    • 进行该实验时必须使用的临时凭据
    • 帮助您逐步完成本实验所需的其他信息(如果需要)
  2. 点击打开 Google 控制台。 该实验会启动资源并打开另一个标签页,显示登录页面。

    提示:请将这些标签页安排在不同的窗口中,并将它们并排显示。

    注意:如果您看见选择帐号对话框,请点击使用其他帐号
  3. 如有必要,请从实验详细信息面板复制用户名,然后将其粘贴到登录对话框中。点击下一步

  4. 请从实验详细信息面板复制密码,然后将其粘贴到欢迎对话框中。点击下一步

    重要提示:您必须使用左侧面板中的凭据。请勿使用您的 Google Cloud Skills Boost 凭据。 注意:在本次实验中使用您自己的 Google Cloud 帐号可能会产生额外费用。
  5. 继续在后续页面中点击以完成相应操作:

    • 接受条款及条件。
    • 由于该帐号为临时帐号,请勿添加帐号恢复选项或双重验证。
    • 请勿注册免费试用。

片刻之后,系统会在此标签页中打开 Cloud 控制台。

注意:您可以点击左上角的导航菜单来查看列有 Google Cloud 产品和服务的菜单。 “导航菜单”图标

激活 Cloud Shell

Cloud Shell 是一种装有开发者工具的虚拟机。它提供了一个永久性的 5GB 主目录,并且在 Google Cloud 上运行。Cloud Shell 提供可用于访问您的 Google Cloud 资源的命令行工具。

  1. 点击 Google Cloud 控制台顶部的激活 Cloud Shell “激活 Cloud Shell”图标

  2. 点击继续

预配和连接到环境需要一些时间。如果您连接成功,即表示您已通过身份验证,且当前项目会被设为您的 PROJECT_ID 环境变量所指的项目。输出内容中有一行说明了此会话的 PROJECT_ID

Your Cloud Platform project in this session is set to YOUR_PROJECT_ID

gcloud 是 Google Cloud 的命令行工具。它已预先安装在 Cloud Shell 上,且支持 Tab 键自动补全功能。

  1. (可选)您可以通过此命令列出有效的帐号名称:

gcloud auth list

输出

ACTIVE: * ACCOUNT: student-01-xxxxxxxxxxxx@qwiklabs.net To set the active account, run: $ gcloud config set account `ACCOUNT`
  1. (可选)您可以通过此命令列出项目 ID:

gcloud config list project

输出

[core] project = <project_ID>

输出示例

[core] project = qwiklabs-gcp-44776a13dea667a6 Note: For full documentation of gcloud, in Google Cloud, refer to the gcloud CLI overview guide.

创建 API 密钥

首先,您需要使用 PROJECT_ID 设置一个环境变量,以在此 Codelab 中全程使用。

export GOOGLE_CLOUD_PROJECT=$(gcloud config get-value core/project)

接下来,创建一个新的服务帐号来访问 Natural Language API:

gcloud iam service-accounts create my-natlang-sa \ --display-name "my natural language service account"

然后,创建新服务帐号的登录凭据。请使用以下命令创建这类凭据并将其保存为 JSON 文件“~/key.json”:

gcloud iam service-accounts keys create ~/key.json \ --iam-account my-natlang-sa@${GOOGLE_CLOUD_PROJECT}.iam.gserviceaccount.com

最后,设置 GOOGLE_APPLICATION_CREDENTIALS 环境变量。该环境变量应设为您之前创建的凭据 JSON 文件的完整路径。您可在上一个命令的输出结果中查看该路径。

export GOOGLE_APPLICATION_CREDENTIALS="/home/USER/key.json" Create an API Key

发出实体分析请求

为执行接下来的步骤,请通过 SSH 连接到为您预配的实例。打开导航菜单,然后点击 Compute Engine。您应该会看到以下预配的 Linux 实例:

provisioned-linux-instance.png

点击 SSH 按钮。您将转跳至一个交互式 shell。在本实验的剩余步骤中请不要离开该 SSH 会话。

现在,您需要对下面这个句子试用 Natural Language API 的实体分析功能:

Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'

运行以下 gcloud 命令:

gcloud ml language analyze-entities --content="Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'." > result.json Make an Entity Analysis Request

运行以下命令以预览 result.json 文件的输出。

cat result.json

您应该会在该 result.json 文件中看到类似以下内容的响应:

{ "entities": [ { "name": "Michelangelo Caravaggio", "type": "PERSON", "metadata": { "wikipedia_url": "http://en.wikipedia.org/wiki/Caravaggio", "mid": "/m/020bg" }, "salience": 0.83047235, "mentions": [ { "text": { "content": "Michelangelo Caravaggio", "beginOffset": 0 }, "type": "PROPER" }, { "text": { "content": "painter", "beginOffset": 33 }, "type": "COMMON" } ] }, { "name": "Italian", "type": "LOCATION", "metadata": { "mid": "/m/03rjj", "wikipedia_url": "http://en.wikipedia.org/wiki/Italy" }, "salience": 0.13870546, "mentions": [ { "text": { "content": "Italian", "beginOffset": 25 }, "type": "PROPER" } ] }, { "name": "The Calling of Saint Matthew", "type": "EVENT", "metadata": { "mid": "/m/085_p7", "wikipedia_url": "http://en.wikipedia.org/wiki/The_Calling_of_St_Matthew_(Caravaggio)" }, "salience": 0.030822212, "mentions": [ { "text": { "content": "The Calling of Saint Matthew", "beginOffset": 69 }, "type": "PROPER" } ] } ], "language": "en" }

详阅结果。对于该响应中的每个“entity”(实体),您将看到以下内容:

  • 该实体的 name(名称)和 type(类型):人物、地点、事件等
  • metadata(元数据):关联的 Wikipedia 网址(如果有)。
  • salience(显著性):该实体在这段文本中所在位置的索引。显著性是 [0,1] 范围内的一个数字,指的是相应实体对整个文本的中心性。
  • mentions(提及):指以不同方式提及的同一实体。

您已向 Cloud Natural Language API 发送了第一个请求。

恭喜!

c5c398f6ade6aa06.png ML-Language-Processing-badge.png

完成挑战任务

接下来请继续完成 Qwiklabs 基准:数据、机器学习和 AI 挑战任务或机器学习简介:语言处理挑战任务。一项挑战任务就是一系列相关的实验,学习时按部就班地执行这些实验即可。完成任一挑战任务可赢得上面的徽章,以表彰您取得的成就。您可以公开展示徽章,还可以在您的在线简历或社交媒体帐号中加入指向徽章的链接。如果您已完成本实验,那么注册参加上述任一挑战任务,马上就可以获得相应的积分。查看其他可参与的 Qwiklabs 挑战任务

后续步骤/了解详情

本实验是 Qwik Starts 系列实验的其中一项。通过这些实验,您可以亲自体验一下 Google Cloud 的诸多功能。请在实验目录中搜索“Qwik Starts”,找到您要参与的下一项实验!

Google Cloud 培训和认证

…可帮助您充分利用 Google Cloud 技术。我们的课程会讲解各项技能与最佳做法,可帮助您迅速上手使用并继续学习更深入的知识。我们提供从基础到高级的全方位培训,有点播、直播和虚拟三种培训方式可供选择,让您不必挤占忙碌时间。各项认证则可帮助您检验和证明您在 Google Cloud 技术方面的技能与专业知识。

上次更新手册的时间:2021 年 6 月 2 日
上次测试实验的时间:2021 年 6 月 2 日

版权所有 2020 Google LLC 保留所有权利。Google 和 Google 徽标是 Google LLC 的商标。其他所有公司名和产品名可能是其各自相关公司的商标。