Развертывание приложения Поиск с использованием ИИ Azure C# для Контейнеры приложений Azure

Note

Поиск с использованием ИИ Azure доступна через портал Azure, REST API и Azure SDKs. Он также служит основой для Foundry IQ — управляемого слоя знаний, который преобразует корпоративный контент в повторно используемые базы знаний с учетом прав доступа для агентов в портале Microsoft Foundry.

Разверните веб-сайт с поддержкой поиска, чтобы Контейнеры приложений Azure с помощью интерфейса командной строки разработчика Azure (azd). Это развертывание включает клиент React, API .NET, Поиск с использованием ИИ Azure, управляемое удостоверение и вспомогательные ресурсы Azure.

Развертывание использует управляемое удостоверение в качестве метода проверки подлинности по умолчанию для Поиск с использованием ИИ Azure. Перед развертыванием можно выбрать проверку подлинности на USE_KEYLESS_AUTHfalse основе ключей.

Вход в Azure

  1. В Visual Studio Code откройте терминал в корневом каталоге репозитория, напримерazure-search-static-web-app.

  2. Войдите в Azure с помощью azd.

    azd auth login

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

Создание среды azd

  • azd Создайте среду. Замените YOUR-ENVIRONMENT-NAME коротким именем, определяющим развертывание этого руководства.

    azd env new YOUR-ENVIRONMENT-NAME

(Необязательно) Настройка проверки подлинности на основе ключей

Метод проверки подлинности по умолчанию является управляемым удостоверением, поэтому большинство сред могут пропустить этот раздел. Выполните этот раздел, только если для вашей среды требуются ключи API.

Установите USE_KEYLESS_AUTH на false.

azd env set USE_KEYLESS_AUTH false

Если этот параметр не задан USE_KEYLESS_AUTH, развертывание использует управляемое удостоверение. Инфраструктура Bicep предоставляет удостоверению приложения-контейнера доступ к плоскости данных Поиск с использованием ИИ Azure.

Развертывание с помощью azd up

  1. Из корня репозитория выполните команду azd up.

    azd up

  2. При появлении запроса выберите Azure подписку и расположение для ресурсов.

  3. azd Дождитесь подготовки инфраструктуры, сборки контейнеров, отправки образов и развертывания служб для Контейнеры приложений Azure.

  4. Просмотрите выходные данные после развертывания. Выходные данные включают полные доменные имена клиента и сервера (FQDN) для развертывания Контейнеры приложений Azure.

    AZURE_CLIENT_URL: <client-container-app-fqdn>
AZURE_SERVER_URL: <server-container-app-fqdn>
SEARCH_SERVICE_NAME: <search-service-name>

    AZURE_CLIENT_URL Используйте значение для открытия веб-сайта. Клиентское приложение вызывает серверные приложения через конечную точку, настроенную во время развертывания.

    Развертывание также создало службу Поиск с использованием ИИ Azure и автоматически загружает good-books индекс через postprovision перехватчик в примере репозитория.

Использование поиска на веб-сайте "Приложения контейнеров"

  1. Откройте полное доменное имя клиента из выходных azd up данных в браузере.

  2. В строке поиска веб-сайта введите поисковый запрос, например code. Функция автозаполнения предлагает соответствующие названия книг.

  3. Выберите предложение или продолжайте ввод собственного запроса. Нажмите клавишу ВВОД , когда завершите поисковый запрос.

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

Troubleshooting

Если веб-приложение не развертывает или не работает, используйте следующий список, чтобы определить и устранить проблему:

  • Выполнено azd up ?

    Просмотрите выходные azd up данные для первого неудачного этапа подготовки, сборки или развертывания. Если развертывание останавливается во время подготовки, проверьте разрешения подписки и выбранный регион. Если развертывание останавливается во время сборки или развертывания контейнера, повторно запустите azd up его после устранения проблемы.

  • Можно ли открыть конечную точку клиента?

    AZURE_CLIENT_URL Откройте значение из выходных azd up данных. Если страница не загружается, перейдите на портал Azure, откройте клиентское приложение контейнера и просмотрите его состояние редакции и журналы.

  • Может ли клиент вызвать конечную точку сервера?

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

  • Может ли серверный запрос Поиск с использованием ИИ Azure?

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

Очистите ресурсы

Используется azd down --purge для удаления ресурсов Azure, созданных этим руководством. Флаг --purge окончательно удаляет ресурсы, поддерживающие обратимое удаление, вместо того чтобы оставлять их в состоянии восстановления в течение срока хранения. Очистка позволяет избежать конфликтов именования при повторном развертывании этого руководства позже.

  1. В корневом каталоге репозитория выполните команду очистки.

    azd down --purge

  2. Просмотрите ресурсы, которые azd перечисляют.

  3. При появлении запроса подтвердите удаление.

Если вы создали службу Поиск с использованием ИИ Azure за пределами azd развертывания, перейдите в службу поиска на портале Azure и выберите "Удалить" в верхней части страницы.

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

Изучение кода интеграции поиска

  • Last updated on