최신 버전의 Azure AI 언어로 마이그레이션

  • 아티클

팁

Azure AI 언어를 이제 막 시작했나요? 현재 버전의 API에 대한 자세한 내용은 서비스, 사용 가능한 기능 및 빠른 시작 링크에 대한 개요 문서를 참조하세요.

애플리케이션에서 여전히 Text Analytics API 또는 클라이언트 라이브러리(안정적인 v5.1.0 이전)를 사용하는 경우 이 문서를 통해 최신 버전의 Azure AI 언어 기능을 사용하도록 애플리케이션을 업그레이드할 수 있습니다.

통합 언어 엔드포인트(REST API)

이 섹션은 REST API 호출에 이전 /text/analytics/... 엔드포인트 형식을 사용하는 애플리케이션에 적용됩니다. 예시:

https://<your-custom-subdomain>.cognitiveservices.azure.com/text/analytics/<version>/<feature>

애플리케이션에서 위의 엔드포인트 형식을 사용하는 경우 다음 언어 서비스 기능에 대한 REST API 엔드포인트가 변경되었습니다.

이제 언어 서비스는 REST API 요청을 이러한 기능으로 보내기 위한 통합 엔드포인트를 제공합니다. 애플리케이션에서 REST API를 사용하는 경우 해당 요청 엔드포인트를 업데이트하여 현재 엔드포인트를 사용합니다.

https://<your-language-resource-endpoint>/language/:analyze-text?api-version=2022-05-01

또한 JSON 요청 본문의 형식이 변경되었습니다. 애플리케이션이 API에 보내는 요청 구조를 업데이트해야 합니다(예: 다음 엔터티 인식 JSON 본문).

{
    "kind": "EntityRecognition",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "language": "en",
                "text": "I had a wonderful trip to Seattle last week."
            }
        ]
    }
}

위에 연결된 빠른 시작을 사용하여 사용 중인 기능 및 연결된 API 출력에 대한 현재 예제 REST API 호출을 확인합니다.

클라이언트 라이브러리

최신 버전의 클라이언트 라이브러리를 사용하려면 Azure.AI.TextAnalytics 네임스페이스에서 최신 소프트웨어 패키지를 다운로드해야 합니다. 클라이언트 라이브러리를 선호하는 언어로 사용하기 위한 예제 코드 및 지침은 위에 연결된 빠른 시작 문서를 참조하세요.

버전 2.1 기능 변경

API v2.1에서 애플리케이션을 마이그레이션하는 경우 알아야 할 기능에 대한 몇 가지 변경 사항이 있습니다.

감정 분석 v2.1

버전 2.1의 감정 분석은 API에 전송된 각 문서에 대해 0~1 사이의 감정 점수를 반환하며, 점수가 1에 가까울수록 더 긍정적인 감정을 나타냅니다. 이 기능의 현재 버전에서는 문장과 문서 전체에 대한 감정 레이블(예: "긍정적" 또는 "부정적")과 관련된 신뢰도 점수를 반환합니다.

NER, PII 및 엔터티 링크 v2.1

버전 2.1에서 Text Analytics API는 NER(명명된 엔터티 인식) 및 엔터티 링크 설정에 대해 하나의 엔드포인트를 사용합니다. 이 기능의 현재 버전은 확장된 명명된 엔터티 검색을 제공하고 NER 및 엔터티 연결 요청에 대해 별도의 엔드포인트를 가지고 있습니다. 또한 언어 서비스에서 제공되는 다른 기능을 사용하여 개인(PII) 및 상태(PHI) 정보를 검색할 수 있습니다.

또한 API의 응답에서 반환된 엔터티 범주를 사용하려면 애플리케이션을 업데이트해야 합니다.

버전 2.1 엔터티 범주

다음 표에는 NER v2.1에 대해 반환된 엔터티 범주가 나열되어 있습니다.

범주 설명
Person 사용자의 이름.
위치 자연 및 인간이 만든 랜드마크, 구조, 지리적 기능 및 지정학적 엔터티입니다.
조직 회사, 정치 그룹, 음악 밴드, 스포츠 클럽, 정부 기관, 공공 단체. 국적 및 종교는 이 엔터티 형식에 포함되지 않습니다.
PhoneNumber 전화 번호(미국과 유럽 전화 번호만 해당).
메일 이메일 주소.
URL 웹 사이트에 대한 URL입니다.
IP 네트워크 IP 주소.
DateTime 날짜 및 하루 중 시간.
날짜 달력 날짜.
Time 하루 중 시간
DateRange 날짜 범위
TimeRange 시간 범위.
기간 기간
Set 반복 횟수를 설정합니다.
수량 숫자 및 숫자 수량.
숫자 숫자
백분율 백분율.
서수 서수 번호.
나이 나이.
통화 통화.
차원 차원 및 측정.
온도 온도.

언어 감지 v2.1

언어 감지 기능 출력이 현재 버전에서 변경되었습니다. JSON 응답에는 score 대신 ConfidenceScore가 포함됩니다. 또한 현재 버전은 각 문서에 대해 하나의 언어만 반환합니다.

핵심 구 추출 v2.1

핵심 구 추출 기능이 현재 엔드포인트 및 요청 형식의 외부에서 변경되지 않았습니다.

참고 항목