Поделиться через


Краткое руководство. Создание демонстрационного приложения в портал Azure

В этом кратком руководстве по поиску ИИ Azure вы будете использовать мастер создания демонстрационных приложений портал Azure для создания скачиваемого веб-приложения в стиле localhost, работающего в браузере. В зависимости от конфигурации созданное приложение работает при первом использовании с активным подключением только для чтения к индексу в службе поиска. Приложение по умолчанию может включать строку поиска, область результатов, фильтры на боковой панели и поддержку опережающего ввода.

Демонстрационное приложение поможет визуализировать работу индекса в клиентском приложении, но оно не предназначено для рабочих сценариев. Рабочие приложения должны включать в себя безопасность, обработку ошибок и логику размещения, которая не предоставляет демонстрационного приложения.

Необходимые компоненты

Прежде чем приступить к работе, подготовьте указанные ниже необходимые компоненты:

  • Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .

  • Служба ИИ Azure. Создайте службу или найдите имеющуюся службу в рамках текущей подписки. Вы можете использовать бесплатную службу для выполнения инструкций, описанных в этом кратком руководстве.

  • Microsoft Edge (последняя версия) или Google Chrome.

  • Индекс поиска, который станет основой создаваемого приложения.

    При работе с этим кратким руководством используется встроенный пример данных об объектах недвижимости, который включает эскизные изображения, и индекс для него (мастер позволяет добавлять изображение на страницу результатов). Чтобы создать индекс для этого упражнения, запустите мастер импорта данных, выбрав источник данных realestate-us-sample.

    data source page for sample data

Когда индекс будет готов к использованию, переходите к следующему шагу.

Запуск мастера

  1. Войдите на портал Azure с помощью своей учетной записи Azure.

  2. Найдите службу поиска и на странице "Обзор" выберите Индексы из раздела со ссылками в середине страницы.

  3. Выберите realestate-us-sample-index из списка существующих индексов.

  4. В верхней части страницы индексов выберите Создание демонстрационного приложения (предварительная версия), чтобы запустить мастер.

  5. На первой странице мастера выберите Enable Cross Origin Resource Sharing (CORS) (Включить общий доступ к ресурсам в разных источниках (CORS)), чтобы добавить поддержку CORS в определение индекса. Этот шаг является необязательным, но без него локальное веб-приложение не сможет подключиться к удаленному индексу.

Настройка результатов поиска

Для выводимых результатов поиска в мастере предоставляется базовый макет, который включает пространство для эскиза, заголовка и описания. Для каждого из этих элементов в индексе существует поле, из которого предоставляются данные.

  1. Для параметра Thumbnail (Эскиз) выберите поле thumbnail из индекса realestate-us-sample. В этом примере эскизные изображения сохраняются в поле thumbnail в формате изображений с URL-адресами. Если ваш индекс не содержит изображений, оставьте это поле пустым.

  2. Для параметра Title (Заголовок) выберите поле, которое отражает уникальность каждого документа. В этом примере обоснованным выбором будет идентификатор списка.

  3. Для параметра Description (Описание) выберите поле, которое содержит полезные сведения для выбора документа, который захочет просмотреть посетитель.

    configure results for sample data

Добавление боковой панели

Служба поиска поддерживает фасетную навигацию, которая часто отображается в виде боковой панели. Аспекты основаны на полях, для которых в схеме индекса указана возможность фильтровать и аспектировать.

В поиске искусственного интеллекта Azure фасетная навигация — это накопительный интерфейс фильтрации. Выбор нескольких фильтров в одной категории позволяет получить более широкий набор результатов (например, Сиэтл и Бельвью для параметра City (Город)). Выбор нескольких фильтров в разных категориях позволяет сузить результаты.

Совет

Полную схему индекса вы можете изучить на портале. Используйте для этого ссылку Определение индекса (JSON) на странице обзора для каждого индекса. Пригодными для фасетной навигации считаются поля, для которых указаны атрибуты "filterable: true" и "facetable: true".

  1. В мастере выберите вкладку Боковая панель в верхней части страницы. Вы увидите список всех полей, которые относятся к фильтруемому и аспекту в индексе.

  2. Подтвердите текущее выделение аспектируемых полей и перейдите к следующей странице.

Добавление опережающего ввода

Функция опережающего ввода предоставляется в виде автозаполнения и предложений по запросам. Наш мастер поддерживает предложения по запросам. В зависимости от нажатых пользователем клавиш служба поиска возвращает список "готовых" строк запроса, которые можно выбрать в качестве входных данных.

Предложения включаются в определениях для конкретных полей. Мастер предоставляет возможность указать объем информации, включаемой в предложение.

На снимке экрана ниже представлены доступные в мастере варианты, наложенные на отображаемую в приложении страницу. Вы здесь видите, как используется выбор полей и параметр "Показать имя поля" для включения и исключения меток в предложении.

Query suggestion configuration

Добавление предложений

Предложения — это подсказки автоматизированных запросов, прикрепленные к полю поиска. Поиск ИИ Azure поддерживает два: автозавершение частично введенного поискового термина и предложения для раскрывающегося списка потенциальных подходящих документов на основе.

Мастер поддерживает предложения, а поля, которые могут предоставить предлагаемые результаты, являются производными от конструкции Suggesters в индексе:

  "suggesters": [
    {
      "name": "sg",
      "searchMode": "analyzingInfixMatching",
      "sourceFields": [
        "number",
        "street",
        "city",
        "region",
        "postCode",
        "tags"
      ]
    }
  ]
  1. В мастере выберите вкладку Предложения в верхней части страницы. Вы увидите список всех полей, назначенных в схеме индекса в качестве поставщиков предложений.

  2. Подтвердите выбор и перейдите к следующей странице.

Создание, скачивание и выполнение

  1. Выберите Create demo app (Создание демонстрационного приложения) в нижней части страницы, чтобы создать HTML-файл.

  2. Выберите Скачать приложение в ответ на соответствующий запрос.

  3. Откройте файл и нажмите кнопку "Поиск ". Это действие выполняет запрос, который может быть пустым запросом (*), возвращающим произвольный результирующий набор. Теперь страница должна выглядеть, как на снимке экрана ниже. Введите условие поиска и укажите фильтры, позволяющие сузить результаты.

Базовый индекс состоит из вымышленных, созданных данных, которые дублируются в документах, а описания иногда не соответствуют изображению. Вы можете ожидать более согласованные результаты, создав приложение на основе реальных индексов.

Run the app

Очистка ресурсов

Если вы работаете в собственной подписке, в конце проекта следует решить, нужны ли вам созданные ресурсы. Ресурсы, которые продолжат работать, могут быть платными. Вы можете удалить ресурсы по отдельности либо удалить всю группу ресурсов.

Просматривать ресурсы и управлять ими можно на портале с помощью ссылок Все ресурсы или Группы ресурсов на панели навигации слева.

Помните, что бесплатная служба ограничена тремя индексами, индексаторами и источниками данных. Вы можете удалить отдельные элементы на портале, чтобы не превысить лимит.

Следующие шаги

Демонстрационное приложение полезно для создания прототипов, поскольку вы можете имитировать опыт конечного пользователя, не нуждаясь в написании JavaScript или внешнего кода, однако, приближаясь к подтверждению концепции в вашем проекте, просмотрите один из примеров комплексного кода, который является более близким подобием реального приложения: