Aracılığıyla paylaş

Hızlı Başlangıç: İstemci kitaplığını ve REST API'yi kullanarak Varlık Bağlama

  • Makale

Başvuru belgeleri | Diğer örnekler | Paket (NuGet) | Kitaplık kaynak kodu

.NET için istemci kitaplığıyla bir varlık bağlama uygulaması oluşturmak için bu hızlı başlangıcı kullanın. Aşağıdaki örnekte, metinde bulunan varlıkları tanımlayıp ayırabilen bir C# uygulaması oluşturursunuz.

İpucu

Kod yazmaya gerek kalmadan Dil hizmeti özelliklerini denemek için Language Studio'yu kullanabilirsiniz.

Önkoşullar

Ayarlama

Azure kaynağı oluşturma

Aşağıdaki kod örneğini kullanmak için bir Azure kaynağı dağıtmanız gerekir. Bu kaynak, Dil hizmetine gönderdiğiniz API çağrılarının kimliğini doğrulamak için kullanacağınız bir anahtar ve uç nokta içerir.

  1. Azure portalını kullanarak dil kaynağı oluşturmak için aşağıdaki bağlantıyı kullanın. Azure aboneliğinizi kullanarak oturum açmanız gerekir.

  2. Görüntülenen Ek özellikleri seçin ekranında Devam'ı seçerek kaynağınızı oluşturun.

    Azure portalında ek özellik seçeneklerini gösteren ekran görüntüsü.

  3. Dil oluştur ekranında aşağıdaki bilgileri sağlayın:

    Ayrıntı Açıklama
    Abonelik Kaynağınızın ilişkilendirileceği abonelik hesabı. Açılan menüden Azure aboneliğinizi seçin.
    Kaynak grubu Kaynak grubu, oluşturduğunuz kaynakları depolayan bir kapsayıcıdır. Yeni kaynak grubu oluşturmak için Yeni oluştur'u seçin.
    Bölge Dil kaynağınızın konumu. Fiziksel konumunuza bağlı olarak farklı bölgeler gecikmeye neden olabilir, ancak kaynağınızın çalışma zamanı kullanılabilirliğini etkilemez. Bu hızlı başlangıç için yakınınızda kullanılabilir bir bölge seçin veya Doğu ABD'yi seçin.
    Veri Akışı Adı Dil kaynağınızın adı. Bu ad, uygulamalarınızın API istekleri göndermek için kullanacağı bir uç nokta URL'si oluşturmak için de kullanılır.
    Fiyatlandırma katmanı Dil kaynağınızın fiyatlandırma katmanı. Ücretsiz F0 katmanını kullanarak hizmeti deneyebilir ve daha sonra üretim için ücretli bir katmana yükseltebilirsiniz.

    Azure portalında kaynak oluşturma ayrıntılarını gösteren ekran görüntüsü.

  4. Sorumlu Yapay Zeka Bildirimi onay kutusunun işaretli olduğundan emin olun.

  5. Sayfanın alt kısmındaki Gözden Geçir + Oluştur'u seçin.

  6. Görüntülenen ekranda doğrulamanın geçtiğinden ve bilgilerinizi doğru girdiğinizden emin olun. Daha sonra, Oluştur'u seçin.

Anahtarınızı ve uç noktanızı alma

Ardından uygulamanızı API'ye bağlamak için kaynağın anahtarına ve uç noktasına ihtiyacınız olacak. Anahtarınızı ve uç noktanızı hızlı başlangıcın ilerleyen bölümlerinde koda yapıştıracaksınız.

  1. Dil kaynağı başarıyla dağıtıldıktan sonra, Sonraki Adımlar'ın altındaki Kaynağa Git düğmesine tıklayın.

    Kaynak dağıtıldıktan sonraki adımları gösteren ekran görüntüsü.

  2. Kaynağınızın ekranında, sol gezinti menüsünde Anahtarlar ve uç nokta'yı seçin. Aşağıdaki adımlarda anahtarlarınızdan birini ve uç noktanızı kullanacaksınız.

    Bir kaynağın anahtarları ve uç nokta bölümünü gösteren ekran görüntüsü.

