適用于 JavaScript 的 Azure ConversationAnalysis 用戶端程式庫 - 1.0.0-Beta.1 版
此套件包含同型 SDK， (會在 azure ConversationAnalysis 用戶端的 Node.js 和瀏覽器) 中執行。
語言服務交談 API 是一套自然語言處理 (NLP) 技能，可用來分析結構化交談 (文字或口語) 。 此套件中的同步 API 會接受多個語言專案之間的要求，例如 LUIS 正式推出、問題解答、交談式Language Understanding，然後呼叫最佳候選服務來處理要求。 最後，它會以候選服務的回應作為承載傳迴響應。
在某些情況下，此 API 必須轉送呼叫端與上游服務之間的要求和回應。 此套件中的非同步 API 可啟用交談摘要和交談 PII 偵測等工作。
重要連結：
開始使用
目前支援的環境
- Node.js 的 LTS 版本
- 最新版的 Safari、Chrome、Edge 和 Firefox。
如需詳細資訊，請參閱我們的支援原則。
必要條件
- Azure 訂用帳戶。
- 現有的 [認知服務][cognitive_resource] 或語言資源。 如果您需要建立資源，您可以使用 Azure 入口網站或Azure CLI。
如果您使用 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 npm 的 Azure ConversationAnalysis 用戶端程式庫：
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。 或者，您可以在 @azure/logger 中呼叫 setLogLevel，以在執行階段啟用記錄：
const { setLogLevel } = require("@azure/logger");
setLogLevel("info");
如需如何啟用記錄的詳細指示，可參閱 @azure/logger 套件文件。
下一步
如需如何使用此程式庫的詳細範例，請參閱 範例 目錄。
參與
如果您希望向此程式庫投稿，請參閱投稿指南，深入瞭解如何組建與測試程式碼。
相關專案
