빠른 시작: 클라이언트 라이브러리 및 REST API를 사용한 엔터티 링크 설정

참조 문서 | 추가 샘플 | 패키지(NuGet) | 라이브러리 소스 코드

이 빠른 시작을 사용하여 .NET용 클라이언트 라이브러리와 애플리케이션을 연결하는 엔터티를 만듭니다. 다음 예에서는 텍스트에서 찾은 엔터티를 식별하고 명확하게 할 수 있는 C# 애플리케이션을 만듭니다.

팁

Language Studio를 사용하여 코드를 작성하지 않고도 Language Service 기능을 사용해 볼 수 있습니다.

필수 조건

• Azure 구독 - 체험 구독 만들기
• Visual Studio IDE

설정

Azure 리소스 만들기

아래 코드 샘플을 사용하려면 Azure 리소스를 배포해야 합니다. 이 리소스에는 Language 서비스에 보내는 API 호출을 인증하는 데 사용할 키와 엔드포인트가 포함됩니다.

1. 다음 링크를 사용하여 Azure Portal에서 Language 리소스를 만듭니다. Azure 구독을 사용하여 로그인해야 합니다.

2. 표시되는 추가 기능 선택 화면에서 계속해서 리소스 만들기를 선택합니다.

   

3. 언어 만들기 화면에서 다음 정보를 제공합니다.

   세부 정보	설명
   Subscription	리소스가 연결되는 구독 계정입니다. 드롭다운 메뉴에서 Azure 구독을 선택합니다.
   Resource group	리소스 그룹은 사용자가 만든 리소스를 저장하는 컨테이너입니다. 새로 만들기를 선택하여 새 리소스 그룹을 만듭니다.
   지역	언어 리소스의 위치입니다. 지역마다 실제 위치에 따라 대기 시간이 발생할 수 있지만 리소스의 런타임 가용성에는 영향을 주지 않습니다. 이 빠른 시작에서는 사용 가능한 가까운 지역을 선택하거나 미국 동부를 선택합니다.
   이름	Language 리소스의 이름입니다. 이 이름은 애플리케이션에서 API 요청을 보내는 데 사용할 엔드포인트 URL을 만드는 데도 사용됩니다.
   가격 책정 계층	언어 리소스에 대한 가격 책정 계층입니다. 무료 F0 계층을 사용하여 서비스를 사용해 보고, 나중에 프로덕션에 대한 유료 계층으로 업그레이드할 수 있습니다.

   

4. 책임 있는 AI 알림 확인란이 선택되어 있는지 확인합니다.

5. 페이지 아래쪽에서 검토 + 만들기를 선택합니다.

6. 표시되는 화면에서 유효성 검사가 통과되었고 정보를 올바르게 입력했는지 확인합니다. 다음으로 만들기를 선택합니다.

키 및 엔드포인트 가져오기

다음으로 애플리케이션을 API에 연결하기 위해 리소스의 키와 엔드포인트가 필요합니다. 키와 엔드포인트는 이 빠른 시작의 뒷부분에서 코드에 붙여넣습니다.

1. Language 리소스가 성공적으로 배포되면 다음 단계 아래에 있는 리소스로 이동 단추를 클릭합니다.

   

2. 리소스에 대한 화면의 왼쪽 탐색 영역 메뉴에서 키 및 엔드포인트를 선택합니다. 아래 단계에서 키와 엔드포인트 중 하나를 사용합니다.

   

환경 변수 만들기

API 요청을 보내려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 이 예제에서는 애플리케이션을 실행하는 로컬 컴퓨터의 환경 변수에 자격 증명을 작성합니다.

팁

코드에 키를 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault와 같은 추가 인증 옵션은 Azure AI 서비스 보안 문서를 참조하세요.

Language 리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다.

1. LANGUAGE_KEY 환경 변수를 설정하려면 your-key를 리소스에 대한 키 중 하나로 바꿉니다.
2. LANGUAGE_ENDPOINT 환경 변수를 설정하려면 your-endpoint를 리소스에 대한 엔드포인트로 바꿉니다.

Windows

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

참고 항목

현재 실행 중인 콘솔에서만 환경 변수에 액세스해야 하는 경우 환경 변수를 setx 대신 set으로 설정할 수 있습니다.

환경 변수가 추가되면 콘솔 창을 포함하여 환경 변수를 읽어야 하는 실행 중인 프로그램을 다시 시작해야 할 수 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

Linux

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

환경 변수를 추가한 후 콘솔 창에서 source ~/.bashrc 명령을 실행하여 변경 내용을 적용합니다.

macOS

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

환경 변수를 추가한 후 콘솔 창에서 source ~/.bash_profile 명령을 실행하여 변경 내용을 적용합니다.

Xcode

iOS 및 macOS 개발의 경우 Xcode에서 환경 변수를 설정합니다. 예를 들어, 다음 단계에 따라 Xcode 13.4.1에서 환경 변수를 설정합니다.

1. 제품>구성표>구성표 편집을 선택합니다.
2. 실행(디버그 실행) 페이지에서 인수를 선택합니다.
3. 환경 변수 아래에서 더하기(+) 기호를 선택하여 새 환경 변수를 추가합니다.
4. 이름에 대해 LANGUAGE_KEY를 입력하고, 값에 대해 Language 리소스 키를 입력합니다.
5. 리소스 엔드포인트에 대해 다음 단계를 수행합니다. 새 환경 변수의 이름을 LANGUAGE_ENDPOINT로 지정합니다.

추가 구성 옵션은 Xcode 설명서를 참조하세요.

새 .NET Core 애플리케이션 만들기

Visual Studio IDE를 사용하여 새 .NET Core 콘솔 앱을 만듭니다. 이렇게 하면 program.cs라는 단일 C# 원본 파일이 포함된 "Hello World" 프로젝트가 생성됩니다.

솔루션 탐색기에서 솔루션을 마우스 오른쪽 단추로 클릭하고 NuGet 패키지 관리를 선택하여 클라이언트 라이브러리를 설치합니다. 열리는 패키지 관리자에서 찾아보기를 선택하고 Azure.AI.TextAnalytics를 검색합니다. 5.2.0 버전, 설치를 차례로 선택합니다. 패키지 관리자 콘솔을 사용할 수도 있습니다.

코드 예

다음 코드를 program.cs 파일에 복사하고 코드를 실행합니다.

using Azure;
using System;
using System.Globalization;
using Azure.AI.TextAnalytics;

namespace EntityLinkingExample
{
    class Program
    {
        // This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
        static string languageKey = Environment.GetEnvironmentVariable("LANGUAGE_KEY");
        static string languageEndpoint = Environment.GetEnvironmentVariable("LANGUAGE_ENDPOINT");

        private static readonly AzureKeyCredential credentials = new AzureKeyCredential(languageKey);
        private static readonly Uri endpoint = new Uri(languageEndpoint);
        
        // Example method for recognizing entities and providing a link to an online data source.
        static void EntityLinkingExample(TextAnalyticsClient client)
        {
            var response = client.RecognizeLinkedEntities(
                "Microsoft was founded by Bill Gates and Paul Allen on April 4, 1975, " +
                "to develop and sell BASIC interpreters for the Altair 8800. " +
                "During his career at Microsoft, Gates held the positions of chairman, " +
                "chief executive officer, president and chief software architect, " +
                "while also being the largest individual shareholder until May 2014.");
            Console.WriteLine("Linked Entities:");
            foreach (var entity in response.Value)
            {
                Console.WriteLine($"\tName: {entity.Name},\tID: {entity.DataSourceEntityId},\tURL: {entity.Url}\tData Source: {entity.DataSource}");
                Console.WriteLine("\tMatches:");
                foreach (var match in entity.Matches)
                {
                    Console.WriteLine($"\t\tText: {match.Text}");
                    Console.WriteLine($"\t\tScore: {match.ConfidenceScore:F2}\n");
                }
            }
        }

        static void Main(string[] args)
        {
            var client = new TextAnalyticsClient(endpoint, credentials);
            EntityLinkingExample(client);

            Console.Write("Press any key to exit.");
            Console.ReadKey();
        }

    }
}

출력

Linked Entities:
    Name: Microsoft,        ID: Microsoft,  URL: https://en.wikipedia.org/wiki/Microsoft    Data Source: Wikipedia
    Matches:
            Text: Microsoft
            Score: 0.55

            Text: Microsoft
            Score: 0.55

    Name: Bill Gates,       ID: Bill Gates, URL: https://en.wikipedia.org/wiki/Bill_Gates   Data Source: Wikipedia
    Matches:
            Text: Bill Gates
            Score: 0.63

            Text: Gates
            Score: 0.63

    Name: Paul Allen,       ID: Paul Allen, URL: https://en.wikipedia.org/wiki/Paul_Allen   Data Source: Wikipedia
    Matches:
            Text: Paul Allen
            Score: 0.60

    Name: April 4,  ID: April 4,    URL: https://en.wikipedia.org/wiki/April_4      Data Source: Wikipedia
    Matches:
            Text: April 4
            Score: 0.32

    Name: BASIC,    ID: BASIC,      URL: https://en.wikipedia.org/wiki/BASIC        Data Source: Wikipedia
    Matches:
            Text: BASIC
            Score: 0.33

    Name: Altair 8800,      ID: Altair 8800,        URL: https://en.wikipedia.org/wiki/Altair_8800  Data Source: Wikipedia
    Matches:
            Text: Altair 8800
            Score: 0.88

리소스 정리

Azure AI 서비스 구독을 정리하고 제거하려면 리소스 또는 리소스 그룹을 삭제할 수 있습니다. 리소스 그룹을 삭제하면 해당 리소스 그룹에 연결된 다른 모든 리소스가 함께 삭제됩니다.

• 포털
• Azure CLI

다음 단계

• 엔터티 링크 설정 언어 지원
• 엔터티 링크 설정 API를 호출하는 방법
• 참조 설명서
• 추가 샘플

참조 문서 | 추가 샘플 | 패키지(Maven) | 라이브러리 소스 코드

이 빠른 시작을 사용하여 Java용 클라이언트 라이브러리와 애플리케이션을 연결하는 엔터티를 만듭니다. 다음 예에서는 텍스트에서 찾은 엔터티를 식별하고 명확하게 할 수 있는 Java 애플리케이션을 만듭니다.

필수 조건

• Azure 구독 - 체험 구독 만들기
• JDK(Java Development Kit) 버전 8 이상

설정

Azure 리소스 만들기

아래 코드 샘플을 사용하려면 Azure 리소스를 배포해야 합니다. 이 리소스에는 Language 서비스에 보내는 API 호출을 인증하는 데 사용할 키와 엔드포인트가 포함됩니다.

1. 다음 링크를 사용하여 Azure Portal에서 Language 리소스를 만듭니다. Azure 구독을 사용하여 로그인해야 합니다.

2. 표시되는 추가 기능 선택 화면에서 계속해서 리소스 만들기를 선택합니다.

   

3. 언어 만들기 화면에서 다음 정보를 제공합니다.

   세부 정보	설명
   Subscription	리소스가 연결되는 구독 계정입니다. 드롭다운 메뉴에서 Azure 구독을 선택합니다.
   Resource group	리소스 그룹은 사용자가 만든 리소스를 저장하는 컨테이너입니다. 새로 만들기를 선택하여 새 리소스 그룹을 만듭니다.
   지역	언어 리소스의 위치입니다. 지역마다 실제 위치에 따라 대기 시간이 발생할 수 있지만 리소스의 런타임 가용성에는 영향을 주지 않습니다. 이 빠른 시작에서는 사용 가능한 가까운 지역을 선택하거나 미국 동부를 선택합니다.
   이름	Language 리소스의 이름입니다. 이 이름은 애플리케이션에서 API 요청을 보내는 데 사용할 엔드포인트 URL을 만드는 데도 사용됩니다.
   가격 책정 계층	언어 리소스에 대한 가격 책정 계층입니다. 무료 F0 계층을 사용하여 서비스를 사용해 보고, 나중에 프로덕션에 대한 유료 계층으로 업그레이드할 수 있습니다.

   

4. 책임 있는 AI 알림 확인란이 선택되어 있는지 확인합니다.

5. 페이지 아래쪽에서 검토 + 만들기를 선택합니다.

6. 표시되는 화면에서 유효성 검사가 통과되었고 정보를 올바르게 입력했는지 확인합니다. 다음으로 만들기를 선택합니다.

키 및 엔드포인트 가져오기

다음으로 애플리케이션을 API에 연결하기 위해 리소스의 키와 엔드포인트가 필요합니다. 키와 엔드포인트는 이 빠른 시작의 뒷부분에서 코드에 붙여넣습니다.

1. Language 리소스가 성공적으로 배포되면 다음 단계 아래에 있는 리소스로 이동 단추를 클릭합니다.

   

2. 리소스에 대한 화면의 왼쪽 탐색 영역 메뉴에서 키 및 엔드포인트를 선택합니다. 아래 단계에서 키와 엔드포인트 중 하나를 사용합니다.

   

환경 변수 만들기

API 요청을 보내려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 이 예제에서는 애플리케이션을 실행하는 로컬 컴퓨터의 환경 변수에 자격 증명을 작성합니다.

팁

코드에 키를 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault와 같은 추가 인증 옵션은 Azure AI 서비스 보안 문서를 참조하세요.

Language 리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다.

1. LANGUAGE_KEY 환경 변수를 설정하려면 your-key를 리소스에 대한 키 중 하나로 바꿉니다.
2. LANGUAGE_ENDPOINT 환경 변수를 설정하려면 your-endpoint를 리소스에 대한 엔드포인트로 바꿉니다.

Windows

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

참고 항목

현재 실행 중인 콘솔에서만 환경 변수에 액세스해야 하는 경우 환경 변수를 setx 대신 set으로 설정할 수 있습니다.

환경 변수가 추가되면 콘솔 창을 포함하여 환경 변수를 읽어야 하는 실행 중인 프로그램을 다시 시작해야 할 수 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

Linux

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

환경 변수를 추가한 후 콘솔 창에서 source ~/.bashrc 명령을 실행하여 변경 내용을 적용합니다.

macOS

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

환경 변수를 추가한 후 콘솔 창에서 source ~/.bash_profile 명령을 실행하여 변경 내용을 적용합니다.

Xcode

iOS 및 macOS 개발의 경우 Xcode에서 환경 변수를 설정합니다. 예를 들어, 다음 단계에 따라 Xcode 13.4.1에서 환경 변수를 설정합니다.

1. 제품>구성표>구성표 편집을 선택합니다.
2. 실행(디버그 실행) 페이지에서 인수를 선택합니다.
3. 환경 변수 아래에서 더하기(+) 기호를 선택하여 새 환경 변수를 추가합니다.
4. 이름에 대해 LANGUAGE_KEY를 입력하고, 값에 대해 Language 리소스 키를 입력합니다.
5. 리소스 엔드포인트에 대해 다음 단계를 수행합니다. 새 환경 변수의 이름을 LANGUAGE_ENDPOINT로 지정합니다.

추가 구성 옵션은 Xcode 설명서를 참조하세요.

클라이언트 라이브러리 추가

선호하는 IDE 또는 개발 환경에서 Maven 프로젝트를 만듭니다. 그런 다음, 프로젝트의 pom.xml 파일에 다음 종속성을 추가합니다. 온라인에서 다른 빌드 도구용 구현 구문을 찾을 수 있습니다.

<dependencies>
     <dependency>
        <groupId>com.azure</groupId>
        <artifactId>azure-ai-textanalytics</artifactId>
        <version>5.2.0</version>
    </dependency>
</dependencies>

코드 예

Example.java라는 Java 파일을 만듭니다. 파일을 열고 아래 코드를 복사합니다. 그런 다음 코드를 실행합니다.

import com.azure.core.credential.AzureKeyCredential;
import com.azure.ai.textanalytics.models.*;
import com.azure.ai.textanalytics.TextAnalyticsClientBuilder;
import com.azure.ai.textanalytics.TextAnalyticsClient;

public class Example {

    // This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
    private static String languageKey = System.getenv("LANGUAGE_KEY");
    private static String languageEndpoint = System.getenv("LANGUAGE_ENDPOINT");

    public static void main(String[] args) {
        TextAnalyticsClient client = authenticateClient(languageKey, languageEndpoint);
        recognizeLinkedEntitiesExample(client);
    }
    // Method to authenticate the client object with your key and endpoint
    static TextAnalyticsClient authenticateClient(String key, String endpoint) {
        return new TextAnalyticsClientBuilder()
                .credential(new AzureKeyCredential(key))
                .endpoint(endpoint)
                .buildClient();
    }
    // Example method for recognizing entities and providing a link to an online data source
    static void recognizeLinkedEntitiesExample(TextAnalyticsClient client)
    {
        // The text that need be analyzed.
        String text = "Microsoft was founded by Bill Gates and Paul Allen on April 4, 1975, " +
                "to develop and sell BASIC interpreters for the Altair 8800. " +
                "During his career at Microsoft, Gates held the positions of chairman, " +
                "chief executive officer, president and chief software architect, " +
                "while also being the largest individual shareholder until May 2014.";

        System.out.printf("Linked Entities:%n");
        for (LinkedEntity linkedEntity : client.recognizeLinkedEntities(text)) {
            System.out.printf("Name: %s, ID: %s, URL: %s, Data Source: %s.%n",
                    linkedEntity.getName(),
                    linkedEntity.getDataSourceEntityId(),
                    linkedEntity.getUrl(),
                    linkedEntity.getDataSource());
            System.out.printf("Matches:%n");
            for (LinkedEntityMatch linkedEntityMatch : linkedEntity.getMatches()) {
                System.out.printf("Text: %s, Score: %.2f, Offset: %s, Length: %s%n",
                        linkedEntityMatch.getText(),
                        linkedEntityMatch.getConfidenceScore(),
                        linkedEntityMatch.getOffset(),
                        linkedEntityMatch.getLength());
            }
        }
    }
}

출력

Linked Entities:

Name: Microsoft, ID: Microsoft, URL: https://en.wikipedia.org/wiki/Microsoft, Data Source: Wikipedia.
Matches:
Text: Microsoft, Score: 0.55, Offset: 0, Length: 9
Text: Microsoft, Score: 0.55, Offset: 150, Length: 9
Name: Bill Gates, ID: Bill Gates, URL: https://en.wikipedia.org/wiki/Bill_Gates, Data Source: Wikipedia.
Matches:
Text: Bill Gates, Score: 0.63, Offset: 25, Length: 10
Text: Gates, Score: 0.63, Offset: 161, Length: 5
Name: Paul Allen, ID: Paul Allen, URL: https://en.wikipedia.org/wiki/Paul_Allen, Data Source: Wikipedia.
Matches:
Text: Paul Allen, Score: 0.60, Offset: 40, Length: 10
Name: April 4, ID: April 4, URL: https://en.wikipedia.org/wiki/April_4, Data Source: Wikipedia.
Matches:
Text: April 4, Score: 0.32, Offset: 54, Length: 7
Name: BASIC, ID: BASIC, URL: https://en.wikipedia.org/wiki/BASIC, Data Source: Wikipedia.
Matches:
Text: BASIC, Score: 0.33, Offset: 89, Length: 5
Name: Altair 8800, ID: Altair 8800, URL: https://en.wikipedia.org/wiki/Altair_8800, Data Source: Wikipedia.
Matches:
Text: Altair 8800, Score: 0.88, Offset: 116, Length: 11

리소스 정리

Azure AI 서비스 구독을 정리하고 제거하려면 리소스 또는 리소스 그룹을 삭제할 수 있습니다. 리소스 그룹을 삭제하면 해당 리소스 그룹에 연결된 다른 모든 리소스가 함께 삭제됩니다.

• 포털
• Azure CLI

다음 단계

• 엔터티 링크 설정 언어 지원
• 엔터티 링크 설정 API를 호출하는 방법
• 참조 설명서 *추가 샘플

참조 설명서 | 추가 샘플 | 패키지(npm) | 라이브러리 소스 코드

이 빠른 시작을 사용하여 Node.js용 클라이언트 라이브러리와 애플리케이션을 연결하는 엔터티를 만듭니다. 다음 예에서는 텍스트에서 찾은 엔터티를 식별하고 명확하게 할 수 있는 JavaScript 애플리케이션을 만듭니다.

필수 조건

• Azure 구독 - 체험 구독 만들기
• Node.js v14 LTS 이상

설정

Azure 리소스 만들기

아래 코드 샘플을 사용하려면 Azure 리소스를 배포해야 합니다. 이 리소스에는 Language 서비스에 보내는 API 호출을 인증하는 데 사용할 키와 엔드포인트가 포함됩니다.

1. 다음 링크를 사용하여 Azure Portal에서 Language 리소스를 만듭니다. Azure 구독을 사용하여 로그인해야 합니다.

2. 표시되는 추가 기능 선택 화면에서 계속해서 리소스 만들기를 선택합니다.

   

3. 언어 만들기 화면에서 다음 정보를 제공합니다.

   세부 정보	설명
   Subscription	리소스가 연결되는 구독 계정입니다. 드롭다운 메뉴에서 Azure 구독을 선택합니다.
   Resource group	리소스 그룹은 사용자가 만든 리소스를 저장하는 컨테이너입니다. 새로 만들기를 선택하여 새 리소스 그룹을 만듭니다.
   지역	언어 리소스의 위치입니다. 지역마다 실제 위치에 따라 대기 시간이 발생할 수 있지만 리소스의 런타임 가용성에는 영향을 주지 않습니다. 이 빠른 시작에서는 사용 가능한 가까운 지역을 선택하거나 미국 동부를 선택합니다.
   이름	Language 리소스의 이름입니다. 이 이름은 애플리케이션에서 API 요청을 보내는 데 사용할 엔드포인트 URL을 만드는 데도 사용됩니다.
   가격 책정 계층	언어 리소스에 대한 가격 책정 계층입니다. 무료 F0 계층을 사용하여 서비스를 사용해 보고, 나중에 프로덕션에 대한 유료 계층으로 업그레이드할 수 있습니다.

   

4. 책임 있는 AI 알림 확인란이 선택되어 있는지 확인합니다.

5. 페이지 아래쪽에서 검토 + 만들기를 선택합니다.

6. 표시되는 화면에서 유효성 검사가 통과되었고 정보를 올바르게 입력했는지 확인합니다. 다음으로 만들기를 선택합니다.

키 및 엔드포인트 가져오기

다음으로 애플리케이션을 API에 연결하기 위해 리소스의 키와 엔드포인트가 필요합니다. 키와 엔드포인트는 이 빠른 시작의 뒷부분에서 코드에 붙여넣습니다.

1. Language 리소스가 성공적으로 배포되면 다음 단계 아래에 있는 리소스로 이동 단추를 클릭합니다.

   

2. 리소스에 대한 화면의 왼쪽 탐색 영역 메뉴에서 키 및 엔드포인트를 선택합니다. 아래 단계에서 키와 엔드포인트 중 하나를 사용합니다.

   

환경 변수 만들기

API 요청을 보내려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 이 예제에서는 애플리케이션을 실행하는 로컬 컴퓨터의 환경 변수에 자격 증명을 작성합니다.

팁

코드에 키를 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault와 같은 추가 인증 옵션은 Azure AI 서비스 보안 문서를 참조하세요.

Language 리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다.

1. LANGUAGE_KEY 환경 변수를 설정하려면 your-key를 리소스에 대한 키 중 하나로 바꿉니다.
2. LANGUAGE_ENDPOINT 환경 변수를 설정하려면 your-endpoint를 리소스에 대한 엔드포인트로 바꿉니다.

Windows

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

참고 항목

현재 실행 중인 콘솔에서만 환경 변수에 액세스해야 하는 경우 환경 변수를 setx 대신 set으로 설정할 수 있습니다.

환경 변수가 추가되면 콘솔 창을 포함하여 환경 변수를 읽어야 하는 실행 중인 프로그램을 다시 시작해야 할 수 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

Linux

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

환경 변수를 추가한 후 콘솔 창에서 source ~/.bashrc 명령을 실행하여 변경 내용을 적용합니다.

macOS

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

환경 변수를 추가한 후 콘솔 창에서 source ~/.bash_profile 명령을 실행하여 변경 내용을 적용합니다.

Xcode

iOS 및 macOS 개발의 경우 Xcode에서 환경 변수를 설정합니다. 예를 들어, 다음 단계에 따라 Xcode 13.4.1에서 환경 변수를 설정합니다.

1. 제품>구성표>구성표 편집을 선택합니다.
2. 실행(디버그 실행) 페이지에서 인수를 선택합니다.
3. 환경 변수 아래에서 더하기(+) 기호를 선택하여 새 환경 변수를 추가합니다.
4. 이름에 대해 LANGUAGE_KEY를 입력하고, 값에 대해 Language 리소스 키를 입력합니다.
5. 리소스 엔드포인트에 대해 다음 단계를 수행합니다. 새 환경 변수의 이름을 LANGUAGE_ENDPOINT로 지정합니다.

추가 구성 옵션은 Xcode 설명서를 참조하세요.

새 Node.js 애플리케이션 만들기

콘솔 창(예: cmd, PowerShell 또는 Bash)에서 앱에 대한 새 디렉터리를 만들고 이 디렉터리로 이동합니다.

mkdir myapp 

cd myapp

package.json 파일을 사용하여 노드 애플리케이션을 만들려면 npm init 명령을 실행합니다.

npm init

클라이언트 라이브러리 설치

npm 패키지를 설치합니다.

npm install @azure/ai-language-text

코드 예

파일을 열고 아래 코드를 복사합니다. 그런 다음 코드를 실행합니다.

"use strict";

const { TextAnalyticsClient, AzureKeyCredential } = require("@azure/ai-text-analytics");

// This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
const key = process.env.LANGUAGE_KEY;
const endpoint = process.env.LANGUAGE_ENDPOINT;

//example sentence for recognizing entities
const documents = ["Microsoft was founded by Bill Gates and Paul Allen on April 4, 1975."];

//example of how to use the client to perform entity linking on a document
async function main() {
    console.log("== Entity linking sample ==");
  
    const client = new TextAnalysisClient(endpoint, new AzureKeyCredential(key));
  
    const results = await client.analyze("EntityLinking", documents);
  
    for (const result of results) {
      console.log(`- Document ${result.id}`);
      if (!result.error) {
        console.log("\tEntities:");
        for (const entity of result.entities) {
          console.log(
            `\t- Entity ${entity.name}; link ${entity.url}; datasource: ${entity.dataSource}`
          );
          console.log("\t\tMatches:");
          for (const match of entity.matches) {
            console.log(
              `\t\t- Entity appears as "${match.text}" (confidence: ${match.confidenceScore}`
            );
          }
        }
      } else {
        console.error("  Error:", result.error);
      }
    }
  }

//call the main function
main().catch((err) => {
  console.error("The sample encountered an error:", err);
});

출력

== Entity linking sample ==
- Document 0
    Entities:
    - Entity Microsoft; link https://en.wikipedia.org/wiki/Microsoft; datasource: Wikipedia
            Matches:
            - Entity appears as "Microsoft" (confidence: 0.48
    - Entity Bill Gates; link https://en.wikipedia.org/wiki/Bill_Gates; datasource: Wikipedia
            Matches:
            - Entity appears as "Bill Gates" (confidence: 0.52
    - Entity Paul Allen; link https://en.wikipedia.org/wiki/Paul_Allen; datasource: Wikipedia
            Matches:
            - Entity appears as "Paul Allen" (confidence: 0.54
    - Entity April 4; link https://en.wikipedia.org/wiki/April_4; datasource: Wikipedia
            Matches:
            - Entity appears as "April 4" (confidence: 0.38

리소스 정리

Azure AI 서비스 구독을 정리하고 제거하려면 리소스 또는 리소스 그룹을 삭제할 수 있습니다. 리소스 그룹을 삭제하면 해당 리소스 그룹에 연결된 다른 모든 리소스가 함께 삭제됩니다.

• 포털
• Azure CLI

다음 단계

• 엔터티 링크 설정 언어 지원
• 엔터티 링크 설정 API를 호출하는 방법
• 참조 설명서
• 추가 샘플

참조 문서 | 추가 샘플 | 패키지(PyPi) | 라이브러리 소스 코드

이 빠른 시작을 사용하여 Python용 클라이언트 라이브러리와 애플리케이션을 연결하는 엔터티를 만듭니다. 다음 예에서는 텍스트에서 찾은 엔터티를 식별하고 명확하게 할 수 있는 Python 애플리케이션을 만듭니다.

필수 조건

• Azure 구독 - 체험 구독 만들기
• Python 3.7 이상

설정

Azure 리소스 만들기

아래 코드 샘플을 사용하려면 Azure 리소스를 배포해야 합니다. 이 리소스에는 Language 서비스에 보내는 API 호출을 인증하는 데 사용할 키와 엔드포인트가 포함됩니다.

1. 다음 링크를 사용하여 Azure Portal에서 Language 리소스를 만듭니다. Azure 구독을 사용하여 로그인해야 합니다.

2. 표시되는 추가 기능 선택 화면에서 계속해서 리소스 만들기를 선택합니다.

   

3. 언어 만들기 화면에서 다음 정보를 제공합니다.

   세부 정보	설명
   Subscription	리소스가 연결되는 구독 계정입니다. 드롭다운 메뉴에서 Azure 구독을 선택합니다.
   Resource group	리소스 그룹은 사용자가 만든 리소스를 저장하는 컨테이너입니다. 새로 만들기를 선택하여 새 리소스 그룹을 만듭니다.
   지역	언어 리소스의 위치입니다. 지역마다 실제 위치에 따라 대기 시간이 발생할 수 있지만 리소스의 런타임 가용성에는 영향을 주지 않습니다. 이 빠른 시작에서는 사용 가능한 가까운 지역을 선택하거나 미국 동부를 선택합니다.
   이름	Language 리소스의 이름입니다. 이 이름은 애플리케이션에서 API 요청을 보내는 데 사용할 엔드포인트 URL을 만드는 데도 사용됩니다.
   가격 책정 계층	언어 리소스에 대한 가격 책정 계층입니다. 무료 F0 계층을 사용하여 서비스를 사용해 보고, 나중에 프로덕션에 대한 유료 계층으로 업그레이드할 수 있습니다.

   

4. 책임 있는 AI 알림 확인란이 선택되어 있는지 확인합니다.

5. 페이지 아래쪽에서 검토 + 만들기를 선택합니다.

6. 표시되는 화면에서 유효성 검사가 통과되었고 정보를 올바르게 입력했는지 확인합니다. 다음으로 만들기를 선택합니다.

키 및 엔드포인트 가져오기

다음으로 애플리케이션을 API에 연결하기 위해 리소스의 키와 엔드포인트가 필요합니다. 키와 엔드포인트는 이 빠른 시작의 뒷부분에서 코드에 붙여넣습니다.

1. Language 리소스가 성공적으로 배포되면 다음 단계 아래에 있는 리소스로 이동 단추를 클릭합니다.

   

2. 리소스에 대한 화면의 왼쪽 탐색 영역 메뉴에서 키 및 엔드포인트를 선택합니다. 아래 단계에서 키와 엔드포인트 중 하나를 사용합니다.

   

환경 변수 만들기

API 요청을 보내려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 이 예제에서는 애플리케이션을 실행하는 로컬 컴퓨터의 환경 변수에 자격 증명을 작성합니다.

팁

코드에 키를 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault와 같은 추가 인증 옵션은 Azure AI 서비스 보안 문서를 참조하세요.

Language 리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다.

1. LANGUAGE_KEY 환경 변수를 설정하려면 your-key를 리소스에 대한 키 중 하나로 바꿉니다.
2. LANGUAGE_ENDPOINT 환경 변수를 설정하려면 your-endpoint를 리소스에 대한 엔드포인트로 바꿉니다.

Windows

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

참고 항목

현재 실행 중인 콘솔에서만 환경 변수에 액세스해야 하는 경우 환경 변수를 setx 대신 set으로 설정할 수 있습니다.

환경 변수가 추가되면 콘솔 창을 포함하여 환경 변수를 읽어야 하는 실행 중인 프로그램을 다시 시작해야 할 수 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

Linux

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

환경 변수를 추가한 후 콘솔 창에서 source ~/.bashrc 명령을 실행하여 변경 내용을 적용합니다.

macOS

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

환경 변수를 추가한 후 콘솔 창에서 source ~/.bash_profile 명령을 실행하여 변경 내용을 적용합니다.

Xcode

iOS 및 macOS 개발의 경우 Xcode에서 환경 변수를 설정합니다. 예를 들어, 다음 단계에 따라 Xcode 13.4.1에서 환경 변수를 설정합니다.

1. 제품>구성표>구성표 편집을 선택합니다.
2. 실행(디버그 실행) 페이지에서 인수를 선택합니다.
3. 환경 변수 아래에서 더하기(+) 기호를 선택하여 새 환경 변수를 추가합니다.
4. 이름에 대해 LANGUAGE_KEY를 입력하고, 값에 대해 Language 리소스 키를 입력합니다.
5. 리소스 엔드포인트에 대해 다음 단계를 수행합니다. 새 환경 변수의 이름을 LANGUAGE_ENDPOINT로 지정합니다.

추가 구성 옵션은 Xcode 설명서를 참조하세요.

클라이언트 라이브러리 설치

Python을 설치한 후, 다음을 사용하여 클라이언트 라이브러리를 설치할 수 있습니다.

pip install azure-ai-textanalytics==5.2.0

코드 예

새 Python 파일을 만들고 아래 코드를 복사합니다. 그런 다음 코드를 실행합니다.

# This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
language_key = os.environ.get('LANGUAGE_KEY')
language_endpoint = os.environ.get('LANGUAGE_ENDPOINT')

from azure.ai.textanalytics import TextAnalyticsClient
from azure.core.credentials import AzureKeyCredential

# Authenticate the client using your key and endpoint. 
def authenticate_client():
    ta_credential = AzureKeyCredential(language_key)
    text_analytics_client = TextAnalyticsClient(
            endpoint=language_endpoint, 
            credential=ta_credential)
    return text_analytics_client

client = authenticate_client()

# Example function for recognizing entities and providing a link to an online data source.
def entity_linking_example(client):

    try:
        documents = ["""Microsoft was founded by Bill Gates and Paul Allen on April 4, 1975, 
        to develop and sell BASIC interpreters for the Altair 8800. 
        During his career at Microsoft, Gates held the positions of chairman,
        chief executive officer, president and chief software architect, 
        while also being the largest individual shareholder until May 2014."""]
        result = client.recognize_linked_entities(documents = documents)[0]

        print("Linked Entities:\n")
        for entity in result.entities:
            print("\tName: ", entity.name, "\tId: ", entity.data_source_entity_id, "\tUrl: ", entity.url,
            "\n\tData Source: ", entity.data_source)
            print("\tMatches:")
            for match in entity.matches:
                print("\t\tText:", match.text)
                print("\t\tConfidence Score: {0:.2f}".format(match.confidence_score))
                print("\t\tOffset: {}".format(match.offset))
                print("\t\tLength: {}".format(match.length))
            
    except Exception as err:
        print("Encountered exception. {}".format(err))
entity_linking_example(client)

출력

Linked Entities:
    
    Name:  Microsoft        Id:  Microsoft  Url:  https://en.wikipedia.org/wiki/Microsoft
    Data Source:  Wikipedia
    Matches:
            Text: Microsoft
            Confidence Score: 0.55
            Offset: 0
            Length: 9
            Text: Microsoft
            Confidence Score: 0.55
            Offset: 168
            Length: 9
    Name:  Bill Gates       Id:  Bill Gates         Url:  https://en.wikipedia.org/wiki/Bill_Gates
    Data Source:  Wikipedia
    Matches:
            Text: Bill Gates
            Confidence Score: 0.63
            Offset: 25
            Length: 10
            Text: Gates
            Confidence Score: 0.63
            Offset: 179
            Length: 5
    Name:  Paul Allen       Id:  Paul Allen         Url:  https://en.wikipedia.org/wiki/Paul_Allen
    Data Source:  Wikipedia
    Matches:
            Text: Paul Allen
            Confidence Score: 0.60
            Offset: 40
            Length: 10
    Name:  April 4  Id:  April 4    Url:  https://en.wikipedia.org/wiki/April_4
    Data Source:  Wikipedia
    Matches:
            Text: BASIC
            Confidence Score: 0.33
            Offset: 98
            Length: 5
    Name:  Altair 8800      Id:  Altair 8800        Url:  https://en.wikipedia.org/wiki/Altair_8800
    Data Source:  Wikipedia
    Matches:
            Text: Altair 8800
            Confidence Score: 0.88
            Offset: 125
            Length: 11

리소스 정리

Azure AI 서비스 구독을 정리하고 제거하려면 리소스 또는 리소스 그룹을 삭제할 수 있습니다. 리소스 그룹을 삭제하면 해당 리소스 그룹에 연결된 다른 모든 리소스가 함께 삭제됩니다.

• 포털
• Azure CLI

다음 단계

• 엔터티 링크 설정 언어 지원
• 엔터티 링크 설정 API를 호출하는 방법
• 참조 설명서
• 추가 샘플

참조 설명서

이 빠른 시작을 통해 REST API를 사용하여 엔터티 연결 요청을 보냅니다. 다음 예제에서는 cURL을 사용하여 텍스트에 있는 엔터티를 식별하고 명확하게 합니다.

필수 조건

• Azure 구독 - 체험 구독 만들기

설정

Azure 리소스 만들기

아래 코드 샘플을 사용하려면 Azure 리소스를 배포해야 합니다. 이 리소스에는 Language 서비스에 보내는 API 호출을 인증하는 데 사용할 키와 엔드포인트가 포함됩니다.

1. 다음 링크를 사용하여 Azure Portal에서 Language 리소스를 만듭니다. Azure 구독을 사용하여 로그인해야 합니다.

2. 표시되는 추가 기능 선택 화면에서 계속해서 리소스 만들기를 선택합니다.

   

3. 언어 만들기 화면에서 다음 정보를 제공합니다.

   세부 정보	설명
   Subscription	리소스가 연결되는 구독 계정입니다. 드롭다운 메뉴에서 Azure 구독을 선택합니다.
   Resource group	리소스 그룹은 사용자가 만든 리소스를 저장하는 컨테이너입니다. 새로 만들기를 선택하여 새 리소스 그룹을 만듭니다.
   지역	언어 리소스의 위치입니다. 지역마다 실제 위치에 따라 대기 시간이 발생할 수 있지만 리소스의 런타임 가용성에는 영향을 주지 않습니다. 이 빠른 시작에서는 사용 가능한 가까운 지역을 선택하거나 미국 동부를 선택합니다.
   이름	Language 리소스의 이름입니다. 이 이름은 애플리케이션에서 API 요청을 보내는 데 사용할 엔드포인트 URL을 만드는 데도 사용됩니다.
   가격 책정 계층	언어 리소스에 대한 가격 책정 계층입니다. 무료 F0 계층을 사용하여 서비스를 사용해 보고, 나중에 프로덕션에 대한 유료 계층으로 업그레이드할 수 있습니다.

   

4. 책임 있는 AI 알림 확인란이 선택되어 있는지 확인합니다.

5. 페이지 아래쪽에서 검토 + 만들기를 선택합니다.

6. 표시되는 화면에서 유효성 검사가 통과되었고 정보를 올바르게 입력했는지 확인합니다. 다음으로 만들기를 선택합니다.

키 및 엔드포인트 가져오기

다음으로 애플리케이션을 API에 연결하기 위해 리소스의 키와 엔드포인트가 필요합니다. 키와 엔드포인트는 이 빠른 시작의 뒷부분에서 코드에 붙여넣습니다.

1. Language 리소스가 성공적으로 배포되면 다음 단계 아래에 있는 리소스로 이동 단추를 클릭합니다.

   

2. 리소스에 대한 화면의 왼쪽 탐색 영역 메뉴에서 키 및 엔드포인트를 선택합니다. 아래 단계에서 키와 엔드포인트 중 하나를 사용합니다.

   

환경 변수 만들기

API 요청을 보내려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 이 예제에서는 애플리케이션을 실행하는 로컬 컴퓨터의 환경 변수에 자격 증명을 작성합니다.

팁

코드에 키를 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault와 같은 추가 인증 옵션은 Azure AI 서비스 보안 문서를 참조하세요.

Language 리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다.

1. LANGUAGE_KEY 환경 변수를 설정하려면 your-key를 리소스에 대한 키 중 하나로 바꿉니다.
2. LANGUAGE_ENDPOINT 환경 변수를 설정하려면 your-endpoint를 리소스에 대한 엔드포인트로 바꿉니다.

Windows

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

참고 항목

현재 실행 중인 콘솔에서만 환경 변수에 액세스해야 하는 경우 환경 변수를 setx 대신 set으로 설정할 수 있습니다.

환경 변수가 추가되면 콘솔 창을 포함하여 환경 변수를 읽어야 하는 실행 중인 프로그램을 다시 시작해야 할 수 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

Linux

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

환경 변수를 추가한 후 콘솔 창에서 source ~/.bashrc 명령을 실행하여 변경 내용을 적용합니다.

macOS

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

환경 변수를 추가한 후 콘솔 창에서 source ~/.bash_profile 명령을 실행하여 변경 내용을 적용합니다.

Xcode

iOS 및 macOS 개발의 경우 Xcode에서 환경 변수를 설정합니다. 예를 들어, 다음 단계에 따라 Xcode 13.4.1에서 환경 변수를 설정합니다.

1. 제품>구성표>구성표 편집을 선택합니다.
2. 실행(디버그 실행) 페이지에서 인수를 선택합니다.
3. 환경 변수 아래에서 더하기(+) 기호를 선택하여 새 환경 변수를 추가합니다.
4. 이름에 대해 LANGUAGE_KEY를 입력하고, 값에 대해 Language 리소스 키를 입력합니다.
5. 리소스 엔드포인트에 대해 다음 단계를 수행합니다. 새 환경 변수의 이름을 LANGUAGE_ENDPOINT로 지정합니다.

추가 구성 옵션은 Xcode 설명서를 참조하세요.

예제 요청 본문을 사용하여 JSON 파일 만들기

코드 편집기에서 test_entitylinking_payload.json이라는 새 파일을 만들고 다음 JSON 예제를 복사합니다. 이 예제 요청은 다음 단계에서 API로 보냅니다.

{
    "kind": "EntityLinking",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "language":"en",
                "text": "Microsoft was founded by Bill Gates and Paul Allen on April 4, 1975."
            }
        ]
    }
}

test_entitylinking_payload.json을 컴퓨터의 어딘가에 저장합니다. 예를 들어 데스크톱입니다.

엔터티 링크 설정 API 요청 보내기

다음 명령을 사용하여 사용하고 있는 프로그램을 사용하여 API 요청을 보냅니다. 명령을 터미널에 복사하고 실행합니다.

parameter	설명
-X POST <endpoint>	API에 액세스하기 위한 엔드포인트를 지정합니다.
-H Content-Type: application/json	JSON 데이터를 보내기 위한 콘텐츠 형식.
-H "Ocp-Apim-Subscription-Key:<key>	API에 액세스하기 위한 키를 지정합니다.
-d <documents>	보내려는 문서가 포함된 JSON.

Windows

C:\Users\<myaccount>\Desktop\test_entitylinking_payload.json을 이전 단계에서 만든 예제 JSON 요청 파일의 위치로 바꿉니다.

명령 프롬프트

curl -X POST "%LANGUAGE_ENDPOINT%/language/:analyze-text?api-version=2022-05-01" ^
-H "Content-Type: application/json" ^
-H "Ocp-Apim-Subscription-Key: %LANGUAGE_KEY%" ^
-d "@C:\Users\<myaccount>\Desktop\test_entitylinking_payload.json"

PowerShell

curl.exe -X POST $env:LANGUAGE_ENDPOINT/language/:analyze-text?api-version=2022-05-01 `
-H "Content-Type: application/json" `
-H "Ocp-Apim-Subscription-Key: $env:LANGUAGE_KEY" `
-d "@C:\Users\<myaccount>\Desktop\test_entitylinking_payload.json"

Linux

다음 명령을 사용하여 사용하고 있는 프로그램을 사용하여 API 요청을 보냅니다. /home/mydir/test_entitylinking_payload.json을 이전 단계에서 만든 예제 JSON 요청 파일의 위치로 바꿉니다.

curl -X POST $LANGUAGE_ENDPOINT/language/:analyze-text?api-version=2022-05-01 \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: $LANGUAGE_KEY" \
-d "@/home/mydir/test_entitylinking_payload.json"

macOS

다음 명령을 사용하여 사용하고 있는 프로그램을 사용하여 API 요청을 보냅니다. /home/mydir/test_sentiment_payload.json을 이전 단계에서 만든 예제 JSON 요청 파일의 위치로 바꿉니다.

curl -X POST $LANGUAGE_ENDPOINT/language/:analyze-text?api-version=2022-05-01 \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: $LANGUAGE_KEY" \
-d "@/home/mydir/test_entitylinking_payload.json"

JSON 응답

{
	"kind": "EntityLinkingResults",
	"results": {
		"documents": [{
			"id": "1",
			"entities": [{
				"bingId": "a093e9b9-90f5-a3d5-c4b8-5855e1b01f85",
				"name": "Microsoft",
				"matches": [{
					"text": "Microsoft",
					"offset": 0,
					"length": 9,
					"confidenceScore": 0.48
				}],
				"language": "en",
				"id": "Microsoft",
				"url": "https://en.wikipedia.org/wiki/Microsoft",
				"dataSource": "Wikipedia"
			}, {
				"bingId": "0d47c987-0042-5576-15e8-97af601614fa",
				"name": "Bill Gates",
				"matches": [{
					"text": "Bill Gates",
					"offset": 25,
					"length": 10,
					"confidenceScore": 0.52
				}],
				"language": "en",
				"id": "Bill Gates",
				"url": "https://en.wikipedia.org/wiki/Bill_Gates",
				"dataSource": "Wikipedia"
			}, {
				"bingId": "df2c4376-9923-6a54-893f-2ee5a5badbc7",
				"name": "Paul Allen",
				"matches": [{
					"text": "Paul Allen",
					"offset": 40,
					"length": 10,
					"confidenceScore": 0.54
				}],
				"language": "en",
				"id": "Paul Allen",
				"url": "https://en.wikipedia.org/wiki/Paul_Allen",
				"dataSource": "Wikipedia"
			}, {
				"bingId": "52535f87-235e-b513-54fe-c03e4233ac6e",
				"name": "April 4",
				"matches": [{
					"text": "April 4",
					"offset": 54,
					"length": 7,
					"confidenceScore": 0.38
				}],
				"language": "en",
				"id": "April 4",
				"url": "https://en.wikipedia.org/wiki/April_4",
				"dataSource": "Wikipedia"
			}],
			"warnings": []
		}],
		"errors": [],
		"modelVersion": "2021-06-01"
	}
}

리소스 정리

Azure AI 서비스 구독을 정리하고 제거하려면 리소스 또는 리소스 그룹을 삭제할 수 있습니다. 리소스 그룹을 삭제하면 해당 리소스 그룹에 연결된 다른 모든 리소스가 함께 삭제됩니다.

• 포털
• Azure CLI

다음 단계

• 엔터티 링크 설정 언어 지원
• 엔터티 링크 설정 API를 호출하는 방법
• 참조 설명서