Ortam değişkenlerini oluşturma

API istekleri göndermek için uygulamanızın kimliği doğrulanmalıdır. Üretim için kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Bu örnekte, kimlik bilgilerinizi uygulamayı çalıştıran yerel makinedeki ortam değişkenlerine yazacaksınız.

İpucu

Anahtarı doğrudan kodunuz içinde eklemeyin ve asla herkese açık olarak göndermeyin. Azure Key Vault gibi daha fazla kimlik doğrulama seçeneği için Azure AI hizmetleri güvenlik makalesine bakın.

Dil kaynak anahtarınızın ortam değişkenini ayarlamak için bir konsol penceresi açın ve işletim sisteminiz ve geliştirme ortamınıza yönelik yönergeleri izleyin.

  1. Ortam değişkenini LANGUAGE_KEY ayarlamak için değerini kaynağınızın anahtarlarından biriyle değiştirin your-key .
  2. Ortam değişkenini LANGUAGE_ENDPOINT ayarlamak için değerini kaynağınızın uç noktasıyla değiştirin your-endpoint .
setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Not

Yalnızca geçerli çalışan konsoldaki ortam değişkenlerine erişmeniz gerekiyorsa, ortam değişkenini yerine setxile set ayarlayabilirsiniz.

Ortam değişkenlerini ekledikten sonra, konsol penceresi de dahil olmak üzere ortam değişkenlerini okuması gereken tüm çalışan programları yeniden başlatmanız gerekebilir. Örneğin, düzenleyici olarak Visual Studio kullanıyorsanız, örneği çalıştırmadan önce Visual Studio'yu yeniden başlatın.

Yeni .NET Core uygulaması oluşturma

Visual Studio IDE’yi kullanarak yeni bir .NET Core konsol uygulaması oluşturun. Bu, tek bir C# kaynak dosyasıyla (program.cs) “Merhaba Dünya” adında bir proje oluşturur.

Çözüm Gezgini’nde çözüme sağ tıklayarak ve NuGet paketlerini yönet seçeneğini belirleyerek istemci kitaplığını yükleyin. Açılan paket yöneticisinde Gözat'ı seçin ve öğesini arayınAzure.AI.TextAnalytics. Sürüm olarak 5.2.0 seçin ve Yükle seçeneğini belirleyin. Paket Yöneticisi Konsolu’nu da kullanabilirsiniz.

Kod örneği

Aşağıdaki kodu program.cs dosyanıza kopyalayın ve kodu çalıştırın.

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();
        }

    }
}

Çıktı

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

Kaynakları temizleme

Azure AI hizmetleri aboneliğini temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler.

Sonraki adımlar

Başvuru belgeleri | Diğer örnekler | Paket (Maven) | Kitaplık kaynak kodu

Java için istemci kitaplığıyla uygulama bağlayan bir varlık oluşturmak için bu hızlı başlangıcı kullanın. Aşağıdaki örnekte, metinde bulunan varlıkları tanımlayıp ayırabilen bir Java uygulaması oluşturursunuz.

Önkoşullar

Ayarlama

Azure kaynağı oluşturma

