Hızlı başlangıç: Azure Yönetim istemci kitaplığını kullanarak bilişsel hizmetler kaynağı oluşturma

Azure Yönetim istemci kitaplığını kullanarak Azure bilişsel hizmetler kaynaklarını oluşturmak ve yönetmek için bu hızlı başlangıcı kullanın.

Azure bilişsel hizmetler, geliştiricilerin uygulamalarına bilişsel zeka bilgileri oluşturmalarına yardımcı olacak REST API 'Ler ve istemci kitaplıkları içeren bir bulut tabanlı hizmetler ailesidir. Geliştiricilere, başarılı olmak için doğrudan yapay zeka (AI) veya veri bilimi becerileri veya bilgi gerekmez. Azure bilişsel hizmetler, geliştiricilerin kendi uygulamalarına kolayca bilişsel özellikler eklemesine, duymasına, konuşmasına, anlamasına ve hatta başlayabilmesine olanak tanıyan bilişsel çözümler sunar.

Tekil AI Hizmetleri, Azure aboneliğinizde oluşturduğunuz Azure kaynakları tarafından temsil edilir. Bir kaynak oluşturduktan sonra, uygulamalarınızın kimliğini doğrulamak için oluşturulan anahtarları ve uç noktayı kullanabilirsiniz.

Başvuru belgeleri | Kitaplık kaynak kodu | Paket (NuGet) | Örnekler

C# önkoşulları

  • Geçerli bir Azure aboneliği - Ücretsiz bir abonelik oluşturun.
  • .NET Core'un geçerli sürümü.
  • Hüküm ve koşulları gözden geçirmek ve onaylamak için Azure portal ilk yüzünüzü, Metin Analizi veya Görüntü İşleme kaynaklarınızı oluşturmanız gerekir. Bunu şu şekilde yapabilirsiniz: yüz, metin analizi, görüntü işleme. Bundan sonra, aynı Azure aboneliği altında herhangi bir dağıtım aracını (SDK, CLı veya ARM şablonu vb.) kullanarak sonraki kaynakları oluşturabilirsiniz.

Azure hizmet sorumlusu oluşturma

Uygulamanızın Azure hesabınızla etkileşime geçmesini sağlamak için izinleri yönetmek üzere bir Azure hizmet sorumlusu gerekir. Azure hizmet sorumlusu oluşturmabölümündeki yönergeleri izleyin.

Bir hizmet sorumlusu oluşturduğunuzda gizli bir değer, bir KIMLIK ve bir uygulama KIMLIĞI olduğunu görürsünüz. Sonraki adımlar için uygulama KIMLIĞI ve gizli anahtarı geçici bir konuma kaydedin.

Kaynak grubu oluşturma

Bilişsel hizmetler kaynağı oluşturmadan önce, hesabınızın kaynağı içermesi için bir Azure Kaynak grubu olması gerekir. Henüz bir kaynak grubunuz yoksa devam etmeden önce Azure Portal bir tane oluşturun.

Yeni bir C# uygulaması oluşturma

Yeni bir .NET Core uygulaması oluşturun. Konsol penceresinde (cmd, PowerShell veya Bash gibi) komutunu kullanarak adıyla dotnet new yeni bir konsol uygulaması azure-management-quickstart oluşturun. Bu komut, tek bir kaynak Merhaba Dünya basit bir "Merhaba Dünya" C# projesi oluşturur: program.cs.

dotnet new console -n azure-management-quickstart

Dizininizi yeni oluşturulan uygulama klasörüyle değiştirme. Uygulamayı şu şekilde derlemek için:

dotnet build

Derleme çıkışında uyarı veya hata içermesi gerekir.

...
Build succeeded.
 0 Warning(s)
 0 Error(s)
...

İstemci kitaplığını yükleme

Uygulama dizininde aşağıdaki komutla .NET için Azure Yönetim istemci kitaplığını yükleyin:

dotnet add package Microsoft.Azure.Management.CognitiveServices
dotnet add package Microsoft.Azure.Management.Fluent
dotnet add package Microsoft.Azure.Management.ResourceManager.Fluent

Visual Studio IDE kullanıyorsanız, istemci kitaplığı indirilebilir bir NuGet paketi olarak kullanılabilir.

Kitaplıkları içeri aktarma

program.cs dosyasını açın ve using dosyanın en üstüne aşağıdaki deyimlerini ekleyin:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.Azure.Management.Fluent;
using Microsoft.Azure.Management.ResourceManager.Fluent;
using Microsoft.Azure.Management.ResourceManager.Fluent.Authentication;
using Microsoft.Azure.Management.CognitiveServices;
using Microsoft.Azure.Management.CognitiveServices.Models;

İstemcinin kimliğini doğrulama

Aşağıdaki alanları program.cs köküne ekleyin ve oluşturduğunuz hizmet sorumlusu ve Azure hesap bilgilerini kullanarak değerlerini doldurun.

const string  service_principal_application_id = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
const string  service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
const string  subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
const string  tenant_id = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
const string  resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names. */
const string subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Ardından Main yönteminde bu değerleri kullanarak bir CognitiveServicesManagementClient nesnesi oluşturun. Bu nesne tüm Azure yönetim işlemleriniz için gereklidir.

var service_principal_credentials = new ServicePrincipalLoginInformation ();
service_principal_credentials.ClientId = service_principal_application_id;
service_principal_credentials.ClientSecret = service_principal_secret;

