Condividi tramite

Libreria client di Azure ConversationAnalysis per JavaScript - versione 1.0.0-beta.1

  • Articolo

Questo pacchetto contiene un SDK isomorfico (eseguito sia in Node.js che nei browser) per il client Azure ConversationAnalysis.

L'API conversazioni del servizio linguistico è una suite di competenze di elaborazione del linguaggio naturale (NLP) che possono essere usate per analizzare conversazioni strutturate (testuali o vocali). L'API sincrona in questa famiglia di prodotti accetta una richiesta e media tra più progetti linguistici, ad esempio LUIS disponibile a livello generale, risposta alle domande, Language Understanding conversazionale e quindi chiama il servizio candidato migliore per gestire la richiesta. Infine, restituisce una risposta con la risposta del servizio candidato come payload.

In alcuni casi, questa API deve inoltrare richieste e risposte tra il chiamante e un servizio upstream. Le API asincrone in questa suite abilitano attività come il riepilogo delle conversazioni e il rilevamento delle informazioni personali conversazionali.

Collegamenti principali:

Introduzione

Ambienti attualmente supportati

Per altre informazioni, vedere i criteri di supporto.

Prerequisiti

Se si usa l'interfaccia della riga di comando di Azure, sostituire <your-resource-group-name> e <your-resource-name> con i propri nomi univoci:

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

Installare il pacchetto @azure/ai-language-conversations

Installare la libreria client di Azure ConversationAnalysis per JavaScript con npm:

npm install @azure/ai-language-conversations

Creare e autenticare un oggetto ConversationAnalysisClient

Per creare un oggetto client per accedere all'API Language, è necessario disporre endpoint della risorsa Language e di un .credential Il client di analisi delle conversazioni può usare le credenziali della chiave API per l'autenticazione.

È possibile trovare l'endpoint per la risorsa language nel portale di Azure o usando il frammento di interfaccia della riga di comando di Azure seguente:

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

Uso di una chiave API

Usare il portale di Azure per passare alla risorsa lingua e recuperare una chiave API oppure usare il frammento di interfaccia della riga di comando di Azure seguente:

Nota: A volte la chiave API viene definita "chiave di sottoscrizione" o "chiave API di sottoscrizione".

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

Dopo aver ottenuto una chiave API e un endpoint, è possibile usare la AzureKeyCredential classe per autenticare il client come indicato di seguito:

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

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

JavaScript Bundle

Per usare questa libreria client nel browser, è prima necessario usare un bundler. Per informazioni dettagliate su come eseguire questa operazione, vedere la documentazione di creazione di bundle.

Concetti chiave

ConversationAnalysisClient

ConversationAnalysisClient è l'interfaccia principale per gli sviluppatori che usano la libreria client di Azure ConversationAnalysis. Esplorare i metodi in questo oggetto client per comprendere le diverse funzionalità del servizio Azure ConversationAnalysis a cui è possibile accedere.

Risoluzione dei problemi

Registrazione

L'abilitazione della registrazione consente di individuare informazioni utili sugli errori. Per visualizzare un log di richieste e risposte HTTP, impostare la variabile di ambiente AZURE_LOG_LEVEL su info. In alternativa, la registrazione può essere abilitata in fase di esecuzione chiamando setLogLevel in @azure/logger:

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

Per istruzioni più dettagliate su come abilitare i log, è possibile esaminare la documentazione del pacchetto di @azure/logger.

Passaggi successivi

Per esempi dettagliati su come usare questa libreria, vedere la directory degli esempi .

Contributo

Per contribuire a questa libreria, leggere la guida ai contributi per altre informazioni su come compilare e testare il codice.

Impression