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

  • Artigo

Esse pacote contém um SDK isomórfico (executado em Node.js e em navegadores) para o cliente ConversationAnalysis do Azure.

A API de conversas do serviço de linguagem é um conjunto de habilidades de NLP (processamento de linguagem natural) que podem ser usadas para analisar conversas estruturadas (textuais ou faladas). A API síncrona neste pacote aceita uma solicitação e é mediada entre vários projetos de linguagem, como LUIS Geralmente Disponível, Respostas a Perguntas, Reconhecimento vocal de Conversação e, em seguida, chama o melhor serviço candidato para lidar com a solicitação. Por fim, ele retorna uma resposta com a resposta do serviço candidato como uma carga.

Em alguns casos, essa API precisa encaminhar solicitações e respostas entre o chamador e um serviço upstream. As APIs assíncronas neste pacote habilitam tarefas como Resumo de Conversa e detecção de PII de Conversa.

Links principais:

Introdução

Ambientes com suporte no momento

Confira nossa política de suporte para mais detalhes.

Pré-requisitos

  • Uma assinatura do Azure.
  • Um recurso existente [Serviços Cognitivos][cognitive_resource] ou Idioma. Se você precisar criar o recurso, poderá usar o Portal do Azure ou a CLI do Azure.

Se você usar a CLI do Azure, substitua <your-resource-group-name> e <your-resource-name> por 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 clientes do Azure ConversationAnalysis para JavaScript com npm:

npm install @azure/ai-language-conversations

Criar e autenticar um ConversationAnalysisClient

Para criar um objeto cliente para acessar a API de Linguagem, você precisará do endpoint recurso de Linguagem e de um credential. O cliente de Análise de Conversa pode usar uma credencial de chave de API para autenticar.

Você pode encontrar o ponto de extremidade para o recurso idioma no Portal do Azure ou usando o snippet da CLI do Azure abaixo:

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

Usando uma chave de API

Use o Portal do Azure para navegar até o recurso Idioma e recuperar uma chave de API ou usar o snippet da CLI do Azure abaixo:

Nota: Às vezes, a chave de API é chamada de "chave de assinatura" ou "chave de API de assinatura".

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

Depois de ter uma chave de API e um ponto de extremidade, você poderá usar a AzureKeyCredential classe para autenticar o cliente da seguinte maneira:

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 usar essa biblioteca de clientes no navegador, primeiro você precisa usar um empacotador. Para obter detalhes sobre como fazer isso, consulte nossa documentação de agrupamento.

Principais conceitos

ConversationAnalysisClient

ConversationAnalysisClient é a interface primária para desenvolvedores que usam a biblioteca de clientes do Azure ConversationAnalysis. Explore os métodos neste objeto cliente para entender os diferentes recursos do serviço ConversationAnalysis do Azure que você pode acessar.

Solução de problemas

Log

A habilitação do log pode ajudar a descobrir informações úteis sobre falhas. Para ver um log de solicitações e respostas HTTP, defina a variável de ambiente AZURE_LOG_LEVEL como info. Como alternativa, o log pode ser habilitado no runtime chamando setLogLevel em @azure/logger:

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

Para obter instruções mais detalhadas sobre como habilitar logs, veja os documentos do pacote @azure/logger.

Próximas etapas

Examine o diretório de exemplos para obter exemplos detalhados sobre como usar essa biblioteca.

Contribuição

Se você quiser contribuir com essa biblioteca, leia o guia de contribuição para saber como criar e testar o código.

Impressões