Aşağıdaki kod örneğini kullanmak için bir Azure kaynağı dağıtmanız gerekir. Bu kaynak, Dil hizmetine gönderdiğiniz API çağrılarının kimliğini doğrulamak için kullanacağınız bir anahtar ve uç nokta içerir.

  1. Azure portalını kullanarak dil kaynağı oluşturmak için aşağıdaki bağlantıyı kullanın. Azure aboneliğinizi kullanarak oturum açmanız gerekir.

  2. Görüntülenen Ek özellikleri seçin ekranında Devam'ı seçerek kaynağınızı oluşturun.

    Azure portalında ek özellik seçeneklerini gösteren ekran görüntüsü.

  3. Dil oluştur ekranında aşağıdaki bilgileri sağlayın:

    Ayrıntı Açıklama
    Abonelik Kaynağınızın ilişkilendirileceği abonelik hesabı. Açılan menüden Azure aboneliğinizi seçin.
    Kaynak grubu Kaynak grubu, oluşturduğunuz kaynakları depolayan bir kapsayıcıdır. Yeni kaynak grubu oluşturmak için Yeni oluştur'u seçin.
    Bölge Dil kaynağınızın konumu. Fiziksel konumunuza bağlı olarak farklı bölgeler gecikmeye neden olabilir, ancak kaynağınızın çalışma zamanı kullanılabilirliğini etkilemez. Bu hızlı başlangıç için yakınınızda kullanılabilir bir bölge seçin veya Doğu ABD'yi seçin.
    Veri Akışı Adı Dil kaynağınızın adı. Bu ad, uygulamalarınızın API istekleri göndermek için kullanacağı bir uç nokta URL'si oluşturmak için de kullanılır.
    Fiyatlandırma katmanı Dil kaynağınızın fiyatlandırma katmanı. Ücretsiz F0 katmanını kullanarak hizmeti deneyebilir ve daha sonra üretim için ücretli bir katmana yükseltebilirsiniz.

    Azure portalında kaynak oluşturma ayrıntılarını gösteren ekran görüntüsü.

  4. Sorumlu Yapay Zeka Bildirimi onay kutusunun işaretli olduğundan emin olun.

  5. Sayfanın alt kısmındaki Gözden Geçir + Oluştur'u seçin.

  6. Görüntülenen ekranda doğrulamanın geçtiğinden ve bilgilerinizi doğru girdiğinizden emin olun. Daha sonra, Oluştur'u seçin.

Anahtarınızı ve uç noktanızı alma

Ardından uygulamanızı API'ye bağlamak için kaynağın anahtarına ve uç noktasına ihtiyacınız olacak. Anahtarınızı ve uç noktanızı hızlı başlangıcın ilerleyen bölümlerinde koda yapıştıracaksınız.

  1. Dil kaynağı başarıyla dağıtıldıktan sonra, Sonraki Adımlar'ın altındaki Kaynağa Git düğmesine tıklayın.

    Kaynak dağıtıldıktan sonraki adımları gösteren ekran görüntüsü.

  2. Kaynağınızın ekranında, sol gezinti menüsünde Anahtarlar ve uç nokta'yı seçin. Aşağıdaki adımlarda anahtarlarınızdan birini ve uç noktanızı kullanacaksınız.

    Bir kaynağın anahtarları ve uç nokta bölümünü gösteren ekran görüntüsü.

Ortam değişkenlerini oluşturma

API istekleri göndermek için uygulamanızın kimliği doğrulanmalıdır. Üretim için kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Bu örnekte, kimlik bilgilerinizi uygulamayı çalıştıran yerel makinedeki ortam değişkenlerine yazacaksınız.

İpucu

Anahtarı doğrudan kodunuz içinde eklemeyin ve asla herkese açık olarak göndermeyin. Azure Key Vault gibi daha fazla kimlik doğrulama seçeneği için Azure AI hizmetleri güvenlik makalesine bakın.

Dil kaynak anahtarınızın ortam değişkenini ayarlamak için bir konsol penceresi açın ve işletim sisteminiz ve geliştirme ortamınıza yönelik yönergeleri izleyin.

  1. Ortam değişkenini LANGUAGE_KEY ayarlamak için değerini kaynağınızın anahtarlarından biriyle değiştirin your-key .
  2. Ortam değişkenini LANGUAGE_ENDPOINT ayarlamak için değerini kaynağınızın uç noktasıyla değiştirin your-endpoint .
setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Not

Yalnızca geçerli çalışan konsoldaki ortam değişkenlerine erişmeniz gerekiyorsa, ortam değişkenini yerine setxile set ayarlayabilirsiniz.

