Поделиться через

Клиентская библиотека Azure ConversationAnalysis для JavaScript версии 1.0.0-beta.1

  • Статья

Этот пакет содержит изоморфный пакет SDK (выполняется как в Node.js, так и в браузерах) для клиента Azure ConversationAnalysis.

API общения языковой службы — это набор навыков обработки естественного языка (NLP), который можно использовать для анализа структурированных бесед (текстовых или речевых). Синхронный API в этом наборе принимает запросы и выступает в качестве посредника между несколькими языковыми проектами, такими как общедоступная версия LUIS, ответы на вопросы, беседы Распознавание речи, а затем вызывает лучшую службу-кандидат для обработки запроса. Наконец, он возвращает ответ с ответом службы-кандидата в качестве полезных данных.

В некоторых случаях этот API должен пересылать запросы и ответы между вызывающим и вышестоящей службой. Асинхронные API в этом наборе позволяют выполнять такие задачи, как формирование сводных данных беседы и обнаружение личных сведений беседы.

Основные ссылки:

Начало работы

Поддерживаемые в настоящее время среды

Чтобы получить дополнительные сведения, ознакомьтесь с нашей политикой поддержки.

Предварительные требования

  • Подписка Azure.
  • Существующий ресурс [Cognitive Services][cognitive_resource] или языковой ресурс. Если вам нужно создать ресурс, можно использовать портал Azure или Azure CLI.

Если вы используете Azure CLI, замените <your-resource-group-name> и <your-resource-name> собственными уникальными именами:

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

Установите пакет @azure/ai-language-conversations.

Установите клиентскую библиотеку Azure ConversationAnalysis для JavaScript с помощью npm:

npm install @azure/ai-language-conversations

Создание и проверка подлинности ConversationAnalysisClient

Чтобы создать клиентский объект для доступа к API языка, вам потребуется endpoint ресурс language и credential. Клиент анализа бесед может использовать учетные данные ключа API для проверки подлинности.

Конечную точку для языкового ресурса можно найти на портале Azure или с помощью приведенного ниже фрагмента кода Azure CLI :

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

Использование ключа API

Используйте портал Azure , чтобы перейти к языковому ресурсу и получить ключ API, или используйте приведенный ниже фрагмент кода Azure CLI :

Примечание: Иногда ключ API называется ключом подписки или ключом API подписки.

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

Получив ключ API и конечную точку AzureKeyCredential , можно использовать класс для проверки подлинности клиента следующим образом:

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

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

Пакет JavaScript

Чтобы использовать эту клиентную библиотеку в браузере, сначала необходимо использовать средство пакетной установки. Дополнительные сведения о том, как это сделать, см. в нашей документации по объединениям.

Основные понятия

ConversationAnalysisClient

ConversationAnalysisClient — это основной интерфейс для разработчиков, использующих клиентскую библиотеку Azure ConversationAnalysis. Изучите методы в этом клиентском объекте, чтобы понять различные функции службы Azure ConversationAnalysis, к которым можно получить доступ.

Устранение неполадок

Ведение журнала

Включение ведения журнала может помочь выявить полезные сведения о сбоях. Чтобы просмотреть журнал HTTP-запросов и ответов, задайте для переменной среды AZURE_LOG_LEVEL значение info. Кроме того, ведение журнала можно включить во время выполнения, вызвав setLogLevel в @azure/logger:

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

Более подробные инструкции по включению журналов см. в документации по пакету @azure и средству ведения журнала.

Дальнейшие действия

Подробные примеры использования этой библиотеки см. в каталоге примеров .

Участие

Если вы хотите вносить изменения в эту библиотеку, ознакомьтесь с руководством по внесению изменений, в котором содержатся сведения о создании и тестировании кода.

Просмотры