검색 결과에서 의미 랭커를 구성하고 캡션을 반환

참고

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

Important

기능, 기능 또는 표시된 속성(미리 보기)은 서비스 수준 계약에 포함되지 않으며 프로덕션 워크로드에는 권장되지 않으며 일반적으로 사용 가능해지기 전에 변경되거나 제한될 수 있습니다. Azure AI 검색 미리 보기 용어는 독립 실행형 기능이든 일반 공급 기능의 일부이든 관계없이 모든 미리 보기 기능에 적용됩니다.

의미 체계 순위는 초기 결과 집합을 반복하여 가장 의미상 관련성이 높은 결과를 스택의 맨 위로 승격하는 L2 순위 방법론을 적용합니다. 또한 의미론적 캡션을 얻을 수 있으며, 가장 관련성 높은 용어와 구문에 강조 표시가 들어간 의미 체계 답변을 받을 수 있습니다.

이 문서에서는 시맨틱 재정렬을 위해 검색 인덱스를 구성하는 방법을 설명합니다.

참고

미리 보기 또는 이전 API 버전을 호출하는 기존 코드가 있는 경우 코드 수정에 대한 도움말은 마이그레이션 의미 체계 순위 코드를 참조하세요.

필수 구성 요소

Azure AI 검색는 의미 순위를 제공하는 모든 지역에서 사용할 수 있습니다.
서식 있는 텍스트 콘텐츠가 있는 기존 검색 인덱스입니다. 의미 체계 순위는 문자열(비벡터) 필드에 적용되며 정보 또는 설명이 포함된 콘텐츠에서 가장 적합합니다.
Azure AI 검색에서 개체를 만들고 사용할 수 있는 권한입니다. 역할 기반 액세스를 권장하지만 역할 할당이 불가능한 경우 API 키를 사용할 수 있습니다. 자세한 내용은 검색 서비스에 연결을 참조하세요.
Search Service REST API의 2026-08-01-preview 버전입니다.

클라이언트 선택

다음 도구 및 SDK(소프트웨어 개발 키트)를 사용하여 의미 체계 구성을 추가하여 새 인덱스 또는 기존 인덱스에 대한 의미 체계 구성을 지정할 수 있습니다.

Azure 포털 인덱스 디자이너를 사용하여 의미 체계 구성을 추가합니다.
Visual Studio Code REST 클라이언트 및 REST(인덱스 만들기 또는 업데이트) API.
.NET용 Azure SDK
Python용 Azure SDK
Java용 Azure SDK
JavaScript용 Azure SDK

의미 체계 구성 추가

일부 워크로드는 의미 체계 구성을 자동으로 만듭니다. Azure AI 검색의 agentic 검색 및 콘텐츠를 인덱싱하는 지식 소스를 사용하는 경우, 생성된 인덱스에는 귀하의 콘텐츠에 적합한 의미 구성 설정이 이미 포함되어 있습니다.

팁 (조언)

2026-05-01-preview API 버전부터 지원되는 에이전트 검색 기술 자료 흐름에는 명시적 의미 체계 구성이 필요하지 않습니다. 이 예외는 클래식 의미 체계 순위 쿼리 또는 이전 API 버전에는 적용되지 않습니다. 자세한 내용은 검색 인덱스 지식 원본 만들기를 참조하세요.

다른 워크로드의 경우 의미 체계 구성을 직접 설정할 수 있습니다. 의미 체계 구성은 의미 체계 순위에 사용되는 필드 입력을 설정하는 인덱스의 섹션입니다. 언제든지 의미 체계 구성을 추가하거나 업데이트할 수 있으며 다시 빌드할 필요가 없습니다. 여러 구성을 만드는 경우 기본값을 지정할 수 있습니다. 쿼리 시 쿼리 요청에 의미 체계 구성을 지정하거나 기본값을 사용하도록 비워 둡니다.

단일 인덱스에 최대 100개의 의미 체계 구성을 만들 수 있습니다.

의미 체계 구성에는 이름과 다음 속성이 있습니다.

속성	특성
제목 필드	25단어 미만의 짧은 문자열입니다. 이 필드는 문서의 제목, 제품 이름 또는 고유 식별자일 수 있습니다. 적합한 필드가 없으면 비워 둡니다.
콘텐츠 필드	기계 학습 모델의 최대 토큰 입력 제한 에 따라 자연어 형식의 텍스트 청크가 길어질 수 있습니다. 일반적인 예로는 문서의 본문, 제품에 대한 설명 또는 기타 자유 형식 텍스트가 있습니다.
키워드 필드	문서의 태그와 같은 키워드 목록 또는 항목 범주와 같은 설명이 포함된 용어입니다.

하나의 제목 필드만 지정할 수 있지만 원하는 만큼 콘텐츠 및 키워드 필드를 포함할 수 있습니다. 콘텐츠 및 키워드 필드의 경우 우선 순위가 낮은 필드가 잘려질 수 있으므로 우선 순위 순서로 필드를 나열합니다.

모든 의미 체계 구성 속성에서 할당하는 필드는 다음과 여야 합니다.

searchable 및 retrievable로 지정됨
Edm.String형, Collection(Edm.String)형 문자열과 Edm.ComplexType의 문자열 하위 필드