Ortam değişkenlerini ekledikten sonra, konsol penceresi de dahil olmak üzere ortam değişkenlerini okuması gereken tüm çalışan programları yeniden başlatmanız gerekebilir. Örneğin, düzenleyici olarak Visual Studio kullanıyorsanız, örneği çalıştırmadan önce Visual Studio'yu yeniden başlatın.

İstemci kitaplığını ekleme

Tercih ettiğiniz IDE veya geliştirme ortamında bir Maven projesi oluşturun. Ardından aşağıdaki bağımlılığı projenizin pom.xml dosyasına ekleyin. Diğer derleme araçlarına yönelik uygulama söz dizimini çevrimiçi olarak bulabilirsiniz.

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

Kod örneği

Example.java adlı bir Java dosyası oluşturun. Dosyayı açın ve aşağıdaki kodu kopyalayın. Sonra kodu çalıştırın.

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());
            }
        }
    }
}

Çıktı

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

Kaynakları temizleme

Azure AI hizmetleri aboneliğini temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler.

Sonraki adımlar

Başvuru belgeleri | Diğer örnekler | Paket (npm) | Kitaplık kaynak kodu

Node.js için istemci kitaplığıyla bir varlık bağlama uygulaması oluşturmak için bu hızlı başlangıcı kullanın. Aşağıdaki örnekte, metinde bulunan varlıkları tanımlayıp ayırabilen bir JavaScript uygulaması oluşturursunuz.

Önkoşullar

Ayarlama

Azure kaynağı oluşturma

Aşağıdaki kod örneğini kullanmak için bir Azure kaynağı dağıtmanız gerekir. Bu kaynak, Dil hizmetine gönderdiğiniz API çağrılarının kimliğini doğrulamak için kullanacağınız bir anahtar ve uç nokta içerir.

  1. Azure portalını kullanarak dil kaynağı oluşturmak için aşağıdaki bağlantıyı kullanın. Azure aboneliğinizi kullanarak oturum açmanız gerekir.

  2. Görüntülenen Ek özellikleri seçin ekranında Devam'ı seçerek kaynağınızı oluşturun.

    Azure portalında ek özellik seçeneklerini gösteren ekran görüntüsü.

  3. Dil oluştur ekranında aşağıdaki bilgileri sağlayın:

    Ayrıntı Açıklama
    Abonelik Kaynağınızın ilişkilendirileceği abonelik hesabı. Açılan menüden Azure aboneliğinizi seçin.
    Kaynak grubu Kaynak grubu, oluşturduğunuz kaynakları depolayan bir kapsayıcıdır. Yeni kaynak grubu oluşturmak için Yeni oluştur'u seçin.
    Bölge Dil kaynağınızın konumu. Fiziksel konumunuza bağlı olarak farklı bölgeler gecikmeye neden olabilir, ancak kaynağınızın çalışma zamanı kullanılabilirliğini etkilemez. Bu hızlı başlangıç için yakınınızda kullanılabilir bir bölge seçin veya Doğu ABD'yi seçin.
    Veri Akışı Adı Dil kaynağınızın adı. Bu ad, uygulamalarınızın API istekleri göndermek için kullanacağı bir uç nokta URL'si oluşturmak için de kullanılır.
    Fiyatlandırma katmanı Dil kaynağınızın fiyatlandırma katmanı. Ücretsiz F0 katmanını kullanarak hizmeti deneyebilir ve daha sonra üretim için ücretli bir katmana yükseltebilirsiniz.

    Azure portalında kaynak oluşturma ayrıntılarını gösteren ekran görüntüsü.

  4. Sorumlu Yapay Zeka Bildirimi onay kutusunun işaretli olduğundan emin olun.

  5. Sayfanın alt kısmındaki Gözden Geçir + Oluştur'u seçin.

  6. Görüntülenen ekranda doğrulamanın geçtiğinden ve bilgilerinizi doğru girdiğinizden emin olun. Daha sonra, Oluştur'u seçin.

Anahtarınızı ve uç noktanızı alma

Ardından uygulamanızı API'ye bağlamak için kaynağın anahtarına ve uç noktasına ihtiyacınız olacak. Anahtarınızı ve uç noktanızı hızlı başlangıcın ilerleyen bölümlerinde koda yapıştıracaksınız.

  1. Dil kaynağı başarıyla dağıtıldıktan sonra, Sonraki Adımlar'ın altındaki Kaynağa Git düğmesine tıklayın.

    Kaynak dağıtıldıktan sonraki adımları gösteren ekran görüntüsü.

  2. Kaynağınızın ekranında, sol gezinti menüsünde Anahtarlar ve uç nokta'yı seçin. Aşağıdaki adımlarda anahtarlarınızdan birini ve uç noktanızı kullanacaksınız.

    Bir kaynağın anahtarları ve uç nokta bölümünü gösteren ekran görüntüsü.

Ortam değişkenlerini oluşturma

API istekleri göndermek için uygulamanızın kimliği doğrulanmalıdır. Üretim için kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Bu örnekte, kimlik bilgilerinizi uygulamayı çalıştıran yerel makinedeki ortam değişkenlerine yazacaksınız.

İpucu

Anahtarı doğrudan kodunuz içinde eklemeyin ve asla herkese açık olarak göndermeyin. Azure Key Vault gibi daha fazla kimlik doğrulama seçeneği için Azure AI hizmetleri güvenlik makalesine bakın.

Dil kaynak anahtarınızın ortam değişkenini ayarlamak için bir konsol penceresi açın ve işletim sisteminiz ve geliştirme ortamınıza yönelik yönergeleri izleyin.

  1. Ortam değişkenini LANGUAGE_KEY ayarlamak için değerini kaynağınızın anahtarlarından biriyle değiştirin your-key .
  2. Ortam değişkenini LANGUAGE_ENDPOINT ayarlamak için değerini kaynağınızın uç noktasıyla değiştirin your-endpoint .
setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Not

Yalnızca geçerli çalışan konsoldaki ortam değişkenlerine erişmeniz gerekiyorsa, ortam değişkenini yerine setxile set ayarlayabilirsiniz.

Ortam değişkenlerini ekledikten sonra, konsol penceresi de dahil olmak üzere ortam değişkenlerini okuması gereken tüm çalışan programları yeniden başlatmanız gerekebilir. Örneğin, düzenleyici olarak Visual Studio kullanıyorsanız, örneği çalıştırmadan önce Visual Studio'yu yeniden başlatın.

Yeni bir Node.js uygulaması oluşturma

Konsol penceresinde (cmd, PowerShell veya Bash gibi), uygulamanız için yeni bir dizin oluşturun ve bu dizine gidin.

mkdir myapp 

cd myapp

Bir package.json dosyası ile bir düğüm uygulaması oluşturmak için npm init komutunu çalıştırın.

npm init

İstemci kitaplığını yükleme

npm paketini yükleyin:

npm install @azure/ai-language-text

Kod örneği

Dosyayı açın ve aşağıdaki kodu kopyalayın. Sonra kodu çalıştırın.

"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);
});

Çıktı

== 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

Kaynakları temizleme

Azure AI hizmetleri aboneliğini temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler.

Sonraki adımlar

Başvuru belgeleri | Diğer örnekler | Paket (PyPi) | Kitaplık kaynak kodu

Python için istemci kitaplığıyla uygulama bağlayan bir varlık oluşturmak için bu hızlı başlangıcı kullanın. Aşağıdaki örnekte, metinde bulunan varlıkları tanımlayıp ayırabilen bir Python uygulaması oluşturursunuz.

Önkoşullar

Ayarlama

Azure kaynağı oluşturma

Aşağıdaki kod örneğini kullanmak için bir Azure kaynağı dağıtmanız gerekir. Bu kaynak, Dil hizmetine gönderdiğiniz API çağrılarının kimliğini doğrulamak için kullanacağınız bir anahtar ve uç nokta içerir.

  1. Azure portalını kullanarak dil kaynağı oluşturmak için aşağıdaki bağlantıyı kullanın. Azure aboneliğinizi kullanarak oturum açmanız gerekir.

  2. Görüntülenen Ek özellikleri seçin ekranında Devam'ı seçerek kaynağınızı oluşturun.

    Azure portalında ek özellik seçeneklerini gösteren ekran görüntüsü.

  3. Dil oluştur ekranında aşağıdaki bilgileri sağlayın:

    Ayrıntı Açıklama
    Abonelik Kaynağınızın ilişkilendirileceği abonelik hesabı. Açılan menüden Azure aboneliğinizi seçin.
    Kaynak grubu Kaynak grubu, oluşturduğunuz kaynakları depolayan bir kapsayıcıdır. Yeni kaynak grubu oluşturmak için Yeni oluştur'u seçin.
    Bölge Dil kaynağınızın konumu. Fiziksel konumunuza bağlı olarak farklı bölgeler gecikmeye neden olabilir, ancak kaynağınızın çalışma zamanı kullanılabilirliğini etkilemez. Bu hızlı başlangıç için yakınınızda kullanılabilir bir bölge seçin veya Doğu ABD'yi seçin.
    Veri Akışı Adı Dil kaynağınızın adı. Bu ad, uygulamalarınızın API istekleri göndermek için kullanacağı bir uç nokta URL'si oluşturmak için de kullanılır.
    Fiyatlandırma katmanı Dil kaynağınızın fiyatlandırma katmanı. Ücretsiz F0 katmanını kullanarak hizmeti deneyebilir ve daha sonra üretim için ücretli bir katmana yükseltebilirsiniz.

    Azure portalında kaynak oluşturma ayrıntılarını gösteren ekran görüntüsü.

  4. Sorumlu Yapay Zeka Bildirimi onay kutusunun işaretli olduğundan emin olun.

  5. Sayfanın alt kısmındaki Gözden Geçir + Oluştur'u seçin.

  6. Görüntülenen ekranda doğrulamanın geçtiğinden ve bilgilerinizi doğru girdiğinizden emin olun. Daha sonra, Oluştur'u seçin.

Anahtarınızı ve uç noktanızı alma

Ardından uygulamanızı API'ye bağlamak için kaynağın anahtarına ve uç noktasına ihtiyacınız olacak. Anahtarınızı ve uç noktanızı hızlı başlangıcın ilerleyen bölümlerinde koda yapıştıracaksınız.

  1. Dil kaynağı başarıyla dağıtıldıktan sonra, Sonraki Adımlar'ın altındaki Kaynağa Git düğmesine tıklayın.

    Kaynak dağıtıldıktan sonraki adımları gösteren ekran görüntüsü.

  2. Kaynağınızın ekranında, sol gezinti menüsünde Anahtarlar ve uç nokta'yı seçin. Aşağıdaki adımlarda anahtarlarınızdan birini ve uç noktanızı kullanacaksınız.

    Bir kaynağın anahtarları ve uç nokta bölümünü gösteren ekran görüntüsü.

Ortam değişkenlerini oluşturma

API istekleri göndermek için uygulamanızın kimliği doğrulanmalıdır. Üretim için kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Bu örnekte, kimlik bilgilerinizi uygulamayı çalıştıran yerel makinedeki ortam değişkenlerine yazacaksınız.

İpucu

Anahtarı doğrudan kodunuz içinde eklemeyin ve asla herkese açık olarak göndermeyin. Azure Key Vault gibi daha fazla kimlik doğrulama seçeneği için Azure AI hizmetleri güvenlik makalesine bakın.

Dil kaynak anahtarınızın ortam değişkenini ayarlamak için bir konsol penceresi açın ve işletim sisteminiz ve geliştirme ortamınıza yönelik yönergeleri izleyin.

  1. Ortam değişkenini LANGUAGE_KEY ayarlamak için değerini kaynağınızın anahtarlarından biriyle değiştirin your-key .
  2. Ortam değişkenini LANGUAGE_ENDPOINT ayarlamak için değerini kaynağınızın uç noktasıyla değiştirin your-endpoint .
setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Not

Yalnızca geçerli çalışan konsoldaki ortam değişkenlerine erişmeniz gerekiyorsa, ortam değişkenini yerine setxile set ayarlayabilirsiniz.

Ortam değişkenlerini ekledikten sonra, konsol penceresi de dahil olmak üzere ortam değişkenlerini okuması gereken tüm çalışan programları yeniden başlatmanız gerekebilir. Örneğin, düzenleyici olarak Visual Studio kullanıyorsanız, örneği çalıştırmadan önce Visual Studio'yu yeniden başlatın.

İstemci kitaplığını yükleme

Python yükledikten sonra şunları kullanarak istemci kitaplığını yükleyebilirsiniz:

pip install azure-ai-textanalytics==5.2.0

Kod örneği

Yeni bir Python dosyası oluşturun ve aşağıdaki kodu kopyalayın. Sonra kodu çalıştırın.

# 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)

Çıktı

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

Kaynakları temizleme

Azure AI hizmetleri aboneliğini temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler.

Sonraki adımlar

Başvuru belgeleri

REST API kullanarak varlık bağlama istekleri göndermek için bu hızlı başlangıcı kullanın. Aşağıdaki örnekte, cURL kullanarak metinde bulunan varlıkları tanımlayacak ve azaltacaksınız.

Önkoşullar

Ayarlama

Azure kaynağı oluşturma

Aşağıdaki kod örneğini kullanmak için bir Azure kaynağı dağıtmanız gerekir. Bu kaynak, Dil hizmetine gönderdiğiniz API çağrılarının kimliğini doğrulamak için kullanacağınız bir anahtar ve uç nokta içerir.

  1. Azure portalını kullanarak dil kaynağı oluşturmak için aşağıdaki bağlantıyı kullanın. Azure aboneliğinizi kullanarak oturum açmanız gerekir.

  2. Görüntülenen Ek özellikleri seçin ekranında Devam'ı seçerek kaynağınızı oluşturun.

    Azure portalında ek özellik seçeneklerini gösteren ekran görüntüsü.

  3. Dil oluştur ekranında aşağıdaki bilgileri sağlayın:

    Ayrıntı Açıklama
    Abonelik Kaynağınızın ilişkilendirileceği abonelik hesabı. Açılan menüden Azure aboneliğinizi seçin.
    Kaynak grubu Kaynak grubu, oluşturduğunuz kaynakları depolayan bir kapsayıcıdır. Yeni kaynak grubu oluşturmak için Yeni oluştur'u seçin.
    Bölge Dil kaynağınızın konumu. Fiziksel konumunuza bağlı olarak farklı bölgeler gecikmeye neden olabilir, ancak kaynağınızın çalışma zamanı kullanılabilirliğini etkilemez. Bu hızlı başlangıç için yakınınızda kullanılabilir bir bölge seçin veya Doğu ABD'yi seçin.
    Veri Akışı Adı Dil kaynağınızın adı. Bu ad, uygulamalarınızın API istekleri göndermek için kullanacağı bir uç nokta URL'si oluşturmak için de kullanılır.
    Fiyatlandırma katmanı Dil kaynağınızın fiyatlandırma katmanı. Ücretsiz F0 katmanını kullanarak hizmeti deneyebilir ve daha sonra üretim için ücretli bir katmana yükseltebilirsiniz.

    Azure portalında kaynak oluşturma ayrıntılarını gösteren ekran görüntüsü.

  4. Sorumlu Yapay Zeka Bildirimi onay kutusunun işaretli olduğundan emin olun.

  5. Sayfanın alt kısmındaki Gözden Geçir + Oluştur'u seçin.

  6. Görüntülenen ekranda doğrulamanın geçtiğinden ve bilgilerinizi doğru girdiğinizden emin olun. Daha sonra, Oluştur'u seçin.

