Azure AI 검색에서 의미 체계 순위 지정자와 스코어링 프로필 사용

메모

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

점수 매기기 프로필이 마지막으로 처리되는 의미상 순위가 지정된 검색 결과에 점수 매기기 프로필을 적용할 수 있습니다.

점수 프로필이 결정 점수를 제공하는지 확인하기 위해 시맨틱 랭커는 시맨틱 랭킹 결과에 점수 프로필 논리를 적용하는 응답 필드인 @search.rerankerBoostedScore를 추가합니다. 레벨 1 순위의 @search.score, 의미 체계 순위의 @search.rerankerScore, 그리고 @search.rerankerBoostedScore를 포함한 검색 결과에서는 @search.rerankerBoostedScore 기준으로 결과를 정렬합니다.

필수 구성 요소

  • Azure AI 검색을(를) 시맨틱 순위를 제공하는 모든 지역에서 사용할 수 있습니다.

  • "rankingOrder": "boostedRerankerScore" 을 지정하는 의미 체계 설정과 기능을 지정하는 채점 프로필을 포함한 검색 인덱스입니다.

제한

의미 체계 순위 결과의 상승은 점수 매기기 프로필 함수에만 적용됩니다. 점수 매기기 프로필이 가중 텍스트 필드로만 구성된 경우에는 상승이 없습니다.

이 동작은 인덱스에 직접 보내는 의미 체계 쿼리에 적용됩니다(예: /docs/search.). 에이전트형 검색은 기본 인덱스의 를 포함하여 defaultScoringProfile을 적용하지 않으며, 검색 응답에는 @search.rerankerBoostedScore가 표시되지 않습니다. 자세한 내용은 검색 인덱스 지식 원본 만들기 및 기술 자료 쿼리를 참조하세요.

점수 매기기 프로필을 사용하는 의미 체계 구성은 어떻게 작동하나요?

점수 매기기 프로필과 연결된 의미 체계 쿼리를 실행하면 검색 결과의 모든 문서에 대해 세 번째 검색 점수 값 @search.rerankerBoostedScore 이 생성됩니다. 기존 재전송 점수에 점수 프로필을 적용하여 계산된 이 향상된 점수는 일반 재랜커 점수와 같은 보장된 범위(0-4)가 없으며 점수는 4보다 훨씬 높을 수 있습니다.

점수 매기기 프로필이 존재하는 경우, 의미 분석 결과는 기본적으로 @search.rerankerBoostedScore에 의해 정렬됩니다. 속성이 rankingOrder 지정되지 않은 경우, 의미 체계 구성에서 BoostedRerankerScore가 기본값입니다.

이 시나리오에서는 점수 매기기 프로필이 두 번 사용됩니다.

  1. 첫째, 인덱스에서 정의된 점수 매기기 프로필은 초기 L1 순위 단계 중에 사용되어 다음과 같은 결과를 향상합니다.

    • 텍스트 기반 쿼리(BM25 또는 RRF)
    • 벡터 쿼리의 텍스트 부분
    • 두 형식을 결합하는 하이브리드 쿼리

  2. 다음으로, 의미 체계 순위는 상위 50개 결과를 다시 점수 매기고, 의미 체계적으로 관련성이 높은 일치 항목을 상위에 승격합니다. 이 단계에서는 점수 매기기 프로필의 이점을 지울 수 있습니다. 예를 들어 새로 고침을 기준으로 부스팅한 경우 의미론적 다시 정렬은 이러한 부스팅을 가장 관련성이 큰 논리로 대체합니다.

  3. 마지막으로, 재정렬 후 점수 매기기 프로필이 다시 적용되어, 부스트의 영향력이 최종 결과 순서에 복원됩니다. 신선도를 높이면 의미상 순위가 매겨진 결과는 신선도에 따라 다시 점수가 매겨집니다.

시맨틱 구성에서 채점 프로필 활성화

의미 체계 순위가 지정된 결과에 대한 점수 프로필을 사용하려면, 의미 체계 구성의 을 설정하여 rankingOrder합니다. PUT 메서드를 사용하여 수정 버전으로 인덱스를 업데이트합니다. 인덱스 다시 작성이 필요하지 않습니다.

PUT https://{service-name}.search.windows.com/indexes/{index-name}?api-version=2026-04-01
{
  "semantic": {
    "configurations": [
      {
        "name": "mySemanticConfig",
        "rankingOrder": "boostedRerankerScore"
      }
    ]
  }
}

의미 체계 구성에서 점수 매기기 프로필 사용 안 함

의미 재정렬 부스팅 점수에 따른 정렬을 옵트아웃하려면 의미 구성에서 rankingOrder 필드를 reRankerScore 값으로 설정합니다.

PUT /indexes/{index-name}?api-version=2026-04-01
{
  "semantic": {
    "configurations": [
      {
        "name": "mySemanticConfig",
        "rankingOrder": "reRankerScore"
      }
    ]
  }
}

정렬을 옵트아웃하는 @search.rerankerBoostedScoreboostedRerankerScore 경우에도 필드는 응답에서 계속 생성되지만 더 이상 결과를 정렬하는 데 사용되지 않습니다.

쿼리 및 응답 예제

점수 매기기 프로필을 지정하는 의미 체계 쿼리 로 시작합니다. 이 쿼리는 rankingOrder이(가) boostedRerankerScore로 설정된 검색 인덱스를 대상으로 합니다.

POST /indexes/{index-name}/docs/search?api-version=2026-04-01
{
  "search": "my query to be boosted",
  "scoringProfile": "myScoringProfile",
  "queryType": "semantic"
}

응답에는 L1 rerankerBoostedScore 및 L2@search.score와 함께 새 @search.rerankerScore항목이 포함됩니다. 결과는 @search.rerankerBoostedScore에 따라 정렬됩니다.

{
  "value": [
    {
      "@search.score": 0.63,
      "@search.rerankerScore": 2.98,
      "@search.rerankerBoostedScore": 7.68,
      "content": "boosted content 2"
    },
    {
      "@search.score": 1.12,
      "@search.rerankerScore": 3.12,
      "@search.rerankerBoostedScore": 5.61,
      "content": "boosted content 1"
    }
  ]
}
  • Last updated on