메모
Foundry IQ (Azure AI 검색)는 관리 검색을 위해 직접 인덱싱 및 쿼리 API와 함께 상위 수준의 지식 소스 및 지식 베이스 API를 제공합니다. Azure 포털, REST API 또는 Azure SDK 사용하여 이러한 기능을 구성하거나 Microsoft Foundry 포털의 기술 자료에 에이전트를 연결합니다.
이 자습서에서는 책 카탈로그를 검색하는 웹사이트를 빌드하고 해당 웹사이트를 Azure Container Apps에 배포합니다. 배포에서는 Azure 개발자 CLI(azd) 및 관리 ID를 Foundry IQ의 기본 인증 방법으로 사용합니다.
이 자습서에서는 다음을 수행합니다.
- Foundry IQ를 배포하고 Azure Developer CLI를 사용하여 인덱스를 자동으로 시드합니다.
- 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를 사용하여 Foundry IQ API를 호출합니다. | /azure-search-static-web-app/api |
bulk-insert |
인덱스를 만들고 문서를 로드하는 .NET 프로젝트입니다.
azd 배포는 postprovision 후크를 통해 이를 자동으로 실행합니다. |
/azure-search-static-web-app/bulk-insert |
infra |
Foundry IQ, Azure Container Apps 및 지원 리소스를 배포하는 데 azd에서 사용되는 Bicep 인프라. |
Azure-Samples/azure-search-static-web-app |
개발 환경 설정
로컬 개발 환경에 대해 다음 소프트웨어를 설치합니다. 이 azd up 명령은 Foundry IQ를 포함하여 모든 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 .