메모
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 |
Azure AI 검색, Azure Container Apps 및 지원 리소스를 배포하는 데 사용되는 azd 인프라를 Bicep. |
Azure-Samples/azure-search-static-web-app |
개발 환경 설정
로컬 개발 환경에 대해 다음 소프트웨어를 설치합니다. 이 azd up 명령은 Azure AI 검색 포함하여 모든 Azure 리소스를 프로비전하므로 미리 만들 필요가 없습니다.
- .NET 9 이상
- Git
- Visual Studio Code
- Visual Studio Code에 대한 C# Dev Tools 확장
-
Azure 개발자 CLI(
azd) - Docker Desktop 또는 다른 Docker 호환 컨테이너 런타임
이 자습서에서는 Azure Functions API를 로컬로 실행하지 않습니다. 로컬로 실행하려면 Azure Functions Core Tools를 설치합니다.
Git을 사용하여 검색 샘플 복제
로컬 클론에서 샘플을 배포할 수 있습니다. 이 azd up 명령은 로컬 리포지토리에서 애플리케이션 및 인프라 파일을 읽고, 컨테이너를 빌드하고, Azure 리소스를 프로비전하고, 클라이언트 및 API를 배포하여 Azure Container Apps.
Bash 터미널에서 샘플 애플리케이션을 로컬 컴퓨터에 복제합니다.
git clone https://github.com/Azure-Samples/azure-search-static-web-app.git동일한 Bash 터미널에서 이 검색 예제의 리포지토리 디렉터리로 이동합니다.
cd azure-search-static-web-appVisual Studio Code 명령을
code .사용하여 리포지토리를 엽니다. 달리 지정하지 않는 한 Visual Studio Code 나머지 작업을 완료합니다.code .