Anahtarınızı ve uç noktanızı alma

Ardından uygulamanızı API'ye bağlamak için kaynağın anahtarına ve uç noktasına ihtiyacınız olacak. Anahtarınızı ve uç noktanızı hızlı başlangıcın ilerleyen bölümlerinde koda yapıştıracaksınız.

  1. Dil kaynağı başarıyla dağıtıldıktan sonra, Sonraki Adımlar'ın altındaki Kaynağa Git düğmesine tıklayın.

    Kaynak dağıtıldıktan sonraki adımları gösteren ekran görüntüsü.

  2. Kaynağınızın ekranında, sol gezinti menüsünde Anahtarlar ve uç nokta'yı seçin. Aşağıdaki adımlarda anahtarlarınızdan birini ve uç noktanızı kullanacaksınız.

    Bir kaynağın anahtarları ve uç nokta bölümünü gösteren ekran görüntüsü.

Ortam değişkenlerini oluşturma

API istekleri göndermek için uygulamanızın kimliği doğrulanmalıdır. Üretim için kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Bu örnekte, kimlik bilgilerinizi uygulamayı çalıştıran yerel makinedeki ortam değişkenlerine yazacaksınız.

İpucu

Anahtarı doğrudan kodunuz içinde eklemeyin ve asla herkese açık olarak göndermeyin. Azure Key Vault gibi daha fazla kimlik doğrulama seçeneği için Azure AI hizmetleri güvenlik makalesine bakın.

Dil kaynak anahtarınızın ortam değişkenini ayarlamak için bir konsol penceresi açın ve işletim sisteminiz ve geliştirme ortamınıza yönelik yönergeleri izleyin.

  1. Ortam değişkenini LANGUAGE_KEY ayarlamak için değerini kaynağınızın anahtarlarından biriyle değiştirin your-key .
  2. Ortam değişkenini LANGUAGE_ENDPOINT ayarlamak için değerini kaynağınızın uç noktasıyla değiştirin your-endpoint .
setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Not

Yalnızca geçerli çalışan konsoldaki ortam değişkenlerine erişmeniz gerekiyorsa, ortam değişkenini yerine setxile set ayarlayabilirsiniz.

Ortam değişkenlerini ekledikten sonra, konsol penceresi de dahil olmak üzere ortam değişkenlerini okuması gereken tüm çalışan programları yeniden başlatmanız gerekebilir. Örneğin, düzenleyici olarak Visual Studio kullanıyorsanız, örneği çalıştırmadan önce Visual Studio'yu yeniden başlatın.

Örnek istek gövdesiyle bir JSON dosyası oluşturma

Kod düzenleyicisinde adlı test_entitylinking_payload.json yeni bir dosya oluşturun ve aşağıdaki JSON örneğini kopyalayın. Bu örnek istek, sonraki adımda API'ye gönderilecektir.

{
    "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."
            }
        ]
    }
}

Bilgisayarınızda bir yere kaydedin test_entitylinking_payload.json . Örneğin, masaüstünüz.

Api'yi bağlayan bir varlık isteği gönderme

Kullandığınız programı kullanarak API isteği göndermek için aşağıdaki komutları kullanın. Komutunu terminalinize kopyalayın ve çalıştırın.

parametre Açıklama
-X POST <endpoint> API'ye erişmek için uç noktanızı belirtir.
-H Content-Type: application/json JSON verilerini göndermek için içerik türü.
-H "Ocp-Apim-Subscription-Key:<key> API'ye erişmek için anahtarı belirtir.
-d <documents> Göndermek istediğiniz belgeleri içeren JSON.

değerini önceki adımda oluşturduğunuz örnek JSON istek dosyasının konumuyla değiştirin C:\Users\<myaccount>\Desktop\test_entitylinking_payload.json .

Komut istemi

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"

JSON yanıtı

{
	"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"
	}
}

Kaynakları temizleme

Azure AI hizmetleri aboneliğini temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler.

Sonraki adımlar