AzureDeveloper

Azure认知搜索学习之使用Portal快速入门 - 创建Demo应用

分类: Azure搜索 ◆ 标签: #Azure #Search #认知搜索 ◆ 发布于: 2023-06-12 20:33:05

使用 Azure 门户的Create Demo App向导生成可在浏览器中运行、可供下载的localhost样式 Web 应用。根据其配置，生成的应用在首次使用时就能正常运行，并与远程索引建立实时只读连接。默认应用可以包含搜索栏、结果区域、边栏筛选器和自动提示支持。

该Demo App有助于你直观地了解索引在客户端应用中的工作方式，但其不适合生产场景。客户端应用应包括生成的 HTML页面，且未提供安全保证、错误处理和托管逻辑。

在开始之前，必须满足以下条件：

具有活动订阅的 Azure 帐户。免费创建帐户。
Azure 认知搜索服务。创建服务或在当前订阅下查找现有服务。可以使用本快速入门的免费服务。
Microsoft Edge（最新版本）或 Google Chrome。
已经创建好的索引(可以利用之前上一节创建好的索引)

本快速入门使用内置的realestate-us-sample示例数据和索引，因为该示例包含缩略图（向导支持将图像添加到结果页）。若要创建本练习中使用的索引，请运行import data向导，并选择“realestate-us-sample”数据源。

索引可供使用后，转到下一步。

启动向导

使用 Azure 帐户登录到 Azure 门户。
查找搜索服务，然后在overview页中间的链接中，选择indexes。
从现有索引的列表中选择“realestate-us-sample-index”。
在索引页的顶部，选择“创建演示应用(预览版)”以启动向导。
在第一个向导页上，选择“启用跨源资源共享(CORS)”以将 CORS 支持添加到索引定义。此步骤是可选的，但如果不执行此步骤，本地 Web 应用无法连接到远程索引。

配置搜索结果

向导将为呈现的搜索结果提供一个基本布局，其中包含缩略图、标题和说明的空间。其中的每个元素由索引中一个提供数据的字段赋值。

在缩略图中，选择realestate-us-sample索引中的thumbnail字段。此示例正好包含 URL 定址图像形式的缩略图，这些缩略图存储在名为thumbnail 的字段中。如果索引中没有图像，请将此字段留空。
在“标题”中，选择能够表达每个文档的唯一性的字段。在此示例中，列表 ID 是合理的选择。
在“说明”中，选择一个提供详细信息的字段，这些信息可以帮助用户确定是否要单击进入特定的文档。

添加边栏

搜索服务支持分面导航（通常以边栏的形式呈现）。分面基于可筛选且可分面的字段，在索引架构中表示。

在 Azure 认知搜索中，分面导航是一种累积筛选体验。在一个类别中选择多个筛选器会展开结果（例如，在“城市”中选择“西雅图”和“贝尔维尤”）。跨类别选择多个筛选器会缩小结果范围。

提示
可以在门户中查看整个索引架构。在每个索引的概述页中，找到“索引定义(JSON)”链接。符合分面导航要求的字段具有“filterable: true”和“facetable: true”属性。

在向导中，选择页面顶部的“边栏”选项卡。你将看到一个列表，其中有索引中被归为可筛选和可分面的所有字段。
接受当前选择分面字段，然后转到下一页。

添加自动提示功能

自动提示功能以自动完成和查询建议的形式提供。向导支持查询建议。根据用户提供的击键输入，搜索服务将返回可选作输入的“已完成”查询字符串列表。

在特定的字段定义中启用建议。向导提供相应的选项用于配置要在建议中包含的信息量。

以下屏幕截图显示了向导中的选项，同时显示了应用中呈现的页面。其中展示了如何使用字段选项，以及如何使用“显示字段名称”在建议中包含或排除标签。

添加建议

建议是指附加到搜索框的自动查询提示。认知搜索支持两种建议：自动补全部分输入的搜索词，以及根据可能的匹配文档建议一个下拉列表。

向导支持建议，可提供建议结果的字段派生自索引中的 Suggesters 构造：

  "suggesters": [
    {
      "name": "sg",
      "searchMode": "analyzingInfixMatching",
      "sourceFields": [
        "number",
        "street",
        "city",
        "region",
        "postCode",
        "tags"
      ]

在向导中，选择页面顶部的“建议”选项卡。你将看到一个列表，其中有在索引架构中指定为建议提供程序的所有字段。
接受当前所做的选择，然后转到下一页。

创建、下载和执行

选择页面底部的“创建演示应用”，生成 HTML 文件。
出现提示时，请选择“下载应用”以下载文件。
打开该文件，然后单击“搜索”按钮。此操作会执行一个查询，它可以是返回任意结果集的空查询 (*)。页面应类似于以下屏幕截图。输入一个搜索词，然后使用筛选器来缩小结果范围。

基础索引由虚构生成的、已在不同文档中复制的数据构成，说明有时与图像不符。如果基于自己的索引创建应用，则预期会获得更有整体性的体验。