Azure 포털 검색 서비스로 이동합니다.
왼쪽 탐색 창의 인덱스에서 인덱스를 선택합니다.
의미 체계 구성을 선택한 다음, 의미 체계 구성 추가를 선택합니다.

Azure 포털에서 의미 구성 추가 옵션을 보여주는 화면 캡처입니다.
새 의미 체계 구성 페이지에서 의미 체계 구성 이름을 입력하고 의미 체계 구성에 사용할 필드를 선택합니다. 검색 가능하고 검색 가능한 문자열 필드만 사용할 수 있습니다. 콘텐츠 필드와 키워드 필드를 우선 순위로 나열해야 합니다.

Azure 포털에서 의미 체계 구성을 만드는 방법을 보여주는 스크린샷입니다.
저장을 선택하여 구성 설정을 저장합니다.
인덱스 페이지에서 다시 저장 을 선택하여 인덱스의 의미 체계 구성을 저장합니다.

인덱스 만들기 또는 업데이트 요청을 작성합니다.

인덱스 정의에 의미 체계 구성을 추가합니다. 예를 들어, scoringProfiles 또는 suggesters 뒤에 추가할 수 있습니다. 기본값을 지정하는 것은 선택 사항이지만 구성이 둘 이상 있는 경우 유용합니다.

"semantic": {
    "defaultConfiguration": "my-semantic-config-default",
    "configurations": [
        {
            "name": "my-semantic-config-default",
            "prioritizedFields": {
                "titleField": {
                    "fieldName": "HotelName"
                },
                "prioritizedContentFields": [
                    {
                        "fieldName": "Description"
                    }
                ],
                "prioritizedKeywordsFields": [
                    {
                        "fieldName": "Tags"
                    }
                ]
            }
        },
                    {
            "name": "my-semantic-config-desc-only",
            "prioritizedFields": {
                "prioritizedContentFields": [
                    {
                        "fieldName": "Description"
                    }
                ]
            }
        }
    ]
}

.NET Azure SDK SemanticConfiguration 클래스 사용합니다.

다음 예제는 Azure SDK 팀에서 작성한 의미 체계 순위 샘플입니다.

string indexName = "hotel";
SearchIndex searchIndex = new(indexName)
{
    Fields =
    {
        new SimpleField("HotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true, IsFacetable = true },
        new SearchableField("HotelName") { IsFilterable = true, IsSortable = true },
        new SearchableField("Description") { IsFilterable = true },
        new SearchableField("Category") { IsFilterable = true, IsSortable = true, IsFacetable = true },
    },
    SemanticSearch = new()
    {
        Configurations =
        {
            new SemanticConfiguration("my-semantic-config", new()
            {
                TitleField = new SemanticField("HotelName"),
                ContentFields =
                {
                    new SemanticField("Description")
                },
                KeywordsFields =
                {
                    new SemanticField("Category")
                }
            })
        }
    }
};

사전 출시 시맨틱 랭킹 모델(프리뷰) 사용 설정

속성을 제공하는 미리 보기 REST API와 미리 보기 Azure SDK를 사용하여, 해당 지역에 사전 릴리스 의미 체계 순위 지정 모델이 배포되어 있는 경우 인덱스가 해당 모델을 사용하도록 선택적으로 구성할 수 있습니다. 시험판이 사용 가능한지 또는 특정 쿼리에서 사용되었는지 여부를 알 수 있는 메커니즘은 없습니다. 이러한 이유로 테스트 환경에서 이 속성을 사용하는 것이 좋으며, 최신 의미 체계 순위 모델을 사용해 보려는 경우에만 사용하는 것이 좋습니다.

구성 속성은 "flightingOptIn": true인덱스의 의미 체계 구성 섹션에 설정됩니다. 속성은 기본적으로 null 또는 false입니다. 언제든지 만들기 또는 업데이트 요청에서 true를 설정할 수 있으며, 쿼리가 속성을 포함하는 의미 체계 구성을 규정한다고 가정하면 앞으로 진행되는 의미 체계 쿼리에 영향을 줍니다.

PUT https://myservice.search.windows.net/indexes('hotels')?allowIndexDowntime=False&api-version=2026-08-01-preview

{
  "name": "hotels",
  "fields": [ ],
  "scoringProfiles": [ ],
  "defaultScoringProfile": "geo",
  "suggesters": [ ],
  "analyzers": [ ],
  "corsOptions": { },
  "encryptionKey": { },
  "similarity": { },
  "semantic": {
    "configurations": [
      {
        "name": "semanticHotels",
        "prioritizedFields": {
          "titleField": {
            "fieldName": "hotelName"
          },
        "prioritizedContentFields": [
            {
              "fieldName": "description"
            },
            {
              "fieldName": "description_fr"
            }
          ],
        "prioritizedKeywordsFields": [
            {
              "fieldName": "tags"
            },
            {
              "fieldName": "category"
            }
          ],
        "flightingOptIn": true
        }
      }
    ]
  },
  "vectorSearch": {  }
}

다음 단계

의미 체계 쿼리를 실행하여 의미 체계 구성을 테스트합니다.

의미 체계 쿼리 만들기

피드백

이 페이지가 도움이 되었나요?

Last updated on 2026-09-22