Dela via

Azure ConversationAnalysis-klientbibliotek för JavaScript – version 1.0.0-beta.1

  • Artikel

Det här paketet innehåller en isomorf SDK (körs både i Node.js och i webbläsare) för Azure ConversationAnalysis-klienten.

API:et för språktjänstkonversationer är en uppsättning kunskaper i bearbetning av naturligt språk (NLP) som kan användas för att analysera strukturerade konversationer (text eller talat). Det synkrona API:et i den här sviten accepterar en begäran och förmedlar mellan flera språkprojekt, till exempel LUIS Allmänt tillgänglig, Frågesvar, Konversations- Language Understanding och anropar sedan den bästa kandidattjänsten för att hantera begäran. Äntligen returneras ett svar med kandidattjänstens svar som en nyttolast.

I vissa fall måste det här API:et vidarebefordra begäranden och svar mellan anroparen och en överordnad tjänst. De asynkrona API:erna i den här sviten aktiverar uppgifter som konversationssammanfattning och identifiering av konversations-PII.

Nyckellänkar:

Komma igång

Miljöer som stöds för närvarande

Mer information finns i vår supportpolicy .

Förutsättningar

Om du använder Azure CLI ersätter <your-resource-group-name> du och <your-resource-name> med dina egna unika namn:

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

Installera @azure/ai-language-conversations-paketet

Installera Azure ConversationAnalysis-klientbiblioteket för JavaScript med npm:

npm install @azure/ai-language-conversations

Skapa och autentisera en ConversationAnalysisClient

Om du vill skapa ett klientobjekt för att få åtkomst till språk-API:et endpoint behöver du för din språkresurs och en credential. Klienten för konversationsanalys kan använda en API-nyckelautentiseringsuppgift för att autentisera.

Du hittar slutpunkten för språkresursen antingen i Azure-portalen eller med hjälp av Azure CLI-kodfragmentet nedan:

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

Använda en API-nyckel

Använd Azure-portalen för att bläddra till språkresursen och hämta en API-nyckel, eller använd Azure CLI-kodfragmentet nedan:

Observera: Ibland kallas API-nyckeln för en "prenumerationsnyckel" eller "prenumerations-API-nyckel".

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

När du har en API-nyckel och slutpunkt kan du använda klassen för att autentisera AzureKeyCredential klienten på följande sätt:

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

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

JavaScript-paket

Om du vill använda det här klientbiblioteket i webbläsaren måste du först använda en bundler. Mer information om hur du gör detta finns i vår paketeringsdokumentation.

Viktiga begrepp

ConversationAnalysisClient

ConversationAnalysisClient är det primära gränssnittet för utvecklare som använder Azure ConversationAnalysis-klientbiblioteket. Utforska metoderna i det här klientobjektet för att förstå de olika funktionerna i tjänsten Azure ConversationAnalysis som du kan komma åt.

Felsökning

Loggning

Aktivering av loggning kan hjälpa dig att hitta användbar information om fel. Om du vill se en logg över HTTP-begäranden och svar anger du AZURE_LOG_LEVEL miljövariabeln till info. Loggning kan också aktiveras vid körning genom att anropa setLogLevel i @azure/logger:

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

Mer detaljerade anvisningar om hur du aktiverar loggar finns i dokumentationen om @azure-/loggningspaket.

Nästa steg

Ta en titt på exempelkatalogen för detaljerade exempel på hur du använder det här biblioteket.

Bidra

Om du vill bidra till det här biblioteket kan du läsa bidragsguiden om du vill veta mer om hur du skapar och testar koden.

Visningar