자습서: Azure Container Apps C# 웹앱에 Azure AI 검색 추가

메모

Azure AI 검색 Azure 포털, REST API 및 Azure SDK 통해 사용할 수 있습니다. 또한 엔터프라이즈 콘텐츠를 Microsoft Foundry 포털의 에이전트에 대해 재사용 가능한 사용 권한 인식 기술 자료로 변환하는 관리되는 기술 계층인 Foundry IQ를 뒷받침합니다.

이 자습서에서는 책 카탈로그를 검색하는 웹사이트를 빌드하고 해당 웹사이트를 Azure Container Apps에 배포합니다. 배포는 Azure 개발자 CLI(azd) 및 관리 ID를 Azure AI 검색 기본 인증 방법으로 사용합니다.

이 자습서에서는 다음을 수행합니다.

  • Azure Developer CLI를 사용하여 Azure AI 검색 배포하고 인덱스를 자동으로 시드합니다.
  • C# 앱에서 검색 쿼리, 제안, 패싯, 페이지 매김 및 문서 조회를 통합합니다.
  • 관리 ID를 사용하여 기본 인증 방법으로 Azure Container Apps 앱을 배포합니다.

샘플에서 수행하는 작업은 무엇인가요?

이 샘플 웹 사이트는 10,000권의 책 카탈로그에 대한 액세스를 제공합니다. 검색 창에 텍스트를 입력하여 카탈로그를 검색할 수 있습니다. 텍스트를 입력하는 동안 웹 사이트에서는 검색 인덱스의 제안 기능을 사용하여 텍스트를 자동으로 완성합니다.

쿼리가 완료되면 웹 사이트에 세부 정보의 일부가 포함된 책 목록이 표시됩니다. 책을 선택하여 검색 인덱스로 저장된 전체 세부 정보를 볼 수 있습니다.

작성자 및 언어 패싯 및 페이지 매김 컨트롤이 있는 개에 대한 검색 결과를 보여 주는 샘플 앱의 스크린샷

검색 환경에는 다음이 포함됩니다.

  • 검색 - 애플리케이션에 대한 검색 기능을 제공합니다.
  • 제안 - 검색 창에서 사용자 유형으로 제안을 제공합니다.
  • 패싯 및 필터 - 작성자 또는 언어로 필터링하는 패싯 탐색 구조를 제공합니다.
  • 페이지가 매겨진 결과 - 결과를 넘겨 볼 수 있는 페이지 이동 컨트롤을 제공합니다.
  • 문서 조회 - ID별로 문서를 조회하여 세부 정보 페이지에 대한 모든 내용을 검색합니다.

샘플은 어떻게 구성되나요?

샘플 코드는 다음 구성 요소를 포함합니다.

앱 목적 GitHub 리포지토리 위치
client 검색을 사용하여 책을 표시하는 React 앱(프레젠테이션 계층)입니다. API를 호출합니다. /azure-search-static-web-app/client
api Azure Container Apps 컨테이너에서 호스트되는 C# Azure Functions API(비즈니스 계층)는 .NET SDK를 사용하여 Azure AI 검색 API를 호출합니다. /azure-search-static-web-app/api
bulk-insert 인덱스를 만들고 문서를 로드하는 .NET 프로젝트입니다. azd 배포는 postprovision 후크를 통해 이를 자동으로 실행합니다. /azure-search-static-web-app/bulk-insert
infra azd에서 Azure AI 검색, Azure Container Apps 및 지원 리소스를 배포하는 데 사용되는 Bicep 인프라. Azure-Samples/azure-search-static-web-app

개발 환경 설정

로컬 개발 환경에 대해 다음 소프트웨어를 설치합니다. 이 azd up 명령은 Azure AI 검색 포함하여 모든 Azure 리소스를 프로비전하므로 미리 만들 필요가 없습니다.

이 자습서에서는 Azure Functions API를 로컬로 실행하지 않습니다. 로컬로 실행하려면 Azure Functions Core Tools를 설치합니다.

Git을 사용하여 검색 샘플 복제

로컬 클론에서 샘플을 배포할 수 있습니다. 이 azd up 명령은 로컬 리포지토리에서 애플리케이션 및 인프라 파일을 읽고, 컨테이너를 빌드하고, Azure 리소스를 프로비저닝하고, 클라이언트와 API를 Azure Container Apps에 배포합니다.

  1. Bash 터미널에서 샘플 애플리케이션을 로컬 컴퓨터에 복제합니다.

    git clone https://github.com/Azure-Samples/azure-search-static-web-app.git

  2. 동일한 Bash 터미널에서 이 검색 예제의 리포지토리 디렉터리로 이동합니다.

    cd azure-search-static-web-app

  3. Visual Studio Code 명령을 code .사용하여 리포지토리를 엽니다. 별도로 지정되지 않는 한, 나머지 작업은 Visual Studio Code에서 완료합니다.

    code .

다음 단계:

Azure Container Apps에 앱 배포

  • Last updated on