var credentials = SdkContext.AzureCredentialsFactory.FromServicePrincipal(service_principal_application_id, service_principal_secret, tenant_id, AzureEnvironment.AzureGlobalCloud);
var client = new CognitiveServicesManagementClient(credentials);
client.SubscriptionId = subscription_id;

Çağrı yönetimi yöntemleri

Kullanılabilir kaynakları listeleyen, örnek bir kaynak oluşturmak, sahip olunan kaynakları listeleyen ve örnek kaynağı silmek için Main yönteminize aşağıdaki kodu ekleyin. Sonraki adımlarda bu yöntemleri tanımlayacağız.

    // Uncomment to list all available resource kinds, SKUs, and locations for your Azure account:
    //list_available_kinds_skus_locations(client);

    // Create a resource with kind TextTranslation, F0 (free tier), location global.
    create_resource(client, "test_resource", "TextTranslation", "F0", "Global");

    // List all resources for your Azure account and resource group:
    list_resources(client);

    // Delete the resource.
    delete_resource(client, "test_resource");

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

Bilişsel Hizmetler kaynağı oluşturma (C#)

Yeni bir Bilişsel Hizmetler kaynağı oluşturmak ve bu kaynağa abone olmak için Create yöntemini kullanın. Bu yöntem, geçiş yapılan kaynak grubuna yeni bir faturalanabilir kaynak ekler. Yeni kaynağınızı oluştururken, fiyatlandırma katmanı (veya SKU) ve Azure konumuyla birlikte kullanmak istediğiniz hizmet türü hakkında bilginiz olması gerekir. Aşağıdaki yöntem bunların hepsini bağımsız değişken olarak alır ve bir kaynak oluşturur.

static void create_resource(CognitiveServicesManagementClient client, string resource_name, string kind, string account_tier, string location)
{
    Console.WriteLine("Creating resource: " + resource_name + "...");
    /* NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
    property from CognitiveServicesAccountProperties. */
    CognitiveServicesAccount parameters = 
        new CognitiveServicesAccount(null, null, kind, location, resource_name, new CognitiveServicesAccountProperties(customSubDomainName : subdomain_name), new Sku(account_tier));
    var result = client.Accounts.Create(resource_group_name, account_tier, parameters);
    Console.WriteLine("Resource created.");
    Console.WriteLine("ID: " + result.Id);
    Console.WriteLine("Kind: " + result.Kind);
    Console.WriteLine();
}

Hizmet ve fiyatlandırma katmanı seçme

Yeni bir kaynak oluşturdukta, kullanmak istediğiniz fiyatlandırma katmanı (veya SKU) ile birlikte kullanmak istediğiniz "hizmet türü" hakkında bilginiz olması gerekir. Kaynağı oluştururken bunu ve diğer bilgileri parametre olarak kullanıcaz. Betiğinde aşağıdaki yöntemi çağırarak kullanılabilir Bilişsel Hizmet "türleri" listesini bulabilirsiniz:

static void list_available_kinds_skus_locations(CognitiveServicesManagementClient client)
{

    Console.WriteLine("Available SKUs:");
    var result = client.ResourceSkus.List();
    Console.WriteLine("Kind\tSKU Name\tSKU Tier\tLocations");
    foreach (var x in result) {
        var locations = "";
        foreach (var region in x.Locations)
        {
            locations += region;
        }
        Console.WriteLine(x.Kind + "\t" + x.Name + "\t" + x.Tier + "\t" + locations);
    };
}

Azure bilişsel hizmetler 'e iki farklı kaynak aracılığıyla erişebilirsiniz: çok sunuculu bir kaynak veya tek hizmet bir.

  • Çoklu hizmet kaynağı:
    • Birden çok Azure bilişsel hizmete tek bir anahtar ve uç nokta ile erişin.
    • Kullandığınız hizmetlerden faturalandırmayı birleştirir.
  • Tek hizmet kaynağı:
    • Oluşturulan her hizmet için benzersiz bir anahtar ve uç nokta ile tek bir Azure bilişsel hizmete erişin.
    • Hizmeti denemek için ücretsiz katmanı kullanın.

Aşağıdaki SKU 'ların ve fiyatlandırma bilgilerinin listesine bakın.

Çoklu hizmet

Hizmet Tip
Birden çok hizmet. Daha fazla bilgi için fiyatlandırma sayfasına bakın. CognitiveServices

Görsel

Hizmet Tip
Görüntü İşleme ComputerVision
Özel Görüntü İşleme tahmin CustomVision.Prediction
Özel Görüntü İşleme-eğitim CustomVision.Training
Yüz Face
Form Tanıma FormRecognizer

Konuşma

Hizmet Tip
Konuşma Hizmetleri SpeechServices
Konuşma Tanıma SpeakerRecognition

Dil

Hizmet Tip
LUIS LUIS
Soru-Cevap Oluşturucu QnAMaker
Metin Analizi TextAnalytics
Metin Çevirisi TextTranslation

Karar

Hizmet Tip
Anomali Algılayıcısı AnomalyDetector
Content Moderator ContentModerator
Kişiselleştirme Personalizer

Fiyatlandırma katmanları ve faturalandırma

Fiyatlandırma katmanları (ve faturalandırılan miktar), kimlik doğrulama bilgilerinizi kullanarak göndereceğiniz işlem sayısına bağlıdır. Her fiyatlandırma katmanı şunları belirtir:

  • saniye başına izin verilen en fazla işlem sayısı (TPS).
  • fiyatlandırma katmanında etkinleştirilen hizmet özellikleri.
  • önceden tanımlı işlem sayısı için maliyet. Bu sayının üzerine gitmek, hizmetinize ilişkin fiyatlandırma ayrıntılarında belirtilen ek ücret oluşmasına neden olur.

Not

Bilişsel hizmetlerin birçoğu hizmeti denemek için kullanabileceğiniz ücretsiz bir katmana sahiptir. Ücretsiz katmanı kullanmak için, F0 kaynağınız IÇIN SKU olarak kullanın.

Kaynaklarınızı görüntüleme

Azure hesabınız altındaki tüm kaynakları (tüm kaynak grupları genelinde) görüntülemek için aşağıdaki yöntemi kullanın:

static void list_resources(CognitiveServicesManagementClient client)
{
    Console.WriteLine("Resources in resource group: " + resource_group_name);
    var result = client.Accounts.ListByResourceGroup(resource_group_name);
    foreach (var x in result)
    {
        Console.WriteLine("ID: " + x.Id);
        Console.WriteLine("Name: " + x.Name);
        Console.WriteLine("Type: " + x.Type);
        Console.WriteLine("Kind: " + x.Kind);
        Console.WriteLine();
    }
}

Kaynağı silme

Aşağıdaki yöntem belirtilen kaynağı verilen kaynak grubundan siler.

static void delete_resource(CognitiveServicesManagementClient client, string resource_name)
{
    Console.WriteLine("Deleting resource: " + resource_name + "...");
    client.Accounts.Delete (resource_group_name, resource_name);

    Console.WriteLine("Resource deleted.");
    Console.WriteLine();
}

Silinen bir kaynağı kurtarmanız gerekirse bkz. Silinen Bilişsel Hizmetler kaynaklarını kurtarma.

Uygulamayı çalıştırma

komutunu kullanarak uygulamayı uygulama dizininize dotnet run çalıştırın.

dotnet run

Ayrıca bkz.

Başvuru belgeleri | Kitaplık kaynak kodu | Paket (Maven)

Java önkoşulları

Azure hizmet sorumlusu oluşturma

Uygulamanızın Azure hesabınızla etkileşime geçmesini sağlamak için izinleri yönetmek üzere bir Azure hizmet sorumlusu gerekir. Azure hizmet sorumlusu oluşturmabölümündeki yönergeleri izleyin.

Bir hizmet sorumlusu oluşturduğunuzda gizli bir değer, bir KIMLIK ve bir uygulama KIMLIĞI olduğunu görürsünüz. Sonraki adımlar için uygulama KIMLIĞI ve gizli anahtarı geçici bir konuma kaydedin.

Kaynak grubu oluşturma

Bilişsel hizmetler kaynağı oluşturmadan önce, hesabınızın kaynağı içermesi için bir Azure Kaynak grubu olması gerekir. Henüz bir kaynak grubunuz yoksa devam etmeden önce Azure Portal bir tane oluşturun.

Yeni bir Java uygulaması oluşturma

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

mkdir myapp && cd myapp

Komutunu gradle init çalışma dizinden çalıştırın. Bu komut, çalışma zamanında uygulama oluşturmak ve yapılandırmak için kullanılan build.gradle.kts dahil olmak üzere Gradle için temel derleme dosyaları oluşturacak.

gradle init --type basic

DSL seçmeniz istendiğinde Kotlin'i seçin.

Çalışma dizininize aşağıdaki komutu çalıştırın:

mkdir -p src/main/java

İstemci kitaplığını yükleme

Bu hızlı başlangıçta Gradle bağımlılık yöneticisi 2. İstemci kitaplığını ve diğer bağımlılık yöneticilerine ilişkin bilgileri Maven Merkezi Deposu'nda bulabilirsiniz.

Projenizin build.gradle.kts dosyasında, gerekli eklentilerin ve ayarların yanı sıra bir deyimi olarak implementation istemci kitaplığını da dahil edin.

plugins {
    java
    application
}
application {
    mainClass.set("FormRecognizer")
}
repositories {
    mavenCentral()
}
dependencies {
    implementation(group = "com.microsoft.azure", name = "azure-mgmt-cognitiveservices", version = "1.10.0-beta")
}

Kitaplıkları içeri aktarma

Yeni src/main/java klasörüne gidin ve Management.java adlı bir dosya oluşturun. Tercih ettiğiniz düzenleyicide veya IDE'de açın ve aşağıdaki import deyimlerini ekleyin:

import com.microsoft.azure.*;
import com.microsoft.azure.arm.resources.Region;
import com.microsoft.azure.credentials.*;
import com.microsoft.azure.management.cognitiveservices.v2017_04_18.*;
import com.microsoft.azure.management.cognitiveservices.v2017_04_18.implementation.*;

import java.io.*;
import java.lang.Object.*;
import java.util.*;
import java.net.*;

İstemcinin kimliğini doğrulama

Management.java içine bir sınıf ekleyin ve ardından içine aşağıdaki alanları ve değerlerini ekleyin. Oluşturduğunuz hizmet sorumlularını ve diğer Azure hesap bilgilerini kullanarak değerlerini doldurmak.

/*
Be sure to use the service pricipal application ID, not simply the ID. 
*/
private static String applicationId = "INSERT APPLICATION ID HERE";
private static String applicationSecret = "INSERT APPLICATION SECRET HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
private static String subscriptionId = "INSERT SUBSCRIPTION ID HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
private static String tenantId = "INSERT TENANT ID HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
private static String resourceGroupName = "INSERT RESOURCE GROUP NAME HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names. */
private static String subDomainName = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Ardından, main yönteminde bu değerleri kullanarak bir CognitiveServicesManager nesnesi oluşturun. Bu nesne tüm Azure yönetim işlemleriniz için gereklidir.

ApplicationTokenCredentials credentials = new ApplicationTokenCredentials(applicationId, tenantId, applicationSecret, AzureEnvironment.AZURE);

CognitiveServicesManager client = CognitiveServicesManager.authenticate(credentials, subscriptionId);

Çağrı yönetimi yöntemleri

Kullanılabilir kaynakları listeleyen, örnek bir kaynak oluşturmak, sahip olunan kaynakları listeleyen ve ardından örnek kaynağı silmek için Main yönteminize aşağıdaki kodu ekleyin. Sonraki adımlarda bu yöntemleri tanımlayacağız.

// Uncomment to list all available resource kinds, SKUs, and locations for your Azure account.
// list_available_kinds_skus_locations (client);

// Create a resource with kind Text Translation, SKU F0 (free tier), location global.
String resourceId = create_resource (client, "test_resource", resourceGroupName, "TextAnalytics", "F0", Region.US_WEST);

// list all resources for your Azure account.
list_resources (client);

// Delete the resource.
delete_resource (client, resourceId);

Bilişsel Hizmetler kaynağı oluşturma (Java)

Yeni bir Bilişsel Hizmetler kaynağı oluşturmak ve bu kaynağa abone olmak için create yöntemini kullanın. Bu yöntem, geçiştirilen kaynak grubuna yeni bir faturalanabilir kaynak ekler. Yeni kaynağınızı oluştururken, fiyatlandırma katmanı (veya SKU) ve Azure konumuyla birlikte kullanmak istediğiniz hizmet türü hakkında bilginiz olması gerekir. Aşağıdaki yöntem bunların hepsini bağımsız değişken olarak alır ve bir kaynak oluşturur.

    public static String create_resource (CognitiveServicesManager client, String resourceName, String resourceGroupName, String kind, String skuName, Region region) {
        System.out.println ("Creating resource: " + resourceName + "...");

/* NOTE If you do not want to use a custom subdomain name, remove the withCustomSubDomainName
setter from the CognitiveServicesAccountProperties object. */
        CognitiveServicesAccount result = client.accounts().define(resourceName)
            .withRegion(region)
            .withExistingResourceGroup(resourceGroupName)
            .withKind(kind)
            .withSku(new Sku().withName(skuName))
            .withProperties(new CognitiveServicesAccountProperties().withCustomSubDomainName(subDomainName))
            .create();

        System.out.println ("Resource created.");
        System.out.println ("ID: " + result.id());
        System.out.println ("Provisioning state: " + result.properties().provisioningState().toString());
        System.out.println ();

        return result.id();
    }

Hizmet ve fiyatlandırma katmanı seçme

Yeni bir kaynak oluşturdukta, kullanmak istediğiniz fiyatlandırma katmanı (veya SKU) ile birlikte kullanmak istediğiniz "hizmet türü" hakkında bilginiz olması gerekir. Kaynağı oluştururken bunu ve diğer bilgileri parametre olarak kullanıcaz. Aşağıdaki yöntemi çağırarak kullanılabilir Bilişsel Hizmet "türleri" listesini bulabilirsiniz:

public static void list_available_kinds_skus_locations (CognitiveServicesManager client) {
    System.out.println ("Available SKUs:");
    System.out.println("Kind\tSKU Name\tSKU Tier\tLocations");
    ResourceSkus skus = client.resourceSkus();
    // See https://github.com/ReactiveX/RxJava/wiki/Blocking-Observable-Operators
    for (ResourceSku sku : skus.listAsync().toBlocking().toIterable()) {
        String locations = String.join (",", sku.locations());
        System.out.println (sku.kind() + "\t" + sku.name() + "\t" + sku.tier() + "\t" + locations);
    }
}

Azure bilişsel hizmetler 'e iki farklı kaynak aracılığıyla erişebilirsiniz: çok sunuculu bir kaynak veya tek hizmet bir.

  • Çoklu hizmet kaynağı:
    • Birden çok Azure bilişsel hizmete tek bir anahtar ve uç nokta ile erişin.
    • Kullandığınız hizmetlerden faturalandırmayı birleştirir.
  • Tek hizmet kaynağı:
    • Oluşturulan her hizmet için benzersiz bir anahtar ve uç nokta ile tek bir Azure bilişsel hizmete erişin.
    • Hizmeti denemek için ücretsiz katmanı kullanın.

Aşağıdaki SKU 'ların ve fiyatlandırma bilgilerinin listesine bakın.

Çoklu hizmet

Hizmet Tip
Birden çok hizmet. Daha fazla bilgi için fiyatlandırma sayfasına bakın. CognitiveServices

Görsel

Hizmet Tip
Görüntü İşleme ComputerVision
Özel Görüntü İşleme tahmin CustomVision.Prediction
Özel Görüntü İşleme-eğitim CustomVision.Training
Yüz Face
Form Tanıma FormRecognizer

Konuşma

Hizmet Tip
Konuşma Hizmetleri SpeechServices
Konuşma Tanıma SpeakerRecognition

Dil

Hizmet Tip
LUIS LUIS
Soru-Cevap Oluşturucu QnAMaker
Metin Analizi TextAnalytics
Metin Çevirisi TextTranslation

Karar

Hizmet Tip
Anomali Algılayıcısı AnomalyDetector
Content Moderator ContentModerator
Kişiselleştirme Personalizer

Fiyatlandırma katmanları ve faturalandırma

Fiyatlandırma katmanları (ve faturalandırılan miktar), kimlik doğrulama bilgilerinizi kullanarak göndereceğiniz işlem sayısına bağlıdır. Her fiyatlandırma katmanı şunları belirtir:

  • saniye başına izin verilen en fazla işlem sayısı (TPS).
  • fiyatlandırma katmanında etkinleştirilen hizmet özellikleri.
  • önceden tanımlı işlem sayısı için maliyet. Bu sayının üzerine gitmek, hizmetinize ilişkin fiyatlandırma ayrıntılarında belirtilen ek ücret oluşmasına neden olur.

Not

Bilişsel hizmetlerin birçoğu hizmeti denemek için kullanabileceğiniz ücretsiz bir katmana sahiptir. Ücretsiz katmanı kullanmak için, F0 kaynağınız IÇIN SKU olarak kullanın.

Kaynaklarınızı görüntüleme

Azure hesabınız altındaki tüm kaynakları (tüm kaynak grupları genelinde) görüntülemek için aşağıdaki yöntemi kullanın:

public static void list_resources (CognitiveServicesManager client) {
    System.out.println ("Resources in resource group: " + resourceGroupName);
    // Note Azure resources are also sometimes referred to as accounts.
    Accounts accounts = client.accounts();
    for (CognitiveServicesAccount account : accounts.listByResourceGroupAsync(resourceGroupName).toBlocking().toIterable()) {
        System.out.println ("Kind: " + account.kind ());
        System.out.println ("SKU Name: " + account.sku().name());
        System.out.println ();
    }
}

Kaynağı silme

Aşağıdaki yöntem belirtilen kaynağı verilen kaynak grubundan siler.

public static void delete_resource (CognitiveServicesManager client, String resourceId) {
    System.out.println ("Deleting resource: " + resourceId + "...");
    client.accounts().deleteByIds (resourceId);
    System.out.println ("Resource deleted.");
    System.out.println ();
}

Silinen bir kaynağı kurtarmanız gerekirse bkz. Silinen Bilişsel Hizmetler kaynaklarını kurtarma.

Ayrıca bkz.

Başvuru belgeleri | Kitaplık kaynak kodu | Paket (NPM) | Örnekler

JavaScript önkoşulları

  • Geçerli bir Azure aboneliği- ücretsiz olarak bir tane oluşturun.
  • Node.js geçerli sürümü
  • Hüküm ve koşulları gözden geçirmek ve onaylamak için Azure portal ilk yüzünüzü, Metin Analizi veya Görüntü İşleme kaynaklarınızı oluşturmanız gerekir. Bunu şu şekilde yapabilirsiniz: yüz, metin analizi, görüntü işleme. Bundan sonra, aynı Azure aboneliği altında herhangi bir dağıtım aracını (SDK, CLı veya ARM şablonu vb.) kullanarak sonraki kaynakları oluşturabilirsiniz.

Azure hizmet sorumlusu oluşturma

Uygulamanızın Azure hesabınızla etkileşime geçmesini sağlamak için izinleri yönetmek üzere bir Azure hizmet sorumlusu gerekir. Azure hizmet sorumlusu oluşturmabölümündeki yönergeleri izleyin.

Bir hizmet sorumlusu oluşturduğunuzda gizli bir değer, bir KIMLIK ve bir uygulama KIMLIĞI olduğunu görürsünüz. Sonraki adımlar için uygulama KIMLIĞI ve gizli anahtarı geçici bir konuma kaydedin.

Kaynak grubu oluşturma

Bilişsel hizmetler kaynağı oluşturmadan önce, hesabınızın kaynağı içermesi için bir Azure Kaynak grubu olması gerekir. Henüz bir kaynak grubunuz yoksa devam etmeden önce Azure Portal bir tane oluşturun.

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 uygulamaya gidin.

mkdir myapp && cd myapp

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

npm init

Devam etmeden önce index.js adlı bir dosya oluşturun.

İstemci kitaplığını yükler

Aşağıdaki NPM paketlerini yükler:

npm install @azure/arm-cognitiveservices
npm install @azure/ms-rest-js
npm install @azure/ms-rest-nodeauth

Uygulamanızın package.json dosyası bağımlılıklarla güncelleştirilir.

Kitaplıkları içeri aktarma

index.js betiğinizi açın ve aşağıdaki kitaplıkları içeri aktarın.

"use strict";

/* To run this sample, install the following modules.
 * npm install @azure/arm-cognitiveservices
 * npm install @azure/ms-rest-js
 * npm install @azure/ms-rest-nodeauth
 */
var Arm = require("@azure/arm-cognitiveservices");
var msRestNodeAuth = require("@azure/ms-rest-nodeauth");

İstemcinin kimliğini doğrulama

Aşağıdaki alanları, betiğinizin köküne ekleyin ve oluşturduğunuz hizmet sorumlusunu ve Azure hesap bilgilerinizi kullanarak değerlerini girin.

const service_principal_application_id = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
const service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
const subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
const tenant_id = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
const resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names.
*/
const subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Sonra, quickstart programınızın ana işini işlemek için aşağıdaki işlevi ekleyin. İlk kod bloğu, yukarıda girdiğiniz kimlik bilgisi değişkenlerini kullanarak bir Biliveservicesmanagementclient nesnesi oluşturur. Bu nesne, tüm Azure yönetim işlemleri için gereklidir.

async function quickstart() {
    const credentials = await msRestNodeAuth.loginWithServicePrincipalSecret (service_principal_application_id, service_principal_secret, tenant_id);
    const client = new Arm.CognitiveServicesManagementClient (credentials, subscription_id);
    // Note Azure resources are also sometimes referred to as accounts.
    const accounts_client = new Arm.Accounts (client);
    const resource_skus_client = new Arm.ResourceSkus (client);

Arama yönetimi işlevleri

quickstartKullanılabilir kaynakları listelemek için işlevinizin sonuna aşağıdaki kodu ekleyin, örnek bir kaynak oluşturun, sahip olduğunuz kaynakları listeleyin ve ardından örnek kaynağı silin. Sonraki adımlarda bu işlevleri tanımlayacaksınız.

Bilişsel hizmetler kaynağı oluşturma (Node.js)

Yeni bir bilişsel hizmetler kaynağı oluşturup abone olmak için Create işlevini kullanın. Bu işlev, geçirdiğiniz kaynak grubuna yeni bir faturalanabilir kaynak ekler. Yeni kaynağınızı oluşturduğunuzda, kullanmak istediğiniz hizmetin "tür" değerini, fiyatlandırma katmanını (veya SKU 'SU) ve bir Azure konumunu bilmeniz gerekir. Aşağıdaki işlev bu bağımsız değişkenlerin tümünü alır ve bir kaynak oluşturur.

async function create_resource (client, resource_name, kind, sku_name, location) {
    console.log ("Creating resource: " + resource_name + "...");
/* NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
property from the properties object. */
    var parameters = { sku : { name: sku_name }, kind : kind, location : location, properties : { customSubDomainName : subdomain_name } };
    return client.create(resource_group_name, resource_name, parameters)
        .then((result) => {
            console.log("Resource created.");
            console.log();
            console.log("ID: " + result.id);
            console.log("Kind: " + result.kind);
            console.log();
        })
        .catch((err) =>{ 
                console.log(err)
        })
}

Hizmet ve fiyatlandırma katmanı seçin

Yeni bir kaynak oluşturduğunuzda, kullanmak istediğiniz hizmet için "tür" i ve istediğiniz fiyatlandırma katmanını (veya SKU) birlikte bilmeniz gerekir. Kaynağı oluştururken bu ve diğer bilgileri parametre olarak kullanacaksınız. Aşağıdaki işlev, kullanılabilir bilişsel hizmeti "türlerini" listeler.

async function list_available_kinds_skus_locations (client) {
    console.log ("Available SKUs:");
    var result = await client.list ();
    console.log("Kind\tSKU Name\tSKU Tier\tLocations");
    result.forEach (function (x) {
        var locations = x.locations.join(",");
        console.log(x.kind + "\t" + x.name + "\t" + x.tier + "\t" + locations);
    });
}

Azure bilişsel hizmetler 'e iki farklı kaynak aracılığıyla erişebilirsiniz: çok sunuculu bir kaynak veya tek hizmet bir.

  • Çoklu hizmet kaynağı:
    • Birden çok Azure bilişsel hizmete tek bir anahtar ve uç nokta ile erişin.
    • Kullandığınız hizmetlerden faturalandırmayı birleştirir.
  • Tek hizmet kaynağı:
    • Oluşturulan her hizmet için benzersiz bir anahtar ve uç nokta ile tek bir Azure bilişsel hizmete erişin.
    • Hizmeti denemek için ücretsiz katmanı kullanın.

Aşağıdaki SKU 'ların ve fiyatlandırma bilgilerinin listesine bakın.

Çoklu hizmet

Hizmet Tip
Birden çok hizmet. Daha fazla bilgi için fiyatlandırma sayfasına bakın. CognitiveServices

Görsel

Hizmet Tip
Görüntü İşleme ComputerVision
Özel Görüntü İşleme tahmin CustomVision.Prediction
Özel Görüntü İşleme-eğitim CustomVision.Training
Yüz Face
Form Tanıma FormRecognizer

Konuşma

Hizmet Tip
Konuşma Hizmetleri SpeechServices
Konuşma Tanıma SpeakerRecognition

Dil

Hizmet Tip
LUIS LUIS
Soru-Cevap Oluşturucu QnAMaker
Metin Analizi TextAnalytics
Metin Çevirisi TextTranslation

Karar

Hizmet Tip
Anomali Algılayıcısı AnomalyDetector
Content Moderator ContentModerator
Kişiselleştirme Personalizer

Fiyatlandırma katmanları ve faturalandırma

Fiyatlandırma katmanları (ve faturalandırılan miktar), kimlik doğrulama bilgilerinizi kullanarak göndereceğiniz işlem sayısına bağlıdır. Her fiyatlandırma katmanı şunları belirtir:

  • saniye başına izin verilen en fazla işlem sayısı (TPS).
  • fiyatlandırma katmanında etkinleştirilen hizmet özellikleri.
  • önceden tanımlı işlem sayısı için maliyet. Bu sayının üzerine gitmek, hizmetinize ilişkin fiyatlandırma ayrıntılarında belirtilen ek ücret oluşmasına neden olur.

Not

Bilişsel hizmetlerin birçoğu hizmeti denemek için kullanabileceğiniz ücretsiz bir katmana sahiptir. Ücretsiz katmanı kullanmak için, F0 kaynağınız IÇIN SKU olarak kullanın.

Kaynaklarınızı görüntüleyin

Azure hesabınızın altındaki tüm kaynakları (tüm kaynak grupları arasında) görüntülemek için aşağıdaki işlevi kullanın:

async function list_resources (client) {
    console.log ("Resources in resource group: " + resource_group_name);
    var result = await client.listByResourceGroup (resource_group_name);
    result.forEach (function (x) {
        console.log(x);
        console.log();
    });
}

Kaynak silme

Aşağıdaki işlev belirtilen kaynağı verilen kaynak grubundan siler.

async function delete_resource (client, resource_name) {
    console.log ("Deleting resource: " + resource_name + "...");
    await client.deleteMethod (resource_group_name, resource_name)
    console.log ("Resource deleted.");
    console.log ();
}

Silinen bir kaynağı kurtarmanız gerekiyorsa bkz. silinmiş bilişsel Hizmetler kaynaklarını kurtarma.

Uygulamayı çalıştırma

Ana işlevinizi hata işleme ile çağırmak için betiğinizin altına aşağıdaki kodu ekleyin quickstart .

try {
    quickstart();
}
catch (error) {
    console.log(error);
}

Ardından, konsol pencerenize komutuyla uygulamayı çalıştırın node .

node index.js

Ayrıca bkz.

Başvuru belgeleri | Kitaplık kaynak kodu | Paket (Pypı) | Örnekler

Python önkoşulları

  • Geçerli bir Azure aboneliği- ücretsiz olarak bir tane oluşturun.
  • Python 3.x
  • Hüküm ve koşulları gözden geçirmek ve onaylamak için Azure portal ilk yüzünüzü, Metin Analizi veya Görüntü İşleme kaynaklarınızı oluşturmanız gerekir. Bunu şu şekilde yapabilirsiniz: yüz, metin analizi, görüntü işleme. Bundan sonra, aynı Azure aboneliği altında herhangi bir dağıtım aracını (SDK, CLı veya ARM şablonu vb.) kullanarak sonraki kaynakları oluşturabilirsiniz.

Azure hizmet sorumlusu oluşturma

Uygulamanızın Azure hesabınızla etkileşime geçmesini sağlamak için izinleri yönetmek üzere bir Azure hizmet sorumlusu gerekir. Azure hizmet sorumlusu oluşturmabölümündeki yönergeleri izleyin.

Bir hizmet sorumlusu oluşturduğunuzda gizli bir değer, bir KIMLIK ve bir uygulama KIMLIĞI olduğunu görürsünüz. Sonraki adımlar için uygulama KIMLIĞI ve gizli anahtarı geçici bir konuma kaydedin.

Kaynak grubu oluşturma

Bilişsel hizmetler kaynağı oluşturmadan önce, hesabınızın kaynağı içermesi için bir Azure Kaynak grubu olması gerekir. Henüz bir kaynak grubunuz yoksa devam etmeden önce Azure Portal bir tane oluşturun.

Yeni Python uygulaması oluşturma

Tercih ettiğiniz düzenleyicide veya IDE 'de yeni bir Python uygulaması oluşturun ve bir konsol penceresinde projenize gidin.

İstemci kitaplığını yükler

İstemci kitaplığını ile yükleyebilirsiniz:

pip install azure-mgmt-cognitiveservices

Visual Studio IDE kullanıyorsanız, istemci kitaplığı indirilebilir bir NuGet paketi olarak kullanılabilir.

Kitaplıkları içeri aktarma

Python betiğinizi açın ve aşağıdaki kitaplıkları içeri aktarın.

from azure.identity import ClientSecretCredential
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
from azure.mgmt.cognitiveservices.models import CognitiveServicesAccount, Sku

İstemcinin kimliğini doğrulama

Aşağıdaki alanları, betiğinizin köküne ekleyin ve oluşturduğunuz hizmet sorumlusunu ve Azure hesap bilgilerinizi kullanarak değerlerini girin.

# Be sure to use the service pricipal application ID, not simply the ID. 
service_principal_application_id = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE"
service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE"

# The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions.
subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE"

# The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory.
tenant_id = "PASTE_YOUR_TENANT_ID_HERE"

# The name of the Azure resource group in which you want to create the resource.
# You can find resource groups in the Azure Dashboard under Home > Resource groups.
resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE"

# The name of the custom subdomain to use when you create the resource. This is optional.
# For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
# your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
# Note not all Cognitive Services allow custom subdomain names.
subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE"

Daha sonra bir Biliveservicesmanagementclient nesnesi oluşturmak için aşağıdaki kodu ekleyin. Bu nesne, tüm Azure yönetim işlemleri için gereklidir.

credential = ClientSecretCredential(tenant_id, service_principal_application_id, service_principal_secret)
client = CognitiveServicesManagementClient(credential, subscription_id)

Bilişsel hizmetler kaynağı oluşturma (Python)

Yeni bir bilişsel hizmetler kaynağı oluşturup abone olmak için Create işlevini kullanın. Bu işlev, geçirdiğiniz kaynak grubuna yeni bir faturalanabilir kaynak ekler. Yeni kaynağınızı oluşturduğunuzda, kullanmak istediğiniz hizmetin "tür" değerini, fiyatlandırma katmanını (veya SKU 'SU) ve bir Azure konumunu bilmeniz gerekir. Aşağıdaki işlev bu bağımsız değişkenlerin tümünü alır ve bir kaynak oluşturur.

def create_resource (resource_name, kind, sku_name, location) :
    print("Creating resource: " + resource_name + "...")
# NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
# property from the properties object.
    parameters = CognitiveServicesAccount(sku=Sku(name=sku_name), kind=kind, location=location, properties={ 'custom_sub_domain_name' : subdomain_name })
    result = client.accounts.create(resource_group_name, resource_name, parameters)
    print("Resource created.")
    print()
    print("ID: " + result.id)
    print("Name: " + result.name)
    print("Type: " + result.type)
    print()

Hizmet ve fiyatlandırma katmanı seçin

Yeni bir kaynak oluşturduğunuzda, kullanmak istediğiniz hizmet için "tür" i ve istediğiniz fiyatlandırma katmanını (veya SKU) birlikte bilmeniz gerekir. Kaynağı oluştururken bu ve diğer bilgileri parametre olarak kullanacaksınız. Aşağıdaki işlev, kullanılabilir bilişsel hizmeti "türlerini" listeler.

def list_available_kinds_skus_locations():
    print("Available SKUs:")
    result = client.resource_skus.list()
    print("Kind\tSKU Name\tSKU Tier\tLocations")
    for x in result:
        locations = ",".join(x.locations)
        print(x.kind + "\t" + x.name + "\t" + x.tier + "\t" + locations)

Azure bilişsel hizmetler 'e iki farklı kaynak aracılığıyla erişebilirsiniz: çok sunuculu bir kaynak veya tek hizmet bir.

  • Çoklu hizmet kaynağı:
    • Birden çok Azure bilişsel hizmete tek bir anahtar ve uç nokta ile erişin.
    • Kullandığınız hizmetlerden faturalandırmayı birleştirir.
  • Tek hizmet kaynağı:
    • Oluşturulan her hizmet için benzersiz bir anahtar ve uç nokta ile tek bir Azure bilişsel hizmete erişin.
    • Hizmeti denemek için ücretsiz katmanı kullanın.

Aşağıdaki SKU 'ların ve fiyatlandırma bilgilerinin listesine bakın.

Çoklu hizmet

Hizmet Tip
Birden çok hizmet. Daha fazla bilgi için fiyatlandırma sayfasına bakın. CognitiveServices

Görsel

Hizmet Tip
Görüntü İşleme ComputerVision
Özel Görüntü İşleme tahmin CustomVision.Prediction
Özel Görüntü İşleme-eğitim CustomVision.Training
Yüz Face
Form Tanıma FormRecognizer

Konuşma

Hizmet Tip
Konuşma Hizmetleri SpeechServices
Konuşma Tanıma SpeakerRecognition

Dil

Hizmet Tip
LUIS LUIS
Soru-Cevap Oluşturucu QnAMaker
Metin Analizi TextAnalytics
Metin Çevirisi TextTranslation

Karar

Hizmet Tip
Anomali Algılayıcısı AnomalyDetector
Content Moderator ContentModerator
Kişiselleştirme Personalizer

Fiyatlandırma katmanları ve faturalandırma

Fiyatlandırma katmanları (ve faturalandırılan miktar), kimlik doğrulama bilgilerinizi kullanarak göndereceğiniz işlem sayısına bağlıdır. Her fiyatlandırma katmanı şunları belirtir:

  • saniye başına izin verilen en fazla işlem sayısı (TPS).
  • fiyatlandırma katmanında etkinleştirilen hizmet özellikleri.
  • önceden tanımlı işlem sayısı için maliyet. Bu sayının üzerine gitmek, hizmetinize ilişkin fiyatlandırma ayrıntılarında belirtilen ek ücret oluşmasına neden olur.

Not

Bilişsel hizmetlerin birçoğu hizmeti denemek için kullanabileceğiniz ücretsiz bir katmana sahiptir. Ücretsiz katmanı kullanmak için, F0 kaynağınız IÇIN SKU olarak kullanın.

Kaynaklarınızı görüntüleyin

Azure hesabınızın altındaki tüm kaynakları (tüm kaynak grupları arasında) görüntülemek için aşağıdaki işlevi kullanın:

def list_resources():
    print("Resources in resource group: " + resource_group_name)
    result = client.accounts.list_by_resource_group(resource_group_name)
    for x in result:
        print(x.name)
        print(x)
        print()

Kaynak silme

Aşağıdaki işlev belirtilen kaynağı verilen kaynak grubundan siler.

def delete_resource(resource_name) :
    print("Deleting resource: " + resource_name + "...")
    client.accounts.delete(resource_group_name, resource_name)
    print("Resource deleted.")

Silinen bir kaynağı kurtarmanız gerekiyorsa bkz. silinmiş bilişsel Hizmetler kaynaklarını kurtarma.

Arama yönetimi işlevleri

Yukarıdaki işlevleri çağırmak için betiğinizin en altına aşağıdaki kodu ekleyin. Bu kod kullanılabilir kaynakları listeler, örnek bir kaynak oluşturur, sahip olduğunuz kaynakları listeler ve ardından örnek kaynağı siler.

# Uncomment this to list all available resource kinds, SKUs, and locations for your Azure account.
#list_available_kinds_skus_locations ()

# Create a resource with kind Text Translation, SKU F0 (free tier), location global.
create_resource("test_resource", "TextTranslation", "F0", "Global")

# List all resources for your Azure account.
list_resources()

# Delete the resource.
delete_resource("test_resource")

Uygulamayı çalıştırma

Komutu ile komut satırından uygulamanızı çalıştırın python .

python <your-script-name>.py

Ayrıca bkz.