핵심 구문 추출 인지 능력

메모

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

키프레이즈 추출 스킬은 비구조화된 텍스트를 평가하며, 각 레코드마다 핵심 구문 목록을 반환합니다. 이 기술은 Azure Language in Foundry Tools에서 제공하는 Key Phrase 머신러닝 모델을 사용합니다.

이 기능은 기록의 주요 내용을 빠르게 파악해야 할 때 유용합니다. 예를 들어, 입력 텍스트 "음식은 맛있었고 직원들도 훌륭했습니다"라고 입력하면 서비스는 "음식"과 "훌륭한 직원들"을 반환합니다.

메모

이 기술은 Foundry Tools에 묶여 있으며, 인덱서당 하루 20개를 초과하는 거래에 대해 청구 가능한 자원이 필요합니다. 기본 제공 기술의 실행은 기존 Foundry 도구 표준 가격으로 청구됩니다.

@odata.type

Microsoft.Skills.Text.KeyPhraseExtractionSkill

데이터 제한

레코드의 최대 크기는 로 측정 String.Length하여 50,000자여야 합니다. 키워드 추출기로 보내기 전에 데이터를 분할해야 한다면, 텍스트 분할 스킬을 고려해 보세요. 텍스트 분할 스킬을 사용한다면, 최상의 성능을 위해 페이지 길이를 5000으로 설정하세요.

기술 매개 변수

매개 변수는 대/소문자를 구분합니다.

입력 Description
defaultLanguageCode (선택 사항) 언어 코드를 명시적으로 명시하지 않는 문서에 적용되는 언어 코드입니다. 기본 언어 코드가 지정되어 있지 않으면, 영어(en)가 기본 언어 코드로 사용됩니다.
지원되는 전체 언어 목록을 확인하세요.
maxKeyPhraseCount (선택 사항) 생성해야 할 최대 키워드 수.
modelVersion (선택 사항) 키프레이드 API를 호출할 때 사용할 모델 버전을 지정합니다. 지정하지 않은 경우 기본 사용 가능한 최신 정보로 전환됩니다. 이 값을 꼭 필요하지 않으면 지정하지 않는 것을 권장합니다.

기술 입력

Input Description
text 분석할 텍스트.
languageCode 기록의 언어를 나타내는 문자열. 이 매개변수가 지정되지 않은 경우, 기본 언어 코드를 사용해 레코드를 분석합니다.
지원되는 전체 언어 목록을 확인하세요.

기술 성과

출력 Description
keyPhrases 입력된 텍스트에서 추출한 핵심 구문 목록입니다. 핵심 문구들은 중요도 순서대로 반환됩니다.

샘플 정의

다음 필드를 가진 SQL 레코드를 고려해 봅시다:

{
    "content": "Glaciers are huge rivers of ice that ooze their way over land, powered by gravity and their own sheer weight. They accumulate ice from snowfall and lose it through melting. As global temperatures have risen, many of the world’s glaciers have already started to shrink and retreat. Continued warming could see many iconic landscapes – from the Canadian Rockies to the Mount Everest region of the Himalayas – lose almost all their glaciers by the end of the century.",
    "language": "en"
}

그렇다면 스킬 정의는 다음과 같을 수 있습니다:

 {
    "@odata.type": "#Microsoft.Skills.Text.KeyPhraseExtractionSkill",
    "inputs": [
      {
        "name": "text",
        "source": "/document/content"
      },
      {
        "name": "languageCode",
        "source": "/document/language" 
      }
    ],
    "outputs": [
      {
        "name": "keyPhrases",
        "targetName": "myKeyPhrases"
      }
    ]
  }

샘플 출력

앞서 예시에서는, 스킬의 출력이 우리가 지정한 "document/myKeyPhrases" targetName 라는 새로운 노드에 기록됩니다. 만약 , 를 지정 targetName하지 않는다면 "문서/키어즈"가 됩니다.

document/myKeyPhrases

[
  "world’s glaciers", 
  "huge rivers of ice", 
  "Canadian Rockies", 
  "iconic landscapes",
  "Mount Everest region",
  "Continued warming"
]

"문서/myKeyPhrases"를 다른 기술에 입력하거나 출력 필드 매핑의 출처로 사용할 수 있습니다.

Warnings

지원되지 않는 언어 코드를 제공하면 경고가 발생하고 키워드문이 추출되지 않습니다. 텍스트가 비어 있으면 경고가 표시됩니다. 텍스트가 50,000자를 초과하면 처음 50,000자만 분석되고 경고가 발부됩니다.

참고하십시오