JavaScript için Azure ConversationAnalysis istemci kitaplığı - sürüm 1.0.0-beta.1

Bu paket, Azure ConversationAnalysis istemcisi için bir izomorfik SDK (hem Node.js hem de tarayıcılarda çalışır) içerir.

Dil hizmeti konuşmaları API'si, yapılandırılmış konuşmaları (metinsel veya konuşulan) analiz etmek için kullanılabilecek bir doğal dil işleme (NLP) becerileri paketidir. Bu paketteki zaman uyumlu API bir isteği kabul eder ve LUIS Genel Kullanılabilir, Soru Yanıtlama, Konuşma Language Understanding gibi birden çok dil projesi arasında aracılık eder ve ardından isteği işlemek için en iyi aday hizmeti çağırır. Sonunda, aday hizmetin yanıtını yük olarak içeren bir yanıt döndürür.

Bazı durumlarda, bu API'nin çağıran ile yukarı akış hizmeti arasında istekleri ve yanıtları iletmesi gerekir. Bu paketteki zaman uyumsuz API'ler, Konuşma Özetlemesi ve Konuşma PII algılama gibi görevleri etkinleştirir.

Önemli bağlantılar:

• Kaynak kodu
• Paket (NPM)
• API başvuru belgeleri
• Ürün belgeleri
• Örnekler

Başlarken

Şu anda desteklenen ortamlar

• Node.jsLTS sürümleri
• Safari, Chrome, Edge ve Firefox'un en son sürümleri.

Daha fazla ayrıntı için destek ilkemize bakın.

Önkoşullar

• Bir Azure aboneliği.
• Mevcut [Bilişsel Hizmetler][cognitive_resource] veya Dil kaynağı. Kaynağı oluşturmanız gerekiyorsa Azure Portal'ı veya Azure CLI'yı kullanabilirsiniz.

Azure CLI kullanıyorsanız ve <your-resource-name> yerine kendi benzersiz adlarınızı yazın<your-resource-group-name>:

az cognitiveservices account create --kind ConversationalLanguageUnderstanding --resource-group <your-resource-group-name> --name <your-resource-name> --sku <your-sku-name> --location <your-location>

@azure/ai-language-conversations paketini yükleyin

ile npmJavaScript için Azure ConversationAnalysis istemci kitaplığını yükleyin:

npm install @azure/ai-language-conversations

Oluşturma ve kimlik doğrulaması ConversationAnalysisClient

Dil API'sine erişmek üzere bir istemci nesnesi oluşturmak için Dil kaynağınızın ve değerinin credentialolması gerekirendpoint. Konuşma Analizi istemcisi kimlik doğrulaması için api anahtarı kimlik bilgilerini kullanabilir.

Dil kaynağınızın uç noktasını Azure Portal'da veya aşağıdaki Azure CLI kod parçacığını kullanarak bulabilirsiniz:

az cognitiveservices account show --name <your-resource-name> --resource-group <your-resource-group-name> --query "properties.endpoint"

API Anahtarı Kullanma

Azure Portal'ı kullanarak Dil kaynağınıza göz atın ve bir API anahtarı alın veya aşağıdaki Azure CLI parçacığını kullanın:

Not: Bazen API anahtarına "abonelik anahtarı" veya "abonelik API anahtarı" denir.

az cognitiveservices account keys list --resource-group <your-resource-group-name> --name <your-resource-name>

API anahtarınız ve uç noktanız olduktan sonra, istemcinin kimliğini doğrulamak için sınıfını AzureKeyCredential aşağıdaki gibi kullanabilirsiniz:

const { AzureKeyCredential } = require("@azure/core-auth");
const { ConversationAnalysisClient } = require("@azure/ai-language-conversations");

const client = new ConversationAnalysisClient("<endpoint>", new AzureKeyCredential("<API key>"));

JavaScript Paketi

Bu istemci kitaplığını tarayıcıda kullanmak için önce bir paketleyici kullanmanız gerekir. Bunun nasıl yapılacağının ayrıntıları için lütfen paketleme belgelerimize bakın.

Önemli kavramlar

ConversationAnalysisClient

ConversationAnalysisClient , Azure ConversationAnalysis istemci kitaplığını kullanan geliştiriciler için birincil arabirimdir. Azure ConversationAnalysis hizmetinin erişebileceğiniz farklı özelliklerini anlamak için bu istemci nesnesinde yöntemleri keşfedin.

Sorun giderme

Günlüğe Kaydetme

Günlüğe kaydetmenin etkinleştirilmesi hatalarla ilgili yararlı bilgilerin ortaya çıkarılmasına yardımcı olabilir. HTTP isteklerinin ve yanıtlarının günlüğünü görmek için ortam değişkenini AZURE_LOG_LEVEL olarak infoayarlayın. Alternatif olarak, günlüğü çalışma zamanında içinde çağrılarak setLogLevel@azure/loggeretkinleştirilebilir:

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

Günlükleri etkinleştirme hakkında daha ayrıntılı yönergeler için @azure/günlükçü paketi belgelerine bakabilirsiniz.

Sonraki adımlar

Bu kitaplığın nasıl kullanılacağına ilişkin ayrıntılı örnekler için lütfen samples dizinine göz atın.

Katkıda bulunma

Bu kitaplığa katkıda bulunmak isterseniz, kodu derleme ve test etme hakkında daha fazla bilgi edinmek için lütfen katkıda bulunma kılavuzunu okuyun.

İlgili projeler

• JavaScript için Microsoft Azure SDK