GPT의 도움을 받아 질문에 대한 답변을 얻기 위해 Azure AI Search를 구성하는 방법.

Azure AI Search는 에이전트가 Azure AI Search 인덱스를 쿼리하고 반환된 문서를 답변에 사용할 수 있도록 하는 내장 에이전트 도구입니다.

구성

필수

시작하려면 Azure AI Search endpoint URL, 인덱스 이름 및 API 키가 필요합니다. 이를 .env 파일에 정의하세요:

AZURE_AI_SEARCH_SERVICE_ENDPOINT="..."
AZURE_AI_SEARCH_INDEX_NAME="..."
AZURE_AI_SEARCH_API_KEY="..."

AZURE_AI_SEARCH_SERVICE_ENDPOINT

이것은 검색 endpoint의 URL입니다. Cognitive Search 관리 콘솔의 검색 서비스 최상위 페이지에서 얻을 수 있습니다(예: https://example.search.windows.net).

AZURE_AI_SEARCH_INDEX_NAME

검색할 인덱스의 이름입니다 (예: hotels-sample-index).

AZURE_AI_SEARCH_API_KEY

검색 endpoint를 사용할 때 사용할 인증 키입니다. 관리 콘솔에서 발급받으십시오. 인증 키의 이름이 아닌 값을 사용하십시오.

튜토리얼 소개

Azure Portal에서 계정을 생성하거나 로그인하세요

1. **https://azure.microsoft.com/en-us/**를 방문하여 Get started 또는 Try Azure for Free를 클릭해 계정을 생성하고 로그인하세요.

2. 종량제(pay per use) 또는 $200 크레딧이 제공되는 Azure Free를 선택하세요.

Azure AI Search 서비스 생성

1. 제어판에 액세스하세요.

2. Create a resource를 클릭합니다.

3. 검색창에서 Azure Search를 검색하고 엔터를 누르세요.

4. 이제 Create를 클릭합니다.

5. 기본 설정을 구성하고, 새 리소스 그룹을 만들거나 기존 리소스 그룹을 선택한 다음, 원하는 이름으로 서비스 이름을 지정하고 위치를 선택하세요.

6. Change Pricing Tier를 클릭합니다.

이제 무료 옵션을 선택하거나 선호하는 옵션을 선택하세요(비용이 발생할 수 있습니다).

7. Review + create를 클릭하고 리소스가 생성될 때까지 기다립니다.

인덱스 생성하기

1. Import data를 클릭합니다.

2. Microsoft 튜토리얼을 따르세요: https://learn.microsoft.com/en-us/azure/search/search-get-started-portal. 완료 후, 인덱스에 부여된 이름을 어딘가에 저장해 두세요.

3. 이제 AZURE_AI_SEARCH_INDEX_NAME을 확인했으므로, 이를 복사하여 안전한 로컬 장소에 저장하세요.

엔드포인트 가져오기

1. Url: 항목에서 AZURE_AI_SEARCH_SERVICE_ENDPOINT를 확인하고, 이를 복사하여 안전한 로컬 저장소에 보관하세요.

2. 왼쪽 패널에서 keys를 클릭합니다.

3. Add를 클릭하고 키의 이름을 입력하세요.

4. 키를 복사하여 AZURE_AI_SEARCH_API_KEY를 얻습니다.

에이전트에 도구 추가하기

환경 변수를 추가한 후, LibreChat을 재시작하고 에이전트에 Azure AI Search를 추가하세요.

배포	명령어
Docker	`docker compose down && docker compose up -d`
Local	서버를 중지한 후, `npm run backend`를 다시 실행하세요

LibreChat에서 Agents를 선택하고, 에이전트를 생성하거나 편집한 다음, 에이전트의 Tools 목록을 열어 Azure AI Search를 선택하고 에이전트를 저장하세요.

테스트하기

Azure AI Search 인덱스를 통해 답변해야 하는 질문을 에이전트에게 하세요. 도구가 너무 많은 콘텐츠를 반환하는 경우, AZURE_AI_SEARCH_SEARCH_OPTION_TOP 및 AZURE_AI_SEARCH_SEARCH_OPTION_SELECT를 조정하세요.

선택 사항

다음은 필수 사항은 아니지만 검색 시 매개변수로 지정할 수 있는 구성 값입니다.

검색 결과 데이터가 너무 커서 프롬프트 크기를 초과할 우려가 있는 경우, AZURE_AI_SEARCH_SEARCH_OPTION_TOP 및 AZURE_AI_SEARCH_SEARCH_OPTION_SELECT를 사용하여 검색 결과 데이터의 크기를 줄이는 것을 고려하십시오.

각 매개변수에 대한 자세한 내용은 다음 문서를 참조하세요: https://learn.microsoft.com/en-us/rest/api/searchservice/search-documents

AZURE_AI_SEARCH_API_VERSION=2023-10-01-Preview
AZURE_AI_SEARCH_SEARCH_OPTION_QUERY_TYPE=simple
AZURE_AI_SEARCH_SEARCH_OPTION_TOP=3
AZURE_AI_SEARCH_SEARCH_OPTION_SELECT=field1, field2, field3