Udostępnij za pośrednictwem

Biblioteka klienta usługi Azure ConversationAnalysis dla języka JavaScript — wersja 1.0.0-beta.1

  • Artykuł

Ten pakiet zawiera zestaw SDK izomorficzny (uruchamiany zarówno w Node.js, jak i w przeglądarkach) dla klienta usługi Azure ConversationAnalysis.

Interfejs API konwersacji usługi językowej to zestaw umiejętności przetwarzania języka naturalnego (NLP), których można użyć do analizowania konwersacji ustrukturyzowanych (tekstowych lub mówionych). Synchroniczny interfejs API w tym pakiecie akceptuje żądanie i pośredniczy w wielu projektach językowych, takich jak USŁUGA LUIS ogólnie dostępna, odpowiadanie na pytania, Language Understanding konwersacji, a następnie wywołuje najlepszą usługę kandydata do obsługi żądania. Na koniec zwraca odpowiedź z odpowiedzią usługi kandydata jako ładunek.

W niektórych przypadkach ten interfejs API musi przekazywać żądania i odpowiedzi między obiektem wywołującym a usługą nadrzędną. Asynchroniczne interfejsy API w tym pakiecie umożliwiają wykonywanie zadań, takich jak podsumowanie konwersacji i wykrywanie konwersacyjnych danych pii.

Linki kluczowe:

Wprowadzenie

Obecnie obsługiwane środowiska

Aby uzyskać więcej informacji, zobacz nasze zasady pomocy technicznej .

Wymagania wstępne

Jeśli używasz interfejsu wiersza polecenia platformy Azure, zastąp <your-resource-group-name> wartości i <your-resource-name> własnymi unikatowymi nazwami:

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

Instalowanie pakietu @azure/ai-language-conversations

Zainstaluj bibliotekę klienta Azure ConversationAnalysis dla języka JavaScript za pomocą polecenia npm:

npm install @azure/ai-language-conversations

Tworzenie i uwierzytelnianie ConversationAnalysisClient

Aby utworzyć obiekt klienta w celu uzyskania dostępu do interfejsu API języka, potrzebny endpoint będzie zasób Language i .credential Klient analizy konwersacji może użyć poświadczeń klucza interfejsu API do uwierzytelniania.

Punkt końcowy zasobu language można znaleźć w witrynie Azure Portal lub przy użyciu poniższego fragmentu wiersza polecenia platformy Azure :

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

Używanie klucza interfejsu API

Użyj witryny Azure Portal , aby przejść do zasobu języka i pobrać klucz interfejsu API lub użyć poniższego fragmentu kodu interfejsu wiersza polecenia platformy Azure :

Uwaga: Czasami klucz interfejsu API jest określany jako "klucz subskrypcji" lub "klucz interfejsu API subskrypcji".

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

Po utworzeniu klucza interfejsu API i punktu końcowego możesz użyć AzureKeyCredential klasy , aby uwierzytelnić klienta w następujący sposób:

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

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

Pakiet JavaScript

Aby użyć tej biblioteki klienta w przeglądarce, najpierw należy użyć narzędzia bundler. Aby uzyskać szczegółowe informacje o tym, jak to zrobić, zapoznaj się z naszą dokumentacją dotyczącą tworzenia pakietów.

Kluczowe pojęcia

ConversationAnalysisClient

ConversationAnalysisClient jest podstawowym interfejsem dla deweloperów korzystających z biblioteki klienta Azure ConversationAnalysis. Zapoznaj się z metodami w tym obiekcie klienta, aby zrozumieć różne funkcje usługi Azure ConversationAnalysis, do których można uzyskać dostęp.

Rozwiązywanie problemów

Rejestrowanie

Włączenie rejestrowania może pomóc odkryć przydatne informacje o błędach. Aby wyświetlić dziennik żądań i odpowiedzi HTTP, ustaw zmienną AZURE_LOG_LEVEL środowiskową na info. Alternatywnie rejestrowanie można włączyć w czasie wykonywania, wywołując setLogLevel polecenie w pliku @azure/logger:

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

Aby uzyskać bardziej szczegółowe instrukcje dotyczące włączania dzienników, zapoznaj się z dokumentami dotyczącymi pakietów @azure/rejestratora.

Następne kroki

Zapoznaj się z katalogiem samples , aby zapoznać się ze szczegółowymi przykładami dotyczącymi korzystania z tej biblioteki.

Współtworzenie

Jeśli chcesz współtworzyć tę bibliotekę, przeczytaj przewodnik współtworzenia , aby dowiedzieć się więcej na temat tworzenia i testowania kodu.

Wrażenia