Sdílet prostřednictvím

Klientská knihovna Azure ConversationAnalysis pro JavaScript – verze 1.0.0-beta.1

  • Článek

Tento balíček obsahuje izomorfní sadu SDK (spouští se v Node.js i v prohlížečích) pro klienta Azure ConversationAnalysis.

Rozhraní API pro konverzace služby jazyka je sada dovedností pro zpracování přirozeného jazyka (NLP), které lze použít k analýze strukturovaných konverzací (textové nebo mluvené). Synchronní rozhraní API v této sadě přijímá požadavek a zprostředkovává ho mezi více jazykovými projekty, jako jsou například OBECNĚ dostupné služby LUIS, odpovědi na otázky, konverzační Language Understanding, a pak zavolá nejlepší kandidátské služby pro zpracování požadavku. Nakonec vrátí odpověď s odpovědí kandidátské služby jako datovou částí.

V některých případech toto rozhraní API potřebuje předávat požadavky a odpovědi mezi volajícím a nadřazenou službou. Asynchronní rozhraní API v této sadě umožňují úlohy, jako je souhrn konverzací a detekce konverzačních PII.

Klíčové odkazy:

Začínáme

Aktuálně podporovaná prostředí

  • LtS verze Node.js
  • Nejnovější verze prohlížečů Safari, Chrome, Edge a Firefox.

Další podrobnosti najdete v našich zásadách podpory .

Požadavky

Pokud používáte Azure CLI, nahraďte <your-resource-group-name> a <your-resource-name> vlastními jedinečnými názvy:

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

Nainstalujte balíček @azure/ai-language-conversations.

Nainstalujte klientskou knihovnu Azure ConversationAnalysis pro JavaScript pomocí npm:

npm install @azure/ai-language-conversations

Vytvoření a ověření ConversationAnalysisClient

Pokud chcete vytvořit objekt klienta pro přístup k rozhraní API pro jazyk, budete potřebovat endpoint prostředek Language a credential. Klient analýzy konverzací může k ověření použít přihlašovací údaje klíče rozhraní API.

Koncový bod pro prostředek jazyka najdete na webu Azure Portal nebo pomocí fragmentu kódu Azure CLI níže:

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

Použití klíče rozhraní API

Pomocí webu Azure Portal přejděte k prostředku jazyka a načtěte klíč rozhraní API nebo použijte následující fragment kódu Azure CLI :

Poznámka: Někdy se klíč rozhraní API označuje jako klíč předplatného nebo klíč rozhraní API předplatného.

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

Jakmile budete mít klíč rozhraní API a koncový bod, můžete pomocí AzureKeyCredential třídy ověřit klienta následujícím způsobem:

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

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

JavaScript Bundle

Pokud chcete tuto klientskou knihovnu používat v prohlížeči, musíte nejprve použít bundler. Podrobnosti o tom, jak to udělat, najdete v naší dokumentaci k sdružování.

Klíčové koncepty

ConversationAnalysisClient

ConversationAnalysisClient je primární rozhraní pro vývojáře, kteří používají klientskou knihovnu Azure ConversationAnalysis. Prozkoumejte metody tohoto objektu klienta a seznamte se s různými funkcemi služby Azure ConversationAnalysis, ke kterým máte přístup.

Řešení potíží

protokolování

Povolení protokolování může pomoct odhalit užitečné informace o selháních. Pokud chcete zobrazit protokol požadavků a odpovědí HTTP, nastavte proměnnou AZURE_LOG_LEVEL prostředí na info. Případně je možné protokolování povolit za běhu voláním setLogLevel v :@azure/logger

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

Podrobnější pokyny k povolení protokolů najdete v dokumentaci k balíčkům @azure/protokolovacího nástroje.

Další kroky

Podrobné příklady použití této knihovny najdete v adresáři samples .

Přispívání

Pokud chcete přispívat do této knihovny, přečtěte si prosím průvodce přispívání , kde se dozvíte více o tom, jak sestavit a otestovat kód.

Imprese