通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

适用于 JavaScript 的 Azure ConversationAnalysis 客户端库 - 版本 1.0.0-beta.1

  • 项目

此包包含一个同构 SDK (在 azure ConversationAnalysis 客户端) Node.js和浏览器中运行。

语言服务对话 API 是一套自然语言处理 (NLP) 技能，可用于分析结构化对话 (文本或口语) 。 此套件中的同步 API 接受请求并在多个语言项目（如 LUIS 正式版、问答、对话语言理解）之间进行调解，然后调用最佳候选服务来处理请求。 最后，它将返回一个响应，其中候选服务的响应作为有效负载。

在某些情况下，此 API 需要在调用方和上游服务之间转发请求和响应。 此套件中的异步 API 支持对话摘要和对话 PII 检测等任务。

关键链接：

入门

目前支持的环境

有关更多详细信息，请参阅我们的支持政策。

先决条件

如果使用 Azure CLI，请将 和 <your-resource-name> 替换为<your-resource-group-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 包

使用 安装适用于 JavaScript 的 npmAzure ConversationAnalysis 客户端库：

npm install @azure/ai-language-conversations

创建 ConversationAnalysisClient 并对其进行身份验证

若要创建客户端对象以访问语言 API，需要 endpoint 语言资源的 和 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。 或者，可以在运行时通过调用 @azure/logger 中的 setLogLevel 来启用日志记录：

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

有关如何启用日志的更详细说明，请查看 @azure/logger 包文档。

后续步骤

有关如何使用此库的详细示例，请查看 示例 目录。

贡献

若要为此库做出贡献，请阅读贡献指南，详细了解如何生成和测试代码。

曝光数