Azure AI Search의 Index Explorer 기능 활용법

query options

API version

Azrue AI Search의 API 버전으로
인덱스 관리, 데이터 수집, 검색 쿼리 실행, 시맨틱 검색 구성, 벡터 검색 구성 및 쿼리, 인덱서 관리 등의 주요 기능을 제공한다.

Semantic ranker

검색 결과를 의미적 관련성에 따라 재정렬할지 여부 결정

Semantic configuration

이전에 생성해둔 시맨틱 구성 선택값으로 단순 키워드 일치뿐만 아니라 의미적 관련성에 따라 정렬된다.

search explorer

{
  "@odata.context": "https://your-search-service.search.windows.net/indexes('products')/$metadata#docs(*)",
  "@odata.count": 15,
  "value": [
    {
      "@search.score": 0.87542,
      "@search.rerankerScore": 3.87652,
      "@search.captions": [
        {
          "text": "초경량 프리미엄 노트북으로 14인치 화면과 뛰어난 휴대성을 제공합니다. 최대 18시간의 배터리 수명과 고성능 인텔 프로세서를 탑재했습니다.",
          "highlights": "<em>초경량</em> 프리미엄 <em>노트북</em>으로 14인치 화면과 <em>뛰어난 휴대성</em>을 제공합니다."
        }
      ],
      "id": "laptop-001",
      "title": "LG 그램 14인치 울트라북",
      "content": "초경량 프리미엄 노트북으로 14인치 화면과 뛰어난 휴대성을 제공합니다. 최대 18시간의 배터리 수명과 고성능 인텔 프로세서를 탑재했습니다.",
      "metadata": {
        "attributes": [
          { "key": "brand", "value": "LG" },
          { "key": "category", "value": "노트북" },
          { "key": "weight", "value": "999g" }
        ]
      }
    },
    {
      "@search.score": 0.76321,
      "@search.rerankerScore": 3.55421,
      "@search.captions": [
        {
          "text": "가벼운 무게와 슬림한 디자인의 비즈니스 노트북입니다. 13.3인치 OLED 디스플레이와 울트라 휴대성을 자랑합니다.",
          "highlights": "<em>가벼운</em> 무게와 슬림한 디자인의 비즈니스 <em>노트북</em>입니다. 13.3인치 OLED 디스플레이와 울트라 <em>휴대성</em>을 자랑합니다."
        }
      ],
      "id": "laptop-002",
      "title": "삼성 갤럭시 북3 프로",
      "content": "가벼운 무게와 슬림한 디자인의 비즈니스 노트북입니다. 13.3인치 OLED 디스플레이와 울트라 휴대성을 자랑합니다.",
      "metadata": {
        "attributes": [
          { "key": "brand", "value": "Samsung" },
          { "key": "category", "value": "노트북" },
          { "key": "weight", "value": "1.17kg" }
        ]
      }
    }
  ],
  "@search.answers": [
    {
      "text": "LG 그램은 999g의 초경량 무게로 뛰어난 휴대성을 제공하는 프리미엄 노트북입니다.",
      "highlights": "LG 그램은 999g의 <em>초경량</em> 무게로 <em>뛰어난 휴대성</em>을 제공하는 프리미엄 <em>노트북</em>입니다."
    }
  ],
  "@search.nextPageParameters": {
    "search": "가벼운 노트북",
    "queryType": "semantic",
    "searchFields": "title,content,metadata/attributes/value",
    "select": "id,title,content,metadata",
    "skip": 10,
    "top": 10,
    "semanticConfiguration": "default-semantic-config"
  },
  "@odata.nextLink": "https://your-search-service.search.windows.net/indexes('products')/docs?search=가벼운%20노트북&$skip=10&$top=10&queryType=semantic&searchFields=title,content,metadata/attributes/value&$select=id,title,content,metadata&semanticConfiguration=default-semantic-config&api-version=2023-11-01"
}

• @odata.context: OData 메타데이터 컨텍스트 URL

• @odata.count: 검색 결과의 총 개수 ($count=true 사용 시)

• @odata.nextLink: 페이징 시 다음 페이지 URL

• @search.nextPageParameters: 다음 페이지 결과를 가져오기 위한 매개변수

• @search.answers: 검색 쿼리가 질문 형태일 때 추출된 답변 (비활성화는 queryType=simple)

  • highlights: 검색어가 매칭된 부분

• value: 검색 결과 목록

  • @search.score: 키워드 검색 점수 (0-1 사이 값, 높을수록 관련성이 높음)
  • @search.rerankerScore: Semantic reranker 사용 시 나타나는 재순위 점수 (일반적으로 1-4 사이 값)
  • @search.captions: Semantic 검색 사용 시 생성되는 요약문으로 text, highlights는 동일한 콘텐츠를 제공
    • text: 발췌 내용
    • highlights: 검색어가 강조된 발췌 내용 (HTML 태그 포함)

---

https://learn.microsoft.com/ko-kr/azure/search/semantic-how-to-query-request?tabs=portal-query#create-a-semantic-configuration
Return a semantic answer in Azure AI Search