Compartir a través de

Biblioteca cliente de Azure ConversationAnalysis para JavaScript: versión 1.0.0-beta.1

  • Artículo

Este paquete contiene un SDK isomórfico (se ejecuta tanto en Node.js como en exploradores) para el cliente de Azure ConversationAnalysis.

La API de conversaciones del servicio de lenguaje es un conjunto de aptitudes de procesamiento de lenguaje natural (NLP) que se pueden usar para analizar conversaciones estructuradas (textuales o habladas). La API sincrónica de este conjunto acepta una solicitud y media entre varios proyectos de lenguaje, como LUIS disponible con carácter general, respuesta a preguntas, Language Understanding de conversación y, a continuación, llama al mejor servicio candidato para controlar la solicitud. Por último, devuelve una respuesta con la respuesta del servicio candidato como una carga útil.

En algunos casos, esta API debe reenviar solicitudes y respuestas entre el autor de la llamada y un servicio ascendente. Las API asincrónicas de este conjunto habilitan tareas como resumen de conversación y detección de PII de conversación.

Vínculos principales:

Introducción

Entornos admitidos actualmente

Para más información, consulte la directiva de compatibilidad.

Requisitos previos

Si usa la CLI de Azure, reemplace <your-resource-group-name> y <your-resource-name> por sus propios nombres únicos:

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

Instalar el paquete @azure/ai-language-conversations

Instale la biblioteca cliente de Azure ConversationAnalysis para JavaScript con npm:

npm install @azure/ai-language-conversations

Crear y autenticar una ConversationAnalysisClient

Para crear un objeto de cliente para acceder a Language API, necesitará el endpoint de su recurso language y un credential. El cliente de Conversation Analysis puede usar una credencial de clave de API para autenticarse.

Puede encontrar el punto de conexión del recurso language en Azure Portal o mediante el fragmento de código de la CLI de Azure siguiente:

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

Uso de una clave de API

Use Azure Portal para ir al recurso de lenguaje y recuperar una clave de API, o bien use el fragmento de código de la CLI de Azure siguiente:

Nota: A veces, la clave de API se conoce como "clave de suscripción" o "clave de API de suscripción".

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

Una vez que tenga una clave de API y un punto de conexión, puede usar la AzureKeyCredential clase para autenticar el cliente de la siguiente manera:

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

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

Paquete de JavaScript

Para usar esta biblioteca cliente en el explorador, primero debe usar un agrupador. Para más información sobre cómo hacerlo, consulte nuestra documentación de agrupación.

Conceptos clave

ConversationAnalysisClient

ConversationAnalysisClient es la interfaz principal para los desarrolladores que usan la biblioteca cliente de Azure ConversationAnalysis. Explore los métodos de este objeto de cliente para comprender las distintas características del servicio Azure ConversationAnalysis al que puede acceder.

Solución de problemas

Registro

La habilitación del registro puede ayudar a descubrir información útil sobre los errores. Para ver un registro de solicitudes y respuestas HTTP, establezca la variable de entorno AZURE_LOG_LEVEL en info. Como alternativa, el registro se puede habilitar en tiempo de ejecución llamando a setLogLevel en @azure/logger:

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

Para obtener instrucciones más detalladas sobre cómo habilitar los registros, consulte los documentos del paquete @azure/logger.

Pasos siguientes

Eche un vistazo al directorio de ejemplos para obtener ejemplos detallados sobre cómo usar esta biblioteca.

Contribuciones

Si desea contribuir a esta biblioteca, lea la guía de contribución para obtener más información sobre cómo compilar y probar el código.

Impresiones