Partilhar via

Biblioteca de cliente do Azure ConversationAnalysis para JavaScript – versão 1.0.0-beta.1

  • Artigo

Este pacote contém um SDK isomórfico (executado tanto em Node.js como em browsers) para o cliente Azure ConversationAnalysis.

A API de conversações do serviço de linguagem é um conjunto de competências de processamento de linguagem natural (NLP) que podem ser utilizadas para analisar conversações estruturadas (textuais ou faladas). A API síncrona neste conjunto de aplicações aceita um pedido e multimédia entre vários projetos de idioma, tais como LUIS Geralmente Disponível, Resposta a Perguntas, Conversação Language Understanding e, em seguida, chama o melhor serviço candidato para processar o pedido. Por fim, devolve uma resposta com a resposta do serviço candidato como um payload.

Em alguns casos, esta API tem de reencaminhar pedidos e respostas entre o autor da chamada e um serviço a montante. As APIs assíncronas neste conjunto permitem tarefas como Resumo de Conversação e Deteção de PII de Conversação.

Ligações principais:

Introdução

Ambientes atualmente suportados

Veja a nossa política de suporte para obter mais detalhes.

Pré-requisitos

Se utilizar a CLI do Azure, substitua <your-resource-group-name> e <your-resource-name> pelos seus próprios nomes exclusivos:

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

Instalar o pacote @azure/ai-language-conversations

Instale a biblioteca de cliente do Azure ConversationAnalysis para JavaScript com npm:

npm install @azure/ai-language-conversations

Criar e autenticar um ConversationAnalysisClient

Para criar um objeto de cliente para aceder à API de Idioma, precisará do endpoint recurso Idioma e de um credential. O cliente análise de conversação pode utilizar uma credencial de chave de API para autenticar.

Pode encontrar o ponto final do recurso Idioma no Portal do Azure ou através do fragmento da CLI do Azure abaixo:

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

Utilizar uma Chave de API

Utilize o Portal do Azure para navegar para o recurso Idioma e obter uma chave de API ou utilize o fragmento da CLI do Azure abaixo:

Nota: Por vezes, a chave de API é referida como uma "chave de subscrição" ou "chave de API de subscrição".

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

Assim que tiver uma chave de API e um ponto final, pode utilizar a AzureKeyCredential classe para autenticar o cliente da seguinte forma:

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

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

Pacote JavaScript

Para utilizar esta biblioteca de cliente no browser, primeiro tem de utilizar um bundler. Para obter detalhes sobre como fazê-lo, consulte a nossa documentação de agrupamento.

Conceitos-chave

ConversationAnalysisClient

ConversationAnalysisClient é a interface principal para programadores que utilizam a biblioteca de cliente Azure ConversationAnalysis. Explore os métodos neste objeto de cliente para compreender as diferentes funcionalidades do serviço Azure ConversationAnalysis a que pode aceder.

Resolução de problemas

Registo

Ativar o registo pode ajudar a descobrir informações úteis sobre falhas. Para ver um registo de pedidos HTTP e respostas, defina a variável de AZURE_LOG_LEVEL ambiente como info. Em alternativa, o registo pode ser ativado no runtime ao chamar setLogLevel no @azure/logger:

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

Para obter instruções mais detalhadas sobre como ativar registos, pode ver os documentos do pacote de @azure/logger.

Passos seguintes

Veja o diretório de exemplos para obter exemplos detalhados sobre como utilizar esta biblioteca.

Contribuir

Se quiser contribuir para esta biblioteca, leia o guia de contribuição para saber mais sobre como criar e testar o código.